edit pass: virtual-machines-batch-3

Author: paulth1

articles/azure-monitor/vm/vminsights-change-analysis.md

@@ -1,33 +1,32 @@
 ---
 title: Change analysis in VM insights
-description: VM insights integration with Application Change Analysis integration allows you to view any changes made to a virtual machine that may have affected it performance.
+description: VM insights integration with Application Change Analysis integration allows you to view any changes made to a virtual machine that might have affected it performance.
 ms.topic: conceptual
 ms.date: 06/08/2022
 
 ---
 
 # Change analysis in VM insights
-VM insights integration with [Application Change Analysis](../app/change-analysis.md) integration allows you to view any changes made to a virtual machine that may have affected it performance.
+VM insights integration with [Application Change Analysis](../app/change-analysis.md) integration allows you to view any changes made to a virtual machine that might have affected its performance.
 
 ## Overview
-Suppose you have a VM that beings running slow and want to investigate whether recent changes to its configuration could have affected its performance. You view the performance of the VM using VM insights and find that there is an increase in memory usage in the past hour. Change analysis can help you determine whether any configuration changes made around this time were the cause of this increase.
+Suppose you have a VM that's running slow and you want to investigate whether recent changes to its configuration could have affected its performance. You view the performance of the VM by using VM insights and find that there's an increase in memory usage in the past hour. Change analysis can help you determine whether any configuration changes made around this time were the cause of the increase.
 
-The Application Change Analysis service aggregates changes from [Azure Resource Graph](../../governance/resource-graph/how-to/get-resource-changes.md) as well as nested properties changes such as network security rules from Azure Resource Manager. 
+The Application Change Analysis service aggregates changes from [Azure Resource Graph](../../governance/resource-graph/how-to/get-resource-changes.md) and nested properties changes like network security rules from Azure Resource Manager.
 
-## Enabling change analysis
-To onboard change analysis in VM insights, you must register the *Microsoft.ChangeAnalysis* resource provider. The first time you launch VM insights or Application Change Analysis in the Azure portal, this resource provider will automatically be registered for you. Application Change Analysis is a free service that has no performance overhead on resources.
+## Enable change analysis
+To onboard change analysis in VM insights, you must register the *Microsoft.ChangeAnalysis* resource provider. The first time you start VM insights or Application Change Analysis in the Azure portal, this resource provider is automatically registered for you. Application Change Analysis is a free service that has no performance overhead on resources.
 
 ## View change analysis
-Change analysis is available from the **Performance** or **Map** tab of VM insights by selecting the **Change** option. 
+Change analysis is available from the **Performance** or **Map** tab of VM insights by selecting the **Change** option.
 
