Second pass

Author: cdpark

articles/virtual-machines/flash-azure-monitor.md

@@ -22,7 +22,7 @@ For documentation specific to the other solutions offered by Flash, choose from
 
 ## Azure monitor - VM availability metric
 
-Currently in public preview. It's well-suited for tracking trends, aggregating platform metrics (such as CPU and disk usage) and configuring precise threshold-based alerts. Customers can utilize this out-of-the-box [VM availability metric](../azure-monitor/platform/alerts-overview.md) in [Azure Monitor](../azure-monitor/platform/alerts-overview.md). This metric displays the trend of VM availability over time, so users can:
+Currently in public preview. The VM availability metric is well-suited for tracking trends, aggregating platform metrics (such as CPU and disk usage), and configuring precise threshold-based alerts. Customers can utilize this out-of-the-box [VM availability metric](monitor-vm-reference.md#vm-availability-metric-preview) in [Azure Monitor](../azure-monitor/platform/alerts-overview.md). This metric displays the trend of VM availability over time, so users can:
 
 - Set up [threshold-based metric alerts](../azure-monitor/alerts/alerts-create-new-alert-rule.md?tabs=metric) on dipping VM availability to quickly trigger appropriate mitigation actions.
 - Correlate the VM availability metric with existing [platform metrics](../azure-monitor/essentials/data-platform-metrics.md) like memory, network, or disk for deeper insights into concerning changes that impact the overall performance of workloads.
@@ -37,21 +37,11 @@ Once on the Azure portal, navigate to the VM overview blade. The new metric is d
 
    :::image type="content" source="media/flash/virtual-machine-availability-metric.png" alt-text="Screenshot of virtual machine availability metric on a virtual machine's overview page on the Azure portal." lightbox="media/flash/virtual-machine-availability-metric.png" :::
 
-Select (single click) the VM availability metric chart on the overview page, to navigate to [Metrics Explorer](../azure-monitor/essentials/metrics-getting-started.md) for further analysis.
-Select the VM availability metric chart on the overview page, to navigate to [Metrics Explorer](../azure-monitor/essentials/metrics-getting-started.md) for further analysis.
+To navigate to the [metrics explorer](../azure-monitor/essentials/metrics-getting-started.md) for further analysis, select the VM availability metric chart on the overview page.
 
    :::image type="content" source="media/flash/metrics-explorer-virtual-machine-availability.png" alt-text="Screenshot of the newly added VM availability Metric on Metrics Explorer on Azure portal." lightbox="media/flash/metrics-explorer-virtual-machine-availability.png" :::
 
-### Metric description
-
-| **Display Name** | **VM Availability (preview)** |
-| --- | --- |
-| Metric Values | 1 during expected behavior; corresponds to VM in Available state. 0 when VM is impacted by rebootful disruptions; corresponds to VM in Unavailable state. NULL (shows a dotted or dashed line on charts) when the Azure service that is emitting the metric is down or is unaware of the exact status of the VM; corresponds to VM in Unknown state. |
-| Aggregation | The default aggregation of the metric is Average, for prioritized investigations based on extent of downtime incurred. The other aggregations available are: Min, to immediately pinpoint to all the times where VM was unavailable. Max, to immediately pinpoint to all the instances where VM was Available. For more information on chart range, granularity, and data aggregation, see [Azure Monitor Metrics aggregation and display explained](../azure-monitor/essentials/metrics-aggregation-explained.md). |
-| Data Retention | Data for the VM availability metric is [stored for 93 days](../azure-monitor/essentials/data-platform-metrics.md#retention-of-metrics) to help trend analysis and historical lookback. |
-| Pricing | Refer to the [Pricing breakdown](https://azure.microsoft.com/pricing/details/monitor/#pricing), specifically in the "Metrics" and "Alert Rules" sections. |
-
-We plan to include impact details (user vs platform initiated, planned vs unplanned) as dimensions to the metric, so users are well equipped to interpret dips, and set up much more targeted metric alerts. With the emission of dimensions in 2023, we also anticipate transitioning the offering to a general availability status.
+For a description of the metric's display values, see [VM availability metric](monitor-vm-reference.md#vm-availability-metric-preview).
 
 ### Useful links
 

articles/virtual-machines/linux/metrics-vm-usage-rest.md

@@ -21,7 +21,7 @@ Complete reference documentation and samples for the REST API are available in t
 
 ## Build the request
 
-Use the following GET request to collect the [Percentage CPU metric](../../azure-monitor/essentials/metrics-supported.md#microsoftcomputevirtualmachines) from a Virtual Machine
+Use the following GET request to collect the [Percentage CPU metric](../monitor-vm-reference.md#supported-metrics-for-microsoftcomputevirtualmachines) from a virtual machine.
 
 ```http
 GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU&timespan=2018-06-05T03:00:00Z/2018-06-07T03:00:00Z

articles/virtual-machines/monitor-vm-reference.md

@@ -26,14 +26,22 @@ The following table lists the metrics available for the Microsoft.Compute/virtua
 [!INCLUDE [horz-monitor-ref-metrics-tableheader](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-tableheader.md)]
 [!INCLUDE [Microsoft.Compute/virtualMachines](~/azure-reference-other-repo/azure-monitor-ref/supported-metrics/includes/microsoft-compute-virtualmachines-metrics-include.md)]
 
+For an example that shows how to collect the *Percentage CPU* metric from a VM, see [Get virtual machine usage metrics using the REST API](linux/metrics-vm-usage-rest.md).
+
 ### VM availability metric (preview)
-The VM availability metric is currently in public preview. This metric value indicates whether a machine is currently running and available. You can use the metric to trend availability over time and to alert if the machine is stopped. VM availability has the values in the following table.
+The VM availability metric is currently in public preview. This metric value indicates whether a machine is currently running and available. You can use the metric to trend availability over time and to alert if the machine is stopped. VM availability displays the following values.
 
 | Value | Description |
 |:---|:---|
-| 1 | VM is running and available. | 
+| 1 | VM is running and available. |
 | 0 | VM is unavailable. The VM could be stopped or rebooting. If you shut down a VM from within the VM, it emits this value. |
-| Null | State of the VM is unknown. If you stop a VM from the Azure portal, CLI, or PowerShell, it immediately stops emitting the availability metric, and you see null values. |
+| Null (dashed line) | State of the VM is unknown. If you stop a VM from the Azure portal, CLI, or PowerShell, it immediately stops emitting the availability metric, and you see null values. |
+
+| Display name | Description |
+| --- | --- |
+| Aggregation | *Average* (default aggregation): for prioritized investigations based on extent of downtime incurred. <br><br>*Min*: immediately pinpoints all the times where the VM was unavailable. <br><br>*Max*: immediately pinpoints all the instances where the VM was available. <br><br>For more information on chart range, granularity, and data aggregation, see [Azure Monitor metrics aggregation and display explained](../azure-monitor/essentials/metrics-aggregation-explained.md). |
+| Data retention | Data for the VM availability metric is [stored for 93 days](../azure-monitor/essentials/data-platform-metrics.md#retention-of-metrics) to help trend analysis and historical lookback. |
+| Pricing | Refer to the [Pricing breakdown](https://azure.microsoft.com/pricing/details/monitor/#pricing), specifically in the *Metrics* and *Alert Rules* sections. |
 
 To learn how to use the VM availability metric to monitor Azure Virtual Machine availability, see [Use Azure Monitor to monitor Azure Virtual Machine availability](flash-azure-monitor.md).
 

articles/virtual-machines/monitor-vm.md

@@ -62,6 +62,8 @@ For a tutorial on enabling VM insights for a virtual machine, see [Enable monito
 
 If you enable VM insights, the Azure Monitor agent is installed and starts sending a predefined set of performance data to Azure Monitor Logs. You can create other data collection rules to collect events and other performance data. To learn how to install the Azure Monitor agent and create a data collection rule (DCR) that defines the data to collect, see [Tutorial: Collect guest logs and metrics from an Azure virtual machine](/azure/azure-monitor/vm/tutorial-monitor-vm-guest).
 
+In VM insights, you can use the Azure Monitor Map feature to view application components that run in Azure or your environment. The Dependency agent VM extension is available for [Windows](extensions/agent-dependency-windows.md) and [Linux](extensions/agent-dependency-linux.md).
+
 [!INCLUDE [horz-monitor-data-storage](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-data-storage.md)]
 
 [!INCLUDE [horz-monitor-platform-metrics](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-platform-metrics.md)]