Merge pull request #86118 from DawgFan/mmccbranch

Update Agent Naming and Improve Deployment Instructions for VM, VMSS, and On-Prem

Author: megvanhuygen

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

@@ -7,30 +7,35 @@ author: mrbullwinkle
 manager: carmonm
 ms.service: application-insights
 ms.topic: conceptual
-ms.date: 06/27/2019
+ms.date: 08/26/2019
 ms.author: mbullwin
 
 ---
-# Monitor application performance hosted on Azure VM and Azure virtual machine scale sets
+# Deploy the Azure Monitor Application Insights Agent on Azure virtual machines and Azure virtual machine scale sets
 
-Enabling monitoring on your .NET based web applications running on [Azure Virtual Machines](https://azure.microsoft.com/services/virtual-machines/) and [Azure Virtual Machine Scale Sets](https://docs.microsoft.com/azure/virtual-machine-scale-sets/) is now easier than ever. Get all the benefits of using Application Insights without modifying your code.
+Enabling monitoring on your .NET based web applications running on [Azure virtual machines](https://azure.microsoft.com/services/virtual-machines/) and [Azure virtual machine scale sets](https://docs.microsoft.com/azure/virtual-machine-scale-sets/) is now easier than ever. Get all the benefits of using Application Insights without modifying your code.
 
-This article will walk you through enabling Application Insights monitoring using the ApplicationMonitoringWindows extension and provide preliminary guidance for automating the process for large-scale deployments.
+This article walks you through enabling Application Insights monitoring using the Application Insights Agent and provides preliminary guidance for automating the process for large-scale deployments.
 
 > [!IMPORTANT]
-> Azure ApplicationMonitoringWindows extension is currently in public preview.
+> Azure Application Insights Agent for .NET is currently in public preview.
 > This preview version is provided without a service-level agreement, and we don't recommend it for production workloads. Some features might not be supported, and some might have constrained capabilities.
 > For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
 
 ## Enable Application Insights
 
-There are two ways to enable application monitoring for Azure VM and Azure virtual machine scale set hosted applications:
+There are two ways to enable application monitoring for Azure virtual machines and Azure virtual machine scale sets hosted applications:
 
-* **Agent-based application monitoring** (ApplicationMonitoringWindows extension).
-    * This method is the easiest to enable, and no advanced configuration is required. It is often referred to as "runtime" monitoring. For Azure VMs and Azure virtual machine scale sets we recommend at a minimum enabling this level of monitoring. After that, based on your specific scenario, you can evaluate whether manual instrumentation is needed.
-    * Currently only .Net IIS-hosted applications are supported.
+* **Codeless** via Application Insights Agent
+    * This method is the easiest to enable, and no advanced configuration is required. It is often referred to as "runtime" monitoring.
 
-* **Manually instrumenting the application through code** by installing the Application Insights SDK.
+    * For Azure virtual machines and Azure virtual machine scale sets we recommend at a minimum enabling this level of monitoring. After that, based on your specific scenario, you can evaluate whether manual instrumentation is needed.
+
+    * The Application Insights Agent auto-collects the same dependency signals out-of-the-box as the .NET SDK. See [Dependency auto-collection](https://docs.microsoft.com/azure/azure-monitor/app/auto-collect-dependencies#net) to learn more.
+        > [!NOTE]
+        > Currently only .Net IIS-hosted applications are supported. Use an SDK to instrument ASP.NET Core, Java, and Node.js applications hosted on an Azure virtual machines and virtual machine scale sets.
+
+* **Code-based** via SDK
 
     * This approach is much more customizable, but it requires [adding a dependency on the Application Insights SDK NuGet packages](https://docs.microsoft.com/azure/azure-monitor/app/asp-net). This method, also means you have to manage the updates to the latest version of the packages yourself.
 
@@ -39,9 +44,15 @@ There are two ways to enable application monitoring for Azure VM and Azure virtu
 > [!NOTE]
 > If both agent based monitoring and manual SDK based instrumentation is detected only the manual instrumentation settings will be honored. This is to prevent duplicate data from being sent. To learn more about this check out the [troubleshooting section](#troubleshooting) below.
 
-## Manage agent-based monitoring for .NET applications on VM using PowerShell
+## Manage Application Insights Agent for .NET applications on Azure virtual machines using PowerShell
+
+> [!NOTE]
+> Before installing the Application Insights Agent, you'll need an instrumentation key. [Create a new Application Insights Resource](https://docs.microsoft.com/azure/azure-monitor/app/create-new-resource) or copy the instrumentation key from an existing application insights resource.
+
+> [!NOTE]
+> New to powershell? Check out the [Get Started Guide](https://docs.microsoft.com/powershell/azure/get-started-azureps?view=azps-2.5.0).
 
-Install or update the application monitoring extension for VM
+Install or update the Application Insights Agent as an extension for Azure virtual machines
 ```powershell
 $publicCfgJsonString = '
 {
@@ -62,20 +73,23 @@ $publicCfgJsonString = '
 ';
 $privateCfgJsonString = '{}';
 
-Set-AzVMExtension -ResourceGroupName "<myVmResourceGroup>" -VMName "<myVmName>" -Location "South Central US" -Name "ApplicationMonitoring" -Publisher "Microsoft.Azure.Diagnostics" -Type "ApplicationMonitoringWindows" -Version "2.8" -SettingString $publicCfgJsonString -ProtectedSettingString $privateCfgJsonString
+Set-AzVMExtension -ResourceGroupName "<myVmResourceGroup>" -VMName "<myVmName>" -Location "<myVmLocation>" -Name "ApplicationMonitoring" -Publisher "Microsoft.Azure.Diagnostics" -Type "ApplicationMonitoringWindows" -Version "2.8" -SettingString $publicCfgJsonString -ProtectedSettingString $privateCfgJsonString
 ```
 
-Uninstall application monitoring extension from VM
+> [!NOTE]
+> You may install or update the Application Insights Agent as an extension across multiple Virtual Machines at-scale using a Powershell loop.
+
+Uninstall Application Insights Agent extension from Azure virtual machine
 ```powershell
 Remove-AzVMExtension -ResourceGroupName "<myVmResourceGroup>" -VMName "<myVmName>" -Name "ApplicationMonitoring"
 ```
 
-Query application monitoring extension status for VM
+Query Application Insights Agent extension status for Azure virtual machine
 ```powershell
 Get-AzVMExtension -ResourceGroupName "<myVmResourceGroup>" -VMName "<myVmName>" -Name ApplicationMonitoring -Status
 ```
 
-Get list of installed extensions for VM
+Get list of installed extensions for Azure virtual machine
 ```powershell
 Get-AzResource -ResourceId "/subscriptions/<mySubscriptionId>/resourceGroups/<myVmResourceGroup>/providers/Microsoft.Compute/virtualMachines/<myVmName>/extensions"
 
@@ -85,10 +99,14 @@ Get-AzResource -ResourceId "/subscriptions/<mySubscriptionId>/resourceGroups/<my
 # Location          : southcentralus
 # ResourceId        : /subscriptions/<mySubscriptionId>/resourceGroups/<myVmResourceGroup>/providers/Microsoft.Compute/virtualMachines/<myVmName>/extensions/ApplicationMonitoring
 ```
+You may also view installed extensions in the [Azure virtual machine blade](https://docs.microsoft.com/azure/virtual-machines/extensions/overview) in the Portal.
+
+> [!NOTE]
+> Verify installation by clicking on Live Metrics Stream within the Application Insights Resource associated with the instrumentation key you used to deploy the Application Insights Agent Extension. If you are sending data from multiple Virtual Machines, select the target Azure virtual machines under Server Name. It may take up to a minute for data to begin flowing.
 
-## Manage agent-based monitoring for .NET applications on Azure virtual machine scale set using powershell
+## Manage Application Insights Agent for .NET applications on Azure virtual machine scale sets using powershell
 
-Install or update the application monitoring extension for Azure virtual machine scale set
+Install or update the Application Insights Agent as an extension for Azure virtual machine scale set
 ```powershell
 $publicCfgHashtable =
 @{
@@ -117,7 +135,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 application monitoring extension from Azure virtual machine scale set
+Uninstall application monitoring extension from Azure virtual machine scale sets
 ```powershell
 $vmss = Get-AzVmss -ResourceGroupName "<myResourceGroup>" -VMScaleSetName "<myVmssName>"
 
@@ -128,12 +146,12 @@ 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 application monitoring extension status for Azure virtual machine scale set
+Query application monitoring extension status for Azure virtual machine scale sets
 ```powershell
 # Not supported by extensions framework
 ```
 
-Get list of installed extensions for Azure virtual machine scale set
+Get list of installed extensions for Azure virtual machine scale sets
 ```powershell
 Get-AzResource -ResourceId /subscriptions/<mySubscriptionId>/resourceGroups/<myResourceGroup>/providers/Microsoft.Compute/virtualMachineScaleSets/<myVmssName>/extensions
 
@@ -146,10 +164,10 @@ Get-AzResource -ResourceId /subscriptions/<mySubscriptionId>/resourceGroups/<myR
 
 ## Troubleshooting
 
-Below is our step-by-step troubleshooting guide for extension-based monitoring for .NET applications running on Azure VM and Azure virtual machine scale sets.
+Find troubleshooting tips for Application Insights Monitoring Agent Extension for .NET applications running on Azure virtual machines and virtual machine scale sets.
 
 > [!NOTE]
-> .NET Core, Java, and Node.js applications are only supported on Azure VM and Azure virtual machine scale sets via manual SDK based instrumentation and therefore the steps below do not apply to these scenarios.
+> .NET Core, Java, and Node.js applications are only supported on Azure virtual machines and Azure virtual machine scale sets via manual SDK based instrumentation and therefore the steps below do not apply to these scenarios.
 
 Extension execution output is logged to files found in the following directories:
 ```Windows

articles/azure-monitor/app/monitor-performance-live-website-now.md

@@ -10,11 +10,14 @@ ms.service: application-insights
 ms.workload: tbd
 ms.tgt_pltfrm: ibiza
 ms.topic: conceptual
-ms.date: 05/24/2019
+ms.date: 08/26/2019
 ms.author: mbullwin
 ---
 # Instrument web apps at runtime with Application Insights Codeless Attach
 
+> [!IMPORTANT]
+> Status Monitor is no longer recommended for use. It has been replaced by the Azure Monitor Application Insights Agent (formerly named Status Monitor v2). See our documentation for [on-premises server deployments](https://docs.microsoft.com/azure/azure-monitor/app/status-monitor-v2-overview) or [Azure virtual machine and virtual machine scale set deployments](https://docs.microsoft.com/azure/azure-monitor/app/azure-vm-vmss-apps).
+
 You can instrument a live web app with Azure Application Insights, without having to modify or redeploy your code. You need a [Microsoft Azure](https://azure.com) subscription.
 
 Status Monitor is used to instrument a .NET application hosted in IIS either on-premises or in a VM.
@@ -33,7 +36,7 @@ You have a choice of two routes to apply Application Insights to your .NET web a
 * **Run time:** Instrument your web app on the server, as described below, without rebuilding and redeploying the code.
 
 > [!NOTE]
-> If you use build time instrumentation, run time instrumention will not work even if it is turned on.
+> If you use build time instrumentation, run time instrumentation will not work even if it is turned on.
 
 Here's a summary of what you get by each route:
 

articles/azure-monitor/app/status-monitor-v2-api-disable-instrumentation-engine.md

@@ -1,6 +1,6 @@
 ---
-title: "Azure Status Monitor v2 API reference: Disable instrumentation engine | Microsoft Docs"
-description: Status Monitor v2 API reference. Disable-InstrumentationEngine. Monitor website performance without redeploying the website. Works with ASP.NET web apps hosted on-premises, in VMs, or on Azure.
+title: "Azure Application Insights Agent API reference: Disable instrumentation engine | Microsoft Docs"
+description: Application Insights Agent API reference. Disable-InstrumentationEngine. Monitor website performance without redeploying the website. Works with ASP.NET web apps hosted on-premises, in VMs, or on Azure.
 services: application-insights
 documentationcenter: .net
 author: TimothyMothra
@@ -13,7 +13,7 @@ ms.topic: conceptual
 ms.date: 04/23/2019
 ms.author: tilee
 ---
-# Status Monitor v2 API: Disable-InstrumentationEngine
+# Application Insights Agent API: Disable-InstrumentationEngine
 
 This article describes a cmdlet that's a member of the [Az.ApplicationMonitor PowerShell module](https://www.powershellgallery.com/packages/Az.ApplicationMonitor/).
 
@@ -51,5 +51,5 @@ Configuring registry for instrumentation engine...
 
 ## Next steps
 
- Do more with Status Monitor v2:
- - Use our guide to [troubleshoot](status-monitor-v2-troubleshoot.md) Status Monitor v2.
+ Do more with Application Insights Agent:
+ - Use our guide to [troubleshoot](status-monitor-v2-troubleshoot.md) Application Insights Agent.

articles/azure-monitor/app/status-monitor-v2-api-disable-monitoring.md

@@ -1,6 +1,6 @@
 ---
-title: "Azure Status Monitor v2 API reference: Disable monitoring | Microsoft Docs"
-description: Status Monitor v2 API reference. Disable-ApplicationInsightsMonitoring. Monitor website performance without redeploying the website. Works with ASP.NET web apps hosted on-premises, in VMs, or on Azure.
+title: "Azure Application Insights Agent API reference: Disable monitoring | Microsoft Docs"
+description: Application Insights Agent API reference. Disable-ApplicationInsightsMonitoring. Monitor website performance without redeploying the website. Works with ASP.NET web apps hosted on-premises, in VMs, or on Azure.
 services: application-insights
 documentationcenter: .net
 author: TimothyMothra
@@ -13,7 +13,7 @@ ms.topic: conceptual
 ms.date: 04/23/2019
 ms.author: tilee
 ---
-# Status Monitor v2 API: Disable-ApplicationInsightsMonitoring
+# Application Insights Agent API: Disable-ApplicationInsightsMonitoring
 
 This article describes a cmdlet that's a member of the [Az.ApplicationMonitor PowerShell module](https://www.powershellgallery.com/packages/Az.ApplicationMonitor/).
 
@@ -65,5 +65,5 @@ Successfully disabled Application Insights Status Monitor
 
 ## Next steps
 
- Do more with Status Monitor v2:
- - Use our guide to [troubleshoot](status-monitor-v2-troubleshoot.md) Status Monitor v2.
+ Do more with Application Insights Agent:
+ - Use our guide to [troubleshoot](status-monitor-v2-troubleshoot.md) Application Insights Agent.

articles/azure-monitor/app/status-monitor-v2-api-enable-instrumentation-engine.md

@@ -1,6 +1,6 @@
 ---
-title: "Azure Status Monitor v2 API reference: Enable instrumentation engine | Microsoft Docs"
-description: Status Monitor v2 API reference. Enable-InstrumentationEngine. Monitor website performance without redeploying the website. Works with ASP.NET web apps hosted on-premises, in VMs, or on Azure.
+title: "Azure Application Insights Agent API reference: Enable instrumentation engine | Microsoft Docs"
+description: Application Insights Agent API reference. Enable-InstrumentationEngine. Monitor website performance without redeploying the website. Works with ASP.NET web apps hosted on-premises, in VMs, or on Azure.
 services: application-insights
 documentationcenter: .net
 author: TimothyMothra
@@ -13,7 +13,7 @@ ms.topic: conceptual
 ms.date: 04/23/2019
 ms.author: tilee
 ---
-# Status Monitor v2 API: Enable-InstrumentationEngine
+# Application Insights Agent API: Enable-InstrumentationEngine
 
 This article describes a cmdlet that's a member of the [Az.ApplicationMonitor PowerShell module](https://www.powershellgallery.com/packages/Az.ApplicationMonitor/).
 
@@ -73,7 +73,7 @@ Configuring registry for instrumentation engine...
 - [Add web client telemetry](../../azure-monitor/app/javascript.md) to see exceptions from web page code and to enable trace calls.
 - [Add the Application Insights SDK to your code](../../azure-monitor/app/asp-net.md) so you can insert trace and log calls.
 
- Do more with Status Monitor v2:
- - Use our guide to [troubleshoot](status-monitor-v2-troubleshoot.md) Status Monitor v2.
+ Do more with Application Insights Agent:
+ - Use our guide to [troubleshoot](status-monitor-v2-troubleshoot.md) Application Insights Agent.
  - [Get the config](status-monitor-v2-api-get-config.md) to confirm that your settings were recorded correctly.
  - [Get the status](status-monitor-v2-api-get-status.md) to inspect monitoring.

articles/azure-monitor/app/status-monitor-v2-api-enable-monitoring.md

@@ -1,6 +1,6 @@
 ---
-title: "Azure Status Monitor v2 API reference: Enable monitoring | Microsoft Docs"
-description: Status Monitor v2 API reference. Enable-ApplicationInsightsMonitoring. Monitor website performance without redeploying the website. Works with ASP.NET web apps hosted on-premises, in VMs, or on Azure.
+title: "Azure Application Insights Agent API reference: Enable monitoring | Microsoft Docs"
+description: Application Insights Agent API reference. Enable-ApplicationInsightsMonitoring. Monitor website performance without redeploying the website. Works with ASP.NET web apps hosted on-premises, in VMs, or on Azure.
 services: application-insights
 documentationcenter: .net
 author: TimothyMothra
@@ -13,7 +13,7 @@ ms.topic: conceptual
 ms.date: 04/23/2019
 ms.author: tilee
 ---
-# Status Monitor v2 API: Enable-ApplicationInsightsMonitoring
+# Application Insights Agent API: Enable-ApplicationInsightsMonitoring
 
 This article describes a cmdlet that's a member of the [Az.ApplicationMonitor PowerShell module](https://www.powershellgallery.com/packages/Az.ApplicationMonitor/).
 
@@ -159,7 +159,7 @@ Successfully enabled Application Insights Status Monitor
 - [Add web client telemetry](../../azure-monitor/app/javascript.md) to see exceptions from web page code and to enable trace calls.
 - [Add the Application Insights SDK to your code](../../azure-monitor/app/asp-net.md) so you can insert trace and log calls.
 
- Do more with Status Monitor v2:
- - Use our guide to [troubleshoot](status-monitor-v2-troubleshoot.md) Status Monitor v2.
+ Do more with Application Insights Agent:
+ - Use our guide to [troubleshoot](status-monitor-v2-troubleshoot.md) Application Insights Agent.
  - [Get the config](status-monitor-v2-api-get-config.md) to confirm that your settings were recorded correctly.
  - [Get the status](status-monitor-v2-api-get-status.md) to inspect monitoring.