Merge pull request #107761 from ramthi/main

ShannonLeavitt · web-flow · commit 9c88e242bc2b · 2023-04-11T11:00:18.000-06:00
Add Snippet injection reference to JavaScript
diff --git a/articles/azure-monitor/app/javascript-sdk.md b/articles/azure-monitor/app/javascript-sdk.md
@@ -21,8 +21,18 @@ ms.reviewer: mmcc
 ## Get started
 
 The Application Insights JavaScript SDK is implemented with a runtime snippet for out-of-the-box web analytics.
+The JavaScript snippet can be added to your webpages manually or via the automatic snippet injection.
 
-### Enable Application Insights SDK for JavaScript
+### Enable Application Insights SDK for JavaScript automatically
+
+The automatic Snippet injection feature available in the Application Insights .NET core SDK and the Application Insights Node.js SDK (preview)
+allows you to automatically inject the Application Insights JavaScript SDK into every webpage of your web application. 
+For more information, see [Application Insights .NET core SDK Snippet Injection](./asp-net-core.md?tabs=netcorenew%2Cnetcore6#enable-client-side-telemetry-for-web-applications)
+and [Application Insights Node.js SDK Snippet Injection (preview)](./nodejs.md#automatic-web-instrumentationpreview).
+However, if you want more control over which pages to add the Application Insights JavaScript SDK 
+or if you're using a programming language other than .NET and Node.js, please follow the manual configuration steps below.
+
+### Enable Application Insights SDK for JavaScript manually
 
 Only two steps are required to enable the Application Insights SDK for JavaScript.
 
diff --git a/articles/azure-monitor/app/nodejs.md b/articles/azure-monitor/app/nodejs.md
@@ -174,11 +174,33 @@ appInsights.defaultClient.context.tags[appInsights.defaultClient.context.keys.cl
 appInsights.start();
 ```
 
-### Automatic web snippet injection (preview)
+### Automatic web Instrumentation[Preview]
 
-You can use automatic web snippet injection to enable [Application Insights usage experiences](usage-overview.md) and browser diagnostic experiences with a simple configuration. It's an easier alternative to manually adding the JavaScript snippet or npm package to your JavaScript web code.
+ Automatic web Instrumentation can be enabled for node server via configuration 
 
-For node server with configuration, set `enableAutoWebSnippetInjection` to `true`. Alternatively, set the environment variable as `APPLICATIONINSIGHTS_WEB_SNIPPET_ENABLED = true`. Automatic web snippet injection is available in Application Insights Node.js SDK version 2.3.0 or greater. For more information, see [Application Insights Node.js GitHub Readme](https://github.com/microsoft/ApplicationInsights-node.js#automatic-web-snippet-injectionpreview).
+```javascript
+let appInsights = require("applicationinsights");
+appInsights.setup("<connection_string>")
+    .enableWebInstrumentation(true)
+    .start();
+```
+
+or by setting environment variable `APPLICATIONINSIGHTS_WEB_INSTRUMENTATION_ENABLED = true`.
+
+Web Instrumentation will be enabled on node server responses when all of the following requirements are met:
+
+- Response has status code `200`.
+- Response method is `GET`.
+- Sever response has `Content-Type` html.
+- Server response contains both `<head>` and `</head>` Tags.
+- If response is compressed, it must have only one `Content-Encoding` type, and encoding type must be one of `gzip`, `br` or `deflate`.
+- Response does not contain current /backup web Instrumentation CDN endpoints.  (current and backup Web Instrumentation CDN endpoints [here](https://github.com/microsoft/ApplicationInsights-JS#active-public-cdn-endpoints))
+
+web Instrumentation CDN endpoint can be changed by setting environment variable `APPLICATIONINSIGHTS_WEB_INSTRUMENTATION_SOURCE = "web Instrumentation CDN endpoints"`.
+web Instrumentation connection string can be changed by setting environment variable `APPLICATIONINSIGHTS_WEB_INSTRUMENTATION_CONNECTION_STRING = "web Instrumentation connection string"`
+
+> [!Note] 
+> Web Instrumentation may slow down server response time, especially when response size is large or response is compressed. For the case in which some middle layers are applied, it may result in web Instrumentation not working and original response will be returned.
 
 ### Automatic third-party instrumentation
 