-[![Investigate changes](media/vminsights-change-analysis/investigate-changes-screenshot.png)](media/vminsights-change-analysis/investigate-changes-screenshot-zoom.png#lightbox)
+[![Screenshot that shows investigating changes.](media/vminsights-change-analysis/investigate-changes-screenshot.png)](media/vminsights-change-analysis/investigate-changes-screenshot-zoom.png#lightbox)
 
+Select **Investigate Changes** to open the Application Change Analysis page filtered for the VM. Review the listed changes to see if there are any that could have caused the issue. If you're unsure about a particular change, look at the **Changed by** column to identify the person who made the change.
 
-Click the **Investigate changes** button to launch the Application Change Analysis page filtered for the VM. You can review the listed changes to see if there are any that could have caused the issue. If you are unsure about a particular change, you can reference the **Change by** column to determine the person who made the change.
-
-[![Change details](media/vminsights-change-analysis/change-details-screenshot.png)](media/vminsights-change-analysis/change-details-screenshot.png#lightbox)
+[![Screenshot that shows the Change details screen.](media/vminsights-change-analysis/change-details-screenshot.png)](media/vminsights-change-analysis/change-details-screenshot.png#lightbox)
 
 ## Next steps
 - Learn more about [Application Change Analysis](../app/change-analysis.md).
-- Learn more about [Azure Resource Graph](../../governance/resource-graph/how-to/get-resource-changes.md). 
+- Learn more about [Azure Resource Graph](../../governance/resource-graph/how-to/get-resource-changes.md).
 

articles/azure-monitor/vm/vminsights-enable-powershell.md

@@ -1,38 +1,40 @@
 ---
-title: Enable VM insights using PowerShell
-description: Describes how to enable VM insights for Azure virtual machines or Virtual Machine Scale Sets using Azure PowerShell.
+title: Enable VM insights by using PowerShell
+description: This article describes how to enable VM insights for Azure virtual machines or virtual machine scale sets by using Azure PowerShell.
 ms.topic: conceptual
 author: bwren
 ms.author: bwren
 ms.date: 06/08/2022
 
 ---
 
-# Enable VM insights using PowerShell
-This article describes how to enable VM insights on Azure virtual machines using PowerShell. This procedure can be used for the following:
+# Enable VM insights by using PowerShell
+This article describes how to enable VM insights on Azure virtual machines by using PowerShell. This procedure can be used for:
 
-- Azure virtual machine
-- Azure Virtual Machine Scale Set
+- Azure Virtual Machines
+- Azure Virtual Machine Scale Sets
 
 > [!NOTE]
-> This article only applies to the Log Analytics agent. To enable VM insights with the Azure monitor agent, use other installation methods described in [Enable VM insights overview](vminsights-enable-overview.md).
+> This article only applies to the Log Analytics agent. To enable VM insights with the Azure Monitor agent, use other installation methods described in [Enable VM insights overview](vminsights-enable-overview.md).
 ## Prerequisites
 
-- [Log Analytics workspace configured for VM insights](../vm/vminsights-configure-workspace.md). 
-- See [Supported operating systems](./vminsights-enable-overview.md#supported-operating-systems) to ensure that the operating system of the virtual machine or Virtual Machine Scale Set you're enabling is supported. 
-- See [Manage the Azure Monitor agent](../agents/azure-monitor-agent-manage.md#prerequisites) for prerequisites related to Azure Monitor agent.
+You need to:
+
+- [Configure a Log Analytics workspace for VM insights](../vm/vminsights-configure-workspace.md).
+- See [Supported operating systems](./vminsights-enable-overview.md#supported-operating-systems) to ensure that the operating system of the virtual machine or virtual machine scale set you're enabling is supported.
+- See [Manage Azure Monitor Agent](../agents/azure-monitor-agent-manage.md#prerequisites) for prerequisites related to Azure Monitor Agent.
 
 ## PowerShell script
 
-To enable VM insights for multiple VMs or Virtual Machine Scale Sets, use the PowerShell script [Install-VMInsights.ps1](https://www.powershellgallery.com/packages/Install-VMInsights), which is available from the Azure PowerShell Gallery. This script iterates through:
+To enable VM insights for multiple VMs or virtual machine scale set, use the PowerShell script [Install-VMInsights.ps1](https://www.powershellgallery.com/packages/Install-VMInsights). The script is available from the Azure PowerShell Gallery. This script iterates through:
 
-- Every virtual machine and Virtual Machine Scale Set in your subscription.
+- Every virtual machine and virtual machine scale set in your subscription.
 - The scoped resource group that's specified by *ResourceGroup*.
-- A single VM or Virtual Machine Scale Set that's specified by *Name*.
+- A single VM or virtual machine scale set that's specified by *Name*.
 
-For each virtual machine or Virtual Machine Scale Set, the script verifies whether the VM extension for the Log Analytics agent and Dependency agent is already installed. If both extensions are installed, the script tries to reinstall it. If both extensions aren't installed, the script installs them.
+For each virtual machine or virtual machine scale set, the script verifies whether the VM extension for the Log Analytics agent and Dependency agent is already installed. If both extensions are installed, the script tries to reinstall it. If both extensions aren't installed, the script installs them.
 
-Verify you're using Azure PowerShell module Az version 1.0.0 or later with `Enable-AzureRM` compatibility aliases enabled. Run `Get-Module -ListAvailable Az` to find the version. If you need to upgrade, see [Install Azure PowerShell module](/powershell/azure/install-az-ps). If you're running PowerShell locally, you also need to run `Connect-AzAccount` to create a connection with Azure.
+Verify that you're using Azure PowerShell module Az version 1.0.0 or later with `Enable-AzureRM` compatibility aliases enabled. Run `Get-Module -ListAvailable Az` to find the version. If you need to upgrade, see [Install Azure PowerShell module](/powershell/azure/install-az-ps). If you're running PowerShell locally, you also need to run `Connect-AzAccount` to create a connection with Azure.
 
 To get a list of the script's argument details and example usage, run `Get-Help`.
 
@@ -187,5 +189,5 @@ Failed: (0)
 
 ## Next steps
 
-* See [Use VM insights Map](vminsights-maps.md) to view discovered application dependencies. 
+* See [Use VM insights Map](vminsights-maps.md) to view discovered application dependencies.
 * See [View Azure VM performance](vminsights-performance.md) to identify bottlenecks, overall utilization, and your VM's performance.

articles/azure-monitor/vm/vminsights-performance.md

@@ -34,7 +34,7 @@ To access from Azure Monitor:
 1. In the **Solutions** section, select **Virtual Machines**.
 1. Select the **Performance** tab.
 
-   ![Screenshot that shows a VM insights Performance Top N List view.](media/vminsights-performance/vminsights-performance-aggview-01.png)
+![Screenshot that shows a VM insights Performance Top N List view.](media/vminsights-performance/vminsights-performance-aggview-01.png)
 
 On the **Top N Charts** tab, if you have more than one Log Analytics workspace, select the workspace enabled with the solution from the **Workspace** selector at the top of the page. The **Group** selector returns subscriptions, resource groups, [computer groups](../logs/computer-groups.md), and virtual machine scale sets of computers related to the selected workspace that you can use to further filter results presented in the charts on this page and across the other pages. Your selection only applies to the Performance feature and doesn't carry over to Health or Map.
 
@@ -50,15 +50,15 @@ Five capacity utilization charts are shown on the page:
 
 Selecting the pushpin icon in the upper-right corner of a chart pins it to the last Azure dashboard you viewed. From the dashboard, you can resize and reposition the chart. Selecting the chart from the dashboard redirects you to VM insights and loads the correct scope and view.
 
-Select the icon to the left of the pushpin icon on a chart to open the **Top N List** view. This list view shows the resource utilization for a performance metric by individual VM. It also shows which machine is trending highest.
+Select the icon to the left of the pushpin icon on a chart to open the **Top N List** view. This list view shows the resource utilization for a performance metric by individual VM. It also shows which machine is trending the highest.
 
 ![Screenshot that shows a Top N List view for a selected performance metric.](media/vminsights-performance/vminsights-performance-topnlist-01.png)
 
-When you select the virtual machine, the **Properties** pane opens on the right. It shows properties like system information reported by the operating system and the properties of the Azure VM. Selecting an option under the **Quick Links** section redirects you to that feature directly from the selected VM.
+When you select the virtual machine, the **Properties** pane opens on the right side. It shows properties like system information reported by the operating system and the properties of the Azure VM. Selecting an option under the **Quick Links** section redirects you to that feature directly from the selected VM.
 
 ![Screenshot that shows a virtual machine Properties pane.](./media/vminsights-performance/vminsights-properties-pane-01.png)
 
-Switch to the **Aggregated Charts** tab to view the performance metrics filtered by average or percentiles measured.
+You can switch to the **Aggregated Charts** tab to view the performance metrics filtered by average or percentiles measured.
 
 ![Screenshot that shows a VM insights Performance Aggregate view.](./media/vminsights-performance/vminsights-performance-aggview-02.png)
 
@@ -119,11 +119,11 @@ To access directly from an Azure virtual machine scale set:
 1. From the list, select a VM.
 1. In the **Monitoring** section, select **Insights** to view the **Performance** tab.
 
-This page loads the Azure Monitor performance view scoped to the selected scale set. This view enables you to see the top N instances in the scale set across the set of monitored metrics. You can also view the aggregate performance across the scale set. And you can see the trends for selected metrics across the individual instances in the scale set. Selecting an instance from the list view lets you load its map or move into a detailed performance view for that instance.
+This page loads the Azure Monitor performance view scoped to the selected scale set. This view enables you to see the Top N instances in the scale set across the set of monitored metrics. You can also view the aggregate performance across the scale set. And you can see the trends for selected metrics across the individual instances in the scale set. Selecting an instance from the list view lets you load its map or move into a detailed performance view for that instance.
 
 Selecting the pushpin icon in the upper-right corner of a chart pins it to the last Azure dashboard you viewed. From the dashboard, you can resize and reposition the chart. Selecting the chart from the dashboard redirects you to VM insights and loads the performance detail view for the VM.
 
-![Screenshot that shows VM insights Performance directly from virtual machine scale set view.](./media/vminsights-performance/vminsights-performance-directvmss-01.png)
+![Screenshot that shows VM insights Performance directly from the virtual machine scale set view.](./media/vminsights-performance/vminsights-performance-directvmss-01.png)
 
 >[!NOTE]
 >You can also access a detailed performance view for a specific instance from the **Instances** view for your scale set. Under the **Settings** section, go to **Instances** and select **Insights**.