Merge pull request #104570 from harelbr/patch-17

Update document

Author: GitHubber17

articles/azure-monitor/platform/alerts-metric.md

@@ -1,16 +1,16 @@
 ---
-title: "Create, view and manage Metric Alerts Using Azure Monitor"
-description: Learn how to use Azure portal or CLI to create, view and manage metric alert rules.
+title: "Create, view, and manage Metric Alerts Using Azure Monitor"
+description: Learn how to use Azure portal or CLI to create, view, and manage metric alert rules.
 author: harelbr
 ms.service: azure-monitor
 ms.topic: conceptual
-ms.date: 09/18/2018
+ms.date: 02/16/2020
 ms.author: harelbr
 ms.subservice: alerts
 ---
 # Create, view, and manage metric alerts using Azure Monitor
 
-Metric alerts in Azure Monitor provide a way to get notified when one of your metrics cross a threshold. Metric alerts work on a range of multi-dimensional platform metrics, custom metrics, Application Insights standard and custom metrics. In this article, we will describe how to create, view and manage metric alert rules through Azure portal and Azure CLI. You can also create metric alert rules using Azure Resource Manager templates which is described in [a separate article](alerts-metric-create-templates.md).
+Metric alerts in Azure Monitor provide a way to get notified when one of your metrics crosses a threshold. Metric alerts work on a range of multi-dimensional platform metrics, custom metrics, Application Insights standard and custom metrics. In this article, we will describe how to create, view, and manage metric alert rules through Azure portal and Azure CLI. You can also create metric alert rules using Azure Resource Manager templates, which are described in [a separate article](alerts-metric-create-templates.md).
 
 You can learn more about how metric alerts work from [metric alerts overview](alerts-metric-overview.md).
 
@@ -33,21 +33,30 @@ The following procedure describes how to create a metric alert rule in Azure por
 
 6. You will see a list of signals supported for the resource, select the metric you want to create an alert on.
 
-7. Optionally, refine the metric by adjusting **Period** and **Aggregation**. If the metric has dimensions, you will see **Dimensions** table presented. Select one or more values per dimension. The metric alert will run evaluate the condition for all combinations of values selected. [Learn more about how alerting on multi-dimensional metrics works](alerts-metric-overview.md). You can also **Select \*** for any of the dimensions. **Select \*** will dynamically scale the selection to all current and future values for a dimension.
+7. You will see a chart for the metric for the last six hours. Use the **Chart period** dropdown to select to see longer history for the metric.
 
-8. You will see a chart for the metric for the last 6 hours. Define the alert parameters; **Condition Type**, **Frequency**, **Operator** and **Threshold** or **Sensitivity**, this will determine the logic which the metric alert rule will evaluate. [Learn more about Dynamic Thresholds condition type and sensitivity options](alerts-dynamic-thresholds.md).
+8. If the metric has dimensions, you will see a dimensions table presented. Select one or more values per dimension.
+    - The displayed dimension values are based on metric data from the last three days.
+    - If the dimension value you're looking for isn't displayed, click "+" to add a custom value.
+    - You can also **Select \*** for any of the dimensions. **Select \*** will dynamically scale the selection to all current and future values for a dimension.
 
-9. If you are using a static threshold, the metric chart can help determine what might be a reasonable threshold. If you are using a Dynamic Thresholds, the metric chart will display the calculated thresholds based on recent data.
+    The metric alert rule will evaluate the condition for all combinations of values selected. [Learn more about how alerting on multi-dimensional metrics works](alerts-metric-overview.md).
 
-10. Click **Done**
+9. Select the **Threshold** type, **Operator**, and **Aggregation type**. This will determine the logic that the metric alert rule will evaluate.
+    - If you are using a **Static** threshold, continue to define a **Threshold value**. The metric chart can help determine what might be a reasonable threshold.
+    - If you are using a **Dynamic** threshold, continue to define the **Threshold sensitivity**. The metric chart will display the calculated thresholds based on recent data. [Learn more about Dynamic Thresholds condition type and sensitivity options](alerts-dynamic-thresholds.md).
 
-11. Optionally, add another criteria if you want to monitor a complex alert rule. Currently users can have alert rules with Dynamic Thresholds criteria as a single criterion.
+10. Optionally, refine the condition by adjusting **Aggregation granularity** and **Frequency of evaluation**. 
 
-12. Fill in **Alert details** like **Alert Rule Name**, **Description** and **Severity**
+11. Click **Done**.
 
-13. Add an action group to the alert either by selecting an existing action group or creating a new action group.
+12. Optionally, add another criteria if you want to monitor a complex alert rule. Currently users can have alert rules with Dynamic Thresholds criteria as a single criterion.
 
-14. Click **Done** to save the metric alert rule.
+13. Fill in **Alert details** like **Alert rule name**, **Description**, and **Severity**.
+
+14. Add an action group to the alert either by selecting an existing action group or creating a new action group.
+
+15. Click **Done** to save the metric alert rule.
 
 > [!NOTE]
 > Metric alert rules created through portal are created in the same resource group as the target resource.
@@ -60,7 +69,7 @@ You can view and manage metric alert rules using the Manage Rules blade under Al
 
 2. Click on **Alerts** and **Manage rules**
 
-3. In the **Manage rules** blade, you can view all your alert rules across subscriptions. You can further filter the rules using  **Resource group**,  **Resource type** and **Resource**. If you want to see only metric alerts, select **Signal type** as Metrics.
+3. In the **Manage rules** blade, you can view all your alert rules across subscriptions. You can further filter the rules using  **Resource group**, **Resource type**, and **Resource**. If you want to see only metric alerts, select **Signal type** as Metrics.
 
     > [!TIP]
     > In the **Manage rules** blade, you can select multiple alert rules and enable/disable them. This might be useful when certain target resources need to be put under maintenance
@@ -76,11 +85,11 @@ You can view and manage metric alert rules using the Manage Rules blade under Al
 
 ## With Azure CLI
 
-The previous sections described how to create, view and manage metric alert rules using Azure portal. This section will describe how to do the same using cross-platform [Azure CLI](https://docs.microsoft.com/cli/azure/get-started-with-azure-cli?view=azure-cli-latest). Quickest way to start using Azure CLI is through [Azure Cloud Shell](https://docs.microsoft.com/azure/cloud-shell/overview?view=azure-cli-latest). For this article, we will use Cloud shell.
+The previous sections described how to create, view, and manage metric alert rules using Azure portal. This section will describe how to do the same using cross-platform [Azure CLI](https://docs.microsoft.com/cli/azure/get-started-with-azure-cli?view=azure-cli-latest). Quickest way to start using Azure CLI is through [Azure Cloud Shell](https://docs.microsoft.com/azure/cloud-shell/overview?view=azure-cli-latest). For this article, we will use Cloud Shell.
 
-1. Go to Azure portal, click on **Cloud shell**.
+1. Go to Azure portal, click on **Cloud Shell**.
 
-2. At the prompt, you can use commands with ``--help`` option to learn more about the command and how to use it. For example, the following command shows you the list of commands available for creating, viewing and managing metric alerts
+2. At the prompt, you can use commands with ``--help`` option to learn more about the command and how to use it. For example, the following command shows you the list of commands available for creating, viewing, and managing metric alerts
 
     ```azurecli
     az monitor metrics alert --help