Merge pull request #79411 from ShannonLeavitt/vminsights-enable-single-vm

edit pass: vminsights enable single vm

Author: ShawnJackson

articles/azure-monitor/insights/vminsights-enable-overview.md

@@ -1,6 +1,6 @@
 ---
 title: Enable Azure Monitor for VMs (preview) overview | Microsoft Docs
-description: This article describes how you deploy and configure Azure Monitor for VMs and the required system requirements.
+description: Learn how to deploy and configure Azure Monitor for VMs. Find out the system requirements.
 services: azure-monitor
 documentationcenter: ''
 author: mgoedtel
@@ -17,14 +17,14 @@ ms.author: magoedte
 
 # Enable Azure Monitor for VMs (preview) overview
 
-This article provides an overview of the options available to setup Azure Monitor for VMs to monitor the health, performance, and discover application dependencies running on Azure virtual machines and virtual machine scale sets, on-premise VMs, or VMs hosted in another cloud environment.  
+This article provides an overview of the options available to set up Azure Monitor for VMs. Use Azure Monitor for VMs to monitor health and performance. Discover application dependencies that run on Azure virtual machines (VMs) and virtual machine scale sets, on-premises VMs, or VMs hosted in another cloud environment.  
 
-You enable Azure Monitor for VMs by using one of the following methods:
+To set up Azure Monitor for VMs:
 
-* Enable a single Azure virtual machine or virtual machine scale set by selecting **Insights (preview)** directly from the VM or virtual machine scale set.
-* Enable two or more Azure VMs and virtual machine scale sets by using Azure Policy. Through this method, the required dependencies of existing and new VMs and scale sets are installed and properly configured. Non-compliant VMs and scale sets are reported, so you can decide whether to enable them and how you want to remediate them.
+* Enable a single Azure VM or virtual machine scale set by selecting **Insights (preview)** directly from the VM or virtual machine scale set.
+* Enable two or more Azure VMs and virtual machine scale sets by using Azure Policy. This method ensures that on existing and new VMs and scale sets, the required dependencies are installed and properly configured. Noncompliant VMs and scale sets are reported, so you can decide whether to enable them and to remediate them.
 * Enable two or more Azure VMs or virtual machine scale sets across a specified subscription or resource group by using PowerShell.
-* Enable to monitor virtual machines or physical computers hosted in your corporate network or other cloud environment.
+* Enable Azure Monitor for VMs to monitor VMs or physical computers hosted in your corporate network or other cloud environment.
 
 ## Prerequisites
 
@@ -45,30 +45,30 @@ Azure Monitor for VMs supports a Log Analytics workspace in the following region
 <sup>1</sup> This region doesn't currently support the Health feature of Azure Monitor for VMs.
 
 >[!NOTE]
->Azure virtual machines can be deployed from any region and aren't limited to the supported regions for the Log Analytics workspace.
+>You can deploy Azure VMs from any region. These VMs aren't limited to the regions supported by the Log Analytics workspace.
 >
 
-If you don't have a workspace, you can create one with one of the following methods:
+If you don't have a workspace, you can create one by using one of these resources:
 * [The Azure CLI](../../azure-monitor/learn/quick-create-workspace-cli.md)
 * [PowerShell](../../azure-monitor/learn/quick-create-workspace-posh.md)
 * [The Azure portal](../../azure-monitor/learn/quick-create-workspace.md)
 * [Azure Resource Manager](../../azure-monitor/platform/template-workspace-configuration.md)
 
-If you're enabling monitoring for a single Azure VM or virtual machine scale set in the Azure portal, you can create a workspace during this process.
+You can also create a workspace while you're enabling monitoring for a single Azure VM or virtual machine scale set in the Azure portal.
 
-For the at-scale scenario using Azure Policy, Azure PowerShell, or Azure Resource Manager templates, your Log Analytics workspace first needs the following configured:
+To set up an at-scale scenario that uses Azure Policy, Azure PowerShell, or Azure Resource Manager templates, in your Log Analytics workspace:
 
-* Install the ServiceMap and InfrastructureInsights solutions. You can complete this installation by using an Azure Resource Manager template that's provided or by using the **Configure Workspace** option found on the **Get Started** tab.
+* Install the ServiceMap and InfrastructureInsights solutions. You can complete this installation by using a provided Azure Resource Manager template. Or on the **Get Started** tab, select **Configure Workspace**.
 * Configure the Log Analytics workspace to collect performance counters.
 
-To configure your workspace for the at-scale scenario, you can configure it using one of the following methods:
+To configure your workspace for the at-scale scenario, use one of the following methods:
 
