Merge pull request #269652 from AbbyMSFT/alert-fixes

Alert rule history and dimension operators

Author: v-dirichards

articles/azure-monitor/alerts/alerts-create-activity-log-alert-rule.md

@@ -1,11 +1,13 @@
 ---
-title: Create or edit an activity log, service health, or resource health alert rule
-description: This article shows you how to create a new activity log, service health, and resource health alert rule.
+title: Create an activity log, service health, or resource health alert rule
+description: This article shows you how to create or edit a new activity log, service health, and resource health alert rule.
 author: AbbyMSFT
 ms.author: abbyweisberg
 ms.topic: how-to
 ms.date: 11/27/2023
 ms.reviewer: harelbr
+
+# Customer intent: As an cloud Azure administrator, I want to create a new log search alert rule so that I can use a log search query to monitor the performance and availability of my resources.
 ---
 
 # Create or edit an activity log, service health, or resource health alert rule
@@ -31,7 +33,7 @@ Alerts triggered by these alert rules contain a payload that uses the [common al
 
 ## Configure the alert rule conditions
 
-1. On the **Condition** tab, when you select the **Signal name** field, the most commonly used signals are displayed in the drop-down list. Select one of these popular signals, or select **See all signals** if you want to choose a different signal for the condition.
+1. On the **Condition** tab, select **Activity log**, **Resource health**, or **Service health**, or select **See all signals** if you want to choose a different signal for the condition.
 
     :::image type="content" source="media/alerts-create-new-alert-rule/alerts-popular-signals.png" alt-text="Screenshot that shows popular signals when creating an alert rule.":::
 

articles/azure-monitor/alerts/alerts-create-log-alert-rule.md

@@ -31,12 +31,10 @@ Alerts triggered by these alert rules contain a payload that uses the [common al
 
 ## Configure the alert rule conditions
 
-1. On the **Condition** tab, when you select the **Signal name** field, the most commonly used signals are displayed in the drop-down list. Select one of these popular signals, or select **See all signals** if you want to choose a different signal for the condition.
-
-    :::image type="content" source="media/alerts-create-new-alert-rule/alerts-popular-signals.png" alt-text="Screenshot that shows popular signals when creating an alert rule.":::
+1. On the **Condition** tab, when you select the **Signal name** field, select **Custom log search**, or select **See all signals** if you want to choose a different signal for the condition.
 
 1. (Optional) If you chose to **See all signals** in the previous step, use the **Select a signal** pane to search for the signal name or filter the list of signals. Filter by:
-    - **Signal type**: The [type of alert rule](alerts-overview.md#types-of-alerts) you're creating.
+    - **Signal type**: Select **Log search**.
     - **Signal source**: The service that sends the "Custom log search" and "Log (saved query)" signals.
     Select the **Signal name** and **Apply**.
 

articles/azure-monitor/alerts/alerts-create-metric-alert-rule.md

@@ -1,11 +1,13 @@
 ---
 title: Create Azure Monitor metric alert rules
-description: This article shows you how to create a new metric alert rule.
+description: This article shows you how to create or edit an Azure Monitor metric alert rule.
 author: AbbyMSFT
 ms.author: abbyweisberg
 ms.topic: how-to
 ms.date: 03/07/2024
 ms.reviewer: harelbr
+
+# Customer intent: As an cloud Azure administrator, I want to create a new metric alert rule so that I can monitor the performance and availability of my resources.
 ---
 
 # Create or edit a metric alert rule
@@ -70,7 +72,7 @@ To create a metric alert rule, you must have the following permissions:
     |Field |Description |
     |---------|---------|
     |Threshold|Select if the threshold should be evaluated based on a static value or a dynamic value.<br>A **static threshold** evaluates the rule by using the threshold value that you configure.<br>**Dynamic thresholds** use machine learning algorithms to continuously learn the metric behavior patterns and calculate the appropriate thresholds for unexpected behavior. You can learn more about using [dynamic thresholds for metric alerts](alerts-types.md#apply-advanced-machine-learning-with-dynamic-thresholds). |
-    |Operator|Select the operator for comparing the metric value against the threshold. <br>If you're using dynamic thresholds, alert rules can use tailored thresholds based on metric behavior for both upper and lower bounds in the same alert rule. Select one of these operators: <br> - Greater than the upper threshold or lower than the lower threshold (default) <br> - Greater than the upper threshold <br> - Lower than the lower threshold|
+    |Operator|Select the operator for comparing the metric value against the threshold. <br>If you're using static thresholds, select one of these operators: <br> - Greater than <br> - Greater than or equal to <br> - Less than <br> - Less than or equal to<br>If you're using dynamic thresholds, alert rules can use tailored thresholds based on metric behavior for both upper and lower bounds in the same alert rule. Select one of these operators: <br> - Greater than the upper threshold or lower than the lower threshold (default) <br> - Greater than the upper threshold <br> - Less than the lower threshold|
     |Aggregation type|Select the aggregation function to apply on the data points: Sum, Count, Average, Min, or Max.|
     |Threshold value|If you selected a **static** threshold, enter the threshold value for the condition logic.|
     |Unit|If the selected metric signal supports different units, such as bytes, KB, MB, and GB, and if you selected a **static** threshold, enter the unit for the condition logic.|
@@ -87,7 +89,7 @@ To create a metric alert rule, you must have the following permissions:
     |Field  |Description  |
     |---------|---------|
     |Dimension name|Dimensions can be either number or string columns. Dimensions are used to monitor specific time series and provide context to a fired alert.<br>Splitting on the **Azure Resource ID** column makes the specified resource into the alert target. If detected, the **ResourceID** column is selected automatically and changes the context of the fired alert to the record's resource.|
-    |Operator|The operator used on the dimension name and value.|
+    |Operator|The operator used on the dimension name and value. Select from these values:<br> - Equals <br> - Is not equal to <br> - Starts with|
     |Dimension values|The dimension values are based on data from the last 48 hours. Select **Add custom value** to add custom dimension values.|
     |Include all future values| Select this field to include any future values added to the selected dimension.|
 

articles/azure-monitor/alerts/alerts-manage-alert-rules.md

@@ -1,12 +1,14 @@
 ---
 title: Manage your alert rules
-description: Manage your alert rules in the Azure portal, or using the CLI or PowerShell.
+description: Manage your alert rules in the Azure portal, or using the CLI or PowerShell.Learn how to enable recommended alert rules.
 author: AbbyMSFT
 ms.author: abbyweisberg
 ms.topic: how-to
 ms.custom: devx-track-azurecli
 ms.date: 01/14/2024
 ms.reviewer: harelbr
+
+# Customer intent: As a cloud administrator, I want to manage my alert rules so that I can ensure that my resources are monitored effectively.
 ---
 
 # Manage your alert rules
@@ -18,7 +20,7 @@ Manage your alert rules in the Azure portal, or using the CLI or PowerShell.
 1. In the [portal](https://portal.azure.com/), select **Monitor**, then **Alerts**.
 1. From the top command bar, select **Alert rules**. The page shows all your alert rules on all subscriptions.
 
-    :::image type="content" source="media/alerts-managing-alert-instances/alerts-rules-page.png" alt-text="Screenshot of alerts rules page.":::
+    :::image type="content" source="media/alerts-managing-alert-instances/alerts-rules-page.png" alt-text="Screenshot that shows the alerts rules page.":::
 
 1. You can filter the list of rules using the available filters:
     - Subscription
@@ -39,7 +41,7 @@ Manage your alert rules in the Azure portal, or using the CLI or PowerShell.
 1. If you select multiple alert rules, you can enable or disable the selected rules. Selecting multiple rules can be useful when you want to perform maintenance on specific resources. 
 1. If you select a single alert rule, you can edit, disable, duplicate, or delete the rule in the alert rule pane.
 
-    :::image type="content" source="media/alerts-managing-alert-instances/alerts-rules-pane.png" alt-text="Screenshot of alerts rules pane.":::
+    :::image type="content" source="media/alerts-managing-alert-instances/alerts-rules-pane.png" alt-text="Screenshot that shows the alerts rules pane.":::
 
 1. To edit an alert rule, select **Edit**, and then edit any of the fields in the following sections. You can't edit the **Alert Rule Name**, or the **Signal type** of an existing alert rule.
     - **Scope**. You can edit the scope for all alert rules **other than**:
@@ -86,6 +88,20 @@ To enable recommended alert rules:
 1. Select **Use an existing action group**, and enter the details of the existing action group if you want to use an action group that already exists.
 1. Select **Save**.
 
+## See the history of when an alert rule triggered
+
+To see the history of an alert rule, you must have a role with read permissions on the subscription containing the resource on which the alert fired.
+
+1. In the [portal](https://portal.azure.com/), select **Monitor**, then **Alerts**.
+1. From the top command bar, select **Alert rules**. The page shows all your alert rules on all subscriptions.
+
+    :::image type="content" source="media/alerts-managing-alert-instances/alerts-rules-page.png" alt-text="Screenshot that shows the alerts rules page.":::
+
+1. Select an alert rule, and then select **History** on the left pane to see the history of when the alert rule triggered.
+
+    :::image type="content" source="media/alerts-manage-alert-rules/alert-rule-history.png" alt-text="Screenshot that shows the history button from the alerts rule page." lightbox="media/alerts-manage-alert-rules/alert-rule-history.png":::
+
+
 ## Manage metric alert rules with the Azure CLI
 
 This section describes how to manage metric alert rules using the cross-platform [Azure CLI](/cli/azure/get-started-with-azure-cli). The following examples use [Azure Cloud Shell](../../cloud-shell/overview.md).