Merge pull request #219384 from v-jbasden/jbasden-merge-auto-collect-dependencies

Merging app/auto-collect-dependencies.md into app/asp-net-dependencies.md

Author: v-regandowner

.openpublishing.redirection.azure-monitor.json

@@ -5532,6 +5532,11 @@
             "redirect_url": "/azure/azure-monitor/app/export-telemetry",
             "redirect_document_id": false
         },
+        {
+            "source_path_from_root": "/articles/azure-monitor/app/auto-collect-dependencies.md",
+            "redirect_url": "/azure/azure-monitor/app/asp-net-dependencies",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/azure-monitor/app/custom-endpoints.md",
             "redirect_url": "/azure/azure-monitor/app/create-new-resource",

articles/azure-monitor/app/app-map.md

@@ -411,7 +411,7 @@ There are many filter combinations. Here are some suggestions that apply to most
     :::image type="content" source="media/app-map/image-12.png" alt-text="A screenshot displaying the Intelligent Overview toggle.":::
 
 -   Hide low-traffic connectors with no errors to quickly focus on issues that have higher impact:
-     :::image type="content" source="media/app-map/image-13.png" alt-text="A screenshot displaying the Last 24 hours, calls greater than 876, and highlihgted errors filters.":::
+     :::image type="content" source="media/app-map/image-13.png" alt-text="A screenshot displaying the Last 24 hours, calls greater than 876, and highlighted errors filters.":::
 
 -   Show high-traffic connectors with high average duration to focus on potential performance issues:
      :::image type="content" source="media/app-map/image-14.png" alt-text="A screenshot displaying the Last 24 hours, calls greater than 3057, and average time greater than 467 filters.":::
@@ -511,7 +511,7 @@ If you're having trouble getting Application Map to work as expected, try these
 
 1. Confirm the [cloud role name](#set-or-override-cloud-role-name) is correctly configured.
 
-1. If you're missing a dependency, make sure it's in the list of [autocollected dependencies](./auto-collect-dependencies.md). If not, you can still track it manually with a [track dependency call](./api-custom-events-metrics.md#trackdependency).
+1. If you're missing a dependency, make sure it's in the list of [autocollected dependencies](asp-net-dependencies.md#dependency-auto-collection). If not, you can still track it manually with a [track dependency call](./api-custom-events-metrics.md#trackdependency).
 
 ### Too many nodes on the map
 

articles/azure-monitor/app/asp-net-dependencies.md

@@ -2,7 +2,7 @@
 title: Dependency tracking in Application Insights | Microsoft Docs
 description: Monitor dependency calls from your on-premises or Azure web application with Application Insights.
 ms.topic: conceptual
-ms.date: 11/15/2022
+ms.date: 12/13/2022
 ms.devlang: csharp
 ms.custom: devx-track-csharp
 ms.reviewer: casocha
@@ -28,7 +28,7 @@ Application Insights SDKs for .NET and .NET Core ship with `DependencyTrackingTe
 |[Azure Service Bus client SDK](https://nuget.org/packages/Azure.Messaging.ServiceBus)| Use the latest package: https://nuget.org/packages/Azure.Messaging.ServiceBus. |
 |Azure Cosmos DB | Only tracked automatically if HTTP/HTTPS is used. TCP mode won't be captured by Application Insights. |
 
-If you're missing a dependency or using a different SDK, make sure it's in the list of [autocollected dependencies](./auto-collect-dependencies.md). If the dependency isn't autocollected, you can track it manually with a [track dependency call](./api-custom-events-metrics.md#trackdependency).
+If you're missing a dependency or using a different SDK, make sure it's in the list of [autocollected dependencies](#dependency-auto-collection). If the dependency isn't autocollected, you can track it manually with a [track dependency call](./api-custom-events-metrics.md#trackdependency).
 
 ## Set up automatic dependency tracking in console apps
 
@@ -224,8 +224,53 @@ In the Log Analytics query view, `timestamp` represents the moment the TrackDepe
 
 Like every Application Insights SDK, the dependency collection module is also open source. Read and contribute to the code or report issues at [the official GitHub repo](https://github.com/Microsoft/ApplicationInsights-dotnet).
 
+## Dependency auto-collection
+
+Below is the currently supported list of dependency calls that are automatically detected as dependencies without requiring any additional modification to your application's code. These dependencies are visualized in the Application Insights [Application map](./app-map.md) and [Transaction diagnostics](./transaction-diagnostics.md) views. If your dependency isn't on the list below, you can still track it manually with a [track dependency call](./api-custom-events-metrics.md#trackdependency).
+
+### .NET
+
+| App frameworks| Versions |
+| ------------------------|----------|
+| ASP.NET Webforms | 4.5+ |
+| ASP.NET MVC | 4+ |
+| ASP.NET WebAPI | 4.5+ |
+| ASP.NET Core | 1.1+ |
+| <b> Communication libraries</b> |
+| [HttpClient](https://dotnet.microsoft.com) | 4.5+, .NET Core 1.1+ |
+| [SqlClient](https://www.nuget.org/packages/System.Data.SqlClient) | .NET Core 1.0+, NuGet 4.3.0 |
+| [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/1.1.2)| 1.1.0 - latest stable release. (See Note below.)
+| [Event Hubs Client SDK](https://www.nuget.org/packages/Microsoft.Azure.EventHubs) | 1.1.0 |
+| [ServiceBus Client SDK](https://www.nuget.org/packages/Microsoft.Azure.ServiceBus) | 3.0.0 |
+| <b>Storage clients</b>|  |
+| ADO.NET | 4.5+ |
+
+> [!NOTE]
+> There is a [known issue](https://github.com/microsoft/ApplicationInsights-dotnet/issues/1347) with older versions of Microsoft.Data.SqlClient. We recommend using 1.1.0 or later to mitigate this issue. Entity Framework Core does not necessarily ship with the latest stable release of Microsoft.Data.SqlClient so we advise confirming that you are on at least 1.1.0 to avoid this issue.   
+
+
+### Java
+
+See the list of Application Insights Java's
+[autocollected dependencies](java-in-process-agent.md#autocollected-dependencies).
+
+### Node.js
+
+A list of the latest [currently supported modules](https://github.com/microsoft/node-diagnostic-channel/tree/master/src/diagnostic-channel-publishers) is maintained [here](https://github.com/microsoft/node-diagnostic-channel/tree/master/src/diagnostic-channel-publishers).
+
+### JavaScript
+
+| Communication libraries | Versions |
+| ------------------------|----------|
+| [XMLHttpRequest](https://developer.mozilla.org/docs/Web/API/XMLHttpRequest) | All |
+
 ## Next steps
 
 * [Exceptions](./asp-net-exceptions.md)
 * [User and page data](./javascript.md)
-* [Availability](./monitor-web-app-availability.md)
+* [Availability](./monitor-web-app-availability.md)
+* Set up custom dependency tracking for [Java](java-in-process-agent.md#add-spans).
+* Set up custom dependency tracking for [OpenCensus Python](./opencensus-python-dependency.md).
+* [Write custom dependency telemetry](./api-custom-events-metrics.md#trackdependency)
+* See [data model](./data-model.md) for Application Insights types and data model.
+* Check out [platforms](./app-insights-overview.md#supported-languages) supported by Application Insights.

articles/azure-monitor/app/auto-collect-dependencies.md

@@ -8,7 +8,7 @@ ms.custom: devx-track-azurepowershell
 ms.reviewer: abinetabate
 ---
 
-# Deploy Application Insights Agent on virtual machines and virtual machine scale sets
+# Deploy Application Insights Agent on virtual machines and Virtual Machine Scale Sets
 
 Enabling monitoring for your .NET or Java-based web applications running on [Azure Virtual Machines](https://azure.microsoft.com/services/virtual-machines/) and [Azure Virtual Machine Scale Sets](../../virtual-machine-scale-sets/index.yml) is now easier than ever. Get all the benefits of using Application Insights without modifying your code.
 
@@ -34,11 +34,11 @@ For a complete list of supported auto-instrumentation scenarios, see [Supported
 
 ### [.NET Framework](#tab/net)
 
-The Application Insights Agent autocollects the same dependency signals out-of-the-box as the SDK. To learn more, see [Dependency autocollection](./auto-collect-dependencies.md#net).
+The Application Insights Agent autocollects the same dependency signals out-of-the-box as the SDK. To learn more, see [Dependency autocollection](asp-net-dependencies.md#net).
 
 ### [.NET Core/.NET](#tab/core)
 
-The Application Insights Agent autocollects the same dependency signals out-of-the-box as the SDK. To learn more, see [Dependency autocollection](./auto-collect-dependencies.md#net).
+The Application Insights Agent autocollects the same dependency signals out-of-the-box as the SDK. To learn more, see [Dependency autocollection](asp-net-dependencies.md#net).
 
 ### [Java](#tab/Java)
 
@@ -119,9 +119,9 @@ You can also view installed extensions in the [Azure Virtual Machine section](..
 > [!NOTE]
 > Verify installation by selecting **Live Metrics Stream** within the Application Insights resource associated with the connection string you used to deploy the Application Insights Agent extension. If you're sending data from multiple virtual machines, select the target virtual machines under **Server Name**. It might take up to a minute for data to begin flowing.
 
-## Manage Application Insights Agent for .NET applications on virtual machine scale sets by using PowerShell
+## Manage Application Insights Agent for .NET applications on Virtual Machine Scale Sets by using PowerShell
 
-Install or update Application Insights Agent as an extension for a virtual machine scale set:
+Install or update Application Insights Agent as an extension for a Virtual Machine Scale Set:
 
 ```powershell
 $publicCfgHashtable =
@@ -152,7 +152,7 @@ Update-AzVmss -ResourceGroupName $vmss.ResourceGroupName -Name $vmss.Name -Virtu
 # Note: Depending on your update policy, you might need to run Update-AzVmssInstance for each instance.
 ```
 
-Uninstall the application monitoring extension from virtual machine scale sets:
+Uninstall the application monitoring extension from Virtual Machine Scale Sets:
 
 ```powershell
 $vmss = Get-AzVmss -ResourceGroupName "<myResourceGroup>" -VMScaleSetName "<myVmssName>"
@@ -164,13 +164,13 @@ Update-AzVmss -ResourceGroupName $vmss.ResourceGroupName -Name $vmss.Name -Virtu
 # Note: Depending on your update policy, you might need to run Update-AzVmssInstance for each instance.
 ```
 
-Query the application monitoring extension status for virtual machine scale sets:
+Query the application monitoring extension status for Virtual Machine Scale Sets:
 
 ```powershell
 # Not supported by extensions framework
 ```
 
-Get a list of installed extensions for virtual machine scale sets:
+Get a list of installed extensions for Virtual Machine Scale Sets:
 
 ```powershell
 Get-AzResource -ResourceId /subscriptions/<mySubscriptionId>/resourceGroups/<myResourceGroup>/providers/Microsoft.Compute/virtualMachineScaleSets/<myVmssName>/extensions
@@ -184,7 +184,7 @@ Get-AzResource -ResourceId /subscriptions/<mySubscriptionId>/resourceGroups/<myR
 
 ## Troubleshooting
 
-Find troubleshooting tips for the Application Insights Monitoring Agent extension for .NET applications running on Azure virtual machines and virtual machine scale sets.
+Find troubleshooting tips for the Application Insights Monitoring Agent extension for .NET applications running on Azure virtual machines and Virtual Machine Scale Sets.
 
 > [!NOTE]
 > The following steps don't apply to Node.js and Python applications, which require SDK instrumentation.
@@ -215,5 +215,5 @@ Added ASP.NET Core auto-instrumentation feature
 
 ## Next steps
 
-* Learn how to [deploy an application to a virtual machine scale set](../../virtual-machine-scale-sets/virtual-machine-scale-sets-deploy-app.md).
+* Learn how to [deploy an application to a Virtual Machine Scale Set](../../virtual-machine-scale-sets/virtual-machine-scale-sets-deploy-app.md).
 * [Set up availability web tests](monitor-web-app-availability.md) to be alerted if your endpoint is down.

articles/azure-monitor/app/azure-vm-vmss-apps.md

@@ -34,7 +34,7 @@ The Application Insights agents and SDKs for .NET, .NET Core, Java, Node.js, and
 * [JavaScript](./javascript.md#enable-distributed-tracing)
 * [Python](opencensus-python.md)
 
-With the proper Application Insights SDK installed and configured, tracing information is automatically collected for popular frameworks, libraries, and technologies by SDK dependency auto-collectors. The full list of supported technologies is available in the [Dependency auto-collection documentation](./auto-collect-dependencies.md).
+With the proper Application Insights SDK installed and configured, tracing information is automatically collected for popular frameworks, libraries, and technologies by SDK dependency auto-collectors. The full list of supported technologies is available in the [Dependency auto-collection documentation](asp-net-dependencies.md#dependency-auto-collection).
 
  Any technology also can be tracked manually with a call to [TrackDependency](./api-custom-events-metrics.md) on the [TelemetryClient](./api-custom-events-metrics.md).
 

articles/azure-monitor/app/distributed-tracing.md

@@ -602,6 +602,6 @@ For the latest updates and bug fixes, [see the Release Notes](./release-notes.md
 ## Next steps
 
 * [Use the API](./api-custom-events-metrics.md) to send your own events and metrics for a detailed view of your app's performance and usage.
-* [Track more dependencies not automatically tracked](./auto-collect-dependencies.md).
+* [Track more dependencies not automatically tracked](asp-net-dependencies.md#dependency-auto-collection).
 * [Enrich or filter auto-collected telemetry](./api-filtering-sampling.md).
 * [Dependency Injection in ASP.NET Core](/aspnet/core/fundamentals/dependency-injection).

articles/azure-monitor/app/worker-service.md

@@ -1534,8 +1534,6 @@ items:
     href: agents/azure-monitor-agent-extension-versions.md
   - name: Application Insights
     items:
-    - name: Dependency auto-collection
-      href: app/auto-collect-dependencies.md
     - name: Telemetry correlation
       href: app/correlation.md
     - name: Azure Functions