-* [Azure PowerShell](vminsights-enable-at-scale-powershell.md#set-up-a-log-analytics-workspace)
-* From the **Configure Workspace** option on the Azure Monitor for VMs [Policy Coverage](vminsights-enable-at-scale-policy.md#manage-policy-coverage-feature-overview) page
+* Use [Azure PowerShell](vminsights-enable-at-scale-powershell.md#set-up-a-log-analytics-workspace).
+* On the Azure Monitor for VMs [**Policy Coverage**](vminsights-enable-at-scale-policy.md#manage-policy-coverage-feature-overview) page, select **Configure Workspace**. 
 
 ### Supported operating systems
 
-The following table lists the Windows and Linux operating systems that are supported with Azure Monitor for VMs. A full list that details the major and minor Linux OS release and supported kernel versions is provided later in this section.
+The following table lists the Windows and Linux operating systems that Azure Monitor for VMs supports. Later in this section, you'll find a full list that details the major and minor Linux OS release and supported kernel versions.
 
 |OS version |Performance |Maps |Health |
 |-----------|------------|-----|-------|
@@ -84,13 +84,13 @@ The following table lists the Windows and Linux operating systems that are suppo
 |SUSE Linux Enterprise Server (SLES) 11, 12 | X | X | X |
 |Debian 8, 9.4 | X<sup>1</sup> | | X |
 
-<sup>1</sup> The Performance feature of Azure Monitor for VMs is available only from Azure Monitor. It isn't available when you access it directly from the left pane of the Azure VM.
+<sup>1</sup> The Performance feature of Azure Monitor for VMs is available only from Azure Monitor. It isn't available directly from the left pane of the Azure VM.
 
 >[!NOTE]
->The following information applies to support of the Linux operating system:
+>In the Linux operating system:
 > - Only default and SMP Linux kernel releases are supported.
 > - Nonstandard kernel releases, such as Physical Address Extension (PAE) and Xen, aren't supported for any Linux distribution. For example, a system with the release string of *2.6.16.21-0.8-xen* isn't supported.
-> - Custom kernels, including recompiles of standard kernels, aren't supported.
+> - Custom kernels, including recompilations of standard kernels, aren't supported.
 > - CentOSPlus kernel is supported.
 
 #### Red Hat Linux 7
@@ -108,7 +108,7 @@ The following table lists the Windows and Linux operating systems that are suppo
 | 6.9 | 2.6.32-696 |
 | 6.10 | 2.6.32-754 |
 
-### CentOSPlus
+#### CentOSPlus
 | OS version | Kernel version |
 |:--|:--|
 | 6.9 | 2.6.32-696.18.7<br>2.6.32-696.30.1 |
@@ -138,21 +138,21 @@ The following table lists the Windows and Linux operating systems that are suppo
 
 ### The Microsoft Dependency agent
 
-The Azure Monitor for VMs Map feature gets its data from the Microsoft Dependency agent. The Dependency agent relies on the Log Analytics agent for its connection to Log Analytics. Therefore, your system must have the Log Analytics agent installed and configured with the Dependency agent.
+The Map feature in Azure Monitor for VMs gets its data from the Microsoft Dependency agent. The Dependency agent relies on the Log Analytics agent for its connection to Log Analytics. So your system must have the Log Analytics agent installed and configured with the Dependency agent.
 
-Whether you enable Azure Monitor for VMs for a single Azure VM or you use the at-scale deployment method, you need to use the Azure VM Dependency agent extension to install the agent as part of the experience.
+Whether you enable Azure Monitor for VMs for a single Azure VM or you use the at-scale deployment method, use the Azure VM Dependency agent extension to install the agent as part of the experience.
 
-In a hybrid environment, you can download and install the Dependency agent in either of two ways: manually, or by using an automated deployment method for virtual machines that are hosted outside Azure.
+In a hybrid environment, you can download and install the Dependency agent manually. If your VMs are hosted outside Azure, use an automated deployment method.
 
 The following table describes the connected sources that the Map feature supports in a hybrid environment.
 
 | Connected source | Supported | Description |
 |:--|:--|:--|
-| Windows agents | Yes | In addition to the [Log Analytics agent for Windows](../../azure-monitor/platform/log-analytics-agent.md), Windows agents require the Microsoft Dependency agent. For a complete list of operating system versions, see [supported operating systems](#supported-operating-systems). |
-| Linux agents | Yes | In addition to the [Log Analytics agent for Linux](../../azure-monitor/platform/log-analytics-agent.md), Linux agents require the Microsoft Dependency agent. For a complete list of operating system versions, see [supported operating systems](#supported-operating-systems). |
+| Windows agents | Yes | Along with the [Log Analytics agent for Windows](../../azure-monitor/platform/log-analytics-agent.md), Windows agents need the Dependency agent. For more information, see [supported operating systems](#supported-operating-systems). |
+| Linux agents | Yes | Along with the [Log Analytics agent for Linux](../../azure-monitor/platform/log-analytics-agent.md), Linux agents need the Dependency agent. For more information, see [supported operating systems](#supported-operating-systems). |
 | System Center Operations Manager management group | No | |
 
-The Dependency agent can be downloaded from the following locations:
+You can download the Dependency agent from these locations:
 
 | File | OS | Version | SHA-256 |
 |:--|:--|:--|:--|
@@ -161,28 +161,24 @@ The Dependency agent can be downloaded from the following locations:
 
 ## Role-based access control
 
-To enable and access the features in Azure Monitor for VMs, you need to be assigned the following access roles:
-
-- To enable it, you must have the *Log Analytics contributor* role.
-
-- To view performance, health, and map data, you must have the *Monitoring Reader* role for the Azure VM. The Log Analytics workspace must be configured for Azure Monitor for VMs.
+To enable and access the features in Azure Monitor for VMs, you must have the *Log Analytics contributor* role. To view performance, health, and map data, you must have the *monitoring reader* role for the Azure VM. The Log Analytics workspace must be configured for Azure Monitor for VMs.
 
 For more information about how to control access to a Log Analytics workspace, see [Manage workspaces](../../azure-monitor/platform/manage-access.md).
 
 ## How to enable Azure Monitor for VMs (preview)
 
-You enable Azure Monitor for VMs by using one of the following methods described in the following table.
+Enable Azure Monitor for VMs by using one of the methods described in this table:
 
 | Deployment state | Method | Description |
 |------------------|--------|-------------|
-| Single Azure VM or virtual machine scale set | [Directly from the VM](vminsights-enable-single-vm.md) | You can enable a single Azure virtual machine by selecting **Insights (preview)** directly from the VM or virtual machine scale set. |
-| Multiple Azure VMs or virtual machine scale sets | [Azure Policy](vminsights-enable-at-scale-policy.md) | You can enable multiple Azure VMs using Azure Policy and available policy definitions. |
-| Multiple Azure VMs or virtual machine scale sets | [Azure PowerShell or Azure Resource Manager templates](vminsights-enable-at-scale-powershell.md) | You can enable multiple Azure VMs or virtual machine scale sets across a specified subscription or resource group using Azure PowerShell or Azure Resource Manager templates. |
-| Hybrid cloud | [Enable for Hybrid environment](vminsights-enable-hybrid-cloud.md) | You can deploy to virtual machines or physical computers that are hosted in your datacenter or other cloud environments. |
+| Single Azure VM or virtual machine scale set | [Enable from the VM](vminsights-enable-single-vm.md) | You can enable a single Azure VM by selecting **Insights (preview)** directly from the VM or virtual machine scale set. |
+| Multiple Azure VMs or virtual machine scale sets | [Enable through Azure Policy](vminsights-enable-at-scale-policy.md) | You can enable multiple Azure VMs by using Azure Policy and available policy definitions. |
+| Multiple Azure VMs or virtual machine scale sets | [Enable through Azure PowerShell or Azure Resource Manager templates](vminsights-enable-at-scale-powershell.md) | You can enable multiple Azure VMs or virtual machine scale sets across a specified subscription or resource group by using Azure PowerShell or Azure Resource Manager templates. |
+| Hybrid cloud | [Enable for the hybrid environment](vminsights-enable-hybrid-cloud.md) | You can deploy to VMs or physical computers that are hosted in your datacenter or other cloud environments. |
 
-## Performance counters enabled
+## Performance counters enabled 
 
-Azure Monitor for VMs configures a Log Analytics workspace to collect the performance counters that it uses. The following table lists the objects and counters that are collected every 60 seconds.
+Azure Monitor for VMs configures a Log Analytics workspace to collect the performance counters that it uses. The following tables list the objects and counters that are collected every 60 seconds.
 
 ### Windows performance counters
 
@@ -223,12 +219,16 @@ Azure Monitor for VMs configures a Log Analytics workspace to collect the perfor
 
 ## Diagnostic and usage data
 
-Microsoft automatically collects usage and performance data through your use of the Azure Monitor service. Microsoft uses this data to provide and improve the quality, security, and integrity of the service. To provide accurate and efficient troubleshooting capabilities, data from the Map feature includes information about the configuration of your software, such as the operating system and version, IP address, DNS name, and workstation name. Microsoft doesn't collect names, addresses, or other contact information.
+Microsoft automatically collects usage and performance data through your use of the Azure Monitor service. Microsoft uses this data to improve the quality, security, and integrity of the service. 
+
+To provide accurate and efficient troubleshooting capabilities, the Map feature includes data about the configuration of your software. The data provides information such as the operating system and version, IP address, DNS name, and workstation name. Microsoft doesn't collect names, addresses, or other contact information.
 
 For more information about data collection and usage, see the [Microsoft Online Services Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=512132).
 
 [!INCLUDE [GDPR-related guidance](../../../includes/gdpr-dsr-and-stp-note.md)]
 
+Now that you've enabled monitoring for your VM, monitoring information is available for analysis in Azure Monitor for VMs.
+
 ## Next steps
 
-Now that monitoring is enabled for your virtual machine, this information is available for analysis with Azure Monitor for VMs. To learn how to use the Health feature, see [View Azure Monitor for VMs Health](vminsights-health.md). To view discovered application dependencies, see [View Azure Monitor for VMs Map](vminsights-maps.md).
+To learn how to use the Health feature, see [View Azure Monitor for VMs Health](vminsights-health.md). To view discovered application dependencies, see [View Azure Monitor for VMs Map](vminsights-maps.md).