Merge pull request #273933 from RoseHJM/dtl-alerts-freshness

DTL - Create alerts freshness pass

Author: Jill Grant

articles/devtest-labs/create-alerts.md

@@ -1,79 +1,97 @@
 ---
 title: Create activity log alerts for labs
-description: This article provides steps to create activity log alerts for lab in Azure DevTest Labs.
+description: Learn how to create activity log alerts and configure alert rules for labs in Azure DevTest Labs.
 ms.topic: how-to
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 07/10/2020
+ms.date: 04/30/2024
 ms.custom: UpdateFrequency2
+
+#customer intent: As a lab administrator, I want to create activity log alerts for labs in Azure DevTest Labs, so that I can respond to issues quickly.
 ---
 
 # Create activity log alerts for labs in Azure DevTest Labs
-This article explains how to create activity log alerts for labs in Azure DevTest Labs (for example: when a VM is created or when a VM is deleted).
+This article explains how to create activity log alerts for labs in Azure DevTest Labs (for example: when a virtual machine is created or deleted).
+
+## Create an alert
 
-## Create alerts
 In this example, you create an alert for all administrative operations on a lab with an action that sends an email to subscription owners. 
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
-1. In the search bar of the Azure portal, type **Monitor**, and then select **Monitor** from the results list. 
 
-    :::image type="content" source="./media/activity-logs/search-monitor.png" alt-text="Search for Monitor":::        
-1. Select **Alerts** on the left menu, and then select **New alert rule** on the toolbar. 
+1. In the Azure portal search bar, enter *Monitor*, and then select **Monitor** from the results list. 
+
+    :::image type="content" source="./media/create-alerts/search-monitor.png" alt-text="Screenshot of the Azure portal, showing a search for Monitor." lightbox="./media/create-alerts/search-monitor.png":::        
+
+1. Select **Alerts** on the left menu, and then select **Create** > **Alert rule**. 
+
+    :::image type="content" source="./media/create-alerts/alerts-page.png" alt-text="Screenshot showing the Azure Monitor alerts page with Create Alert rule highlighted." lightbox="./media/create-alerts/alerts-page.png":::    
+
+1. On the **Create alert rule** page, in **Select a resource**, from the **Resource types** list, select **DevTest Labs**. 
+
+    :::image type="content" source="./media/create-alerts/select-resource-link.png" alt-text="Screenshot showing the Select a resource pane, with the Resource type set to DevTest Labs." lightbox="./media/create-alerts/select-resource-link.png":::        
 
-    :::image type="content" source="./media/activity-logs/alerts-page.png" alt-text="Alerts page":::    
-1. On the **Create alert rule** page, click **Select resource**. 
+1. Expand your resource group, select your lab in the list, and then select **Apply**.
 
-    :::image type="content" source="./media/activity-logs/select-resource-link.png" alt-text="Select resource for the alert":::        
-1. Select **DevTest Labs** for **Filter by resource type**, select your lab in the list, and then select **Done**.
+    :::image type="content" source="./media/create-alerts/select-lab-resource.png" alt-text="Screenshot showing the Select a resource pane, with a lab selected." lightbox="./media/create-alerts/select-lab-resource.png":::
 
-    :::image type="content" source="./media/activity-logs/select-lab-resource.png" alt-text="Select your lab as the resource":::
-1. Back on the **Create alert rule** page, click **Select condition**. 
+1. Back on the **Create alert rule** page, select **Next: Condition**. 
 
-    :::image type="content" source="./media/activity-logs/select-condition-link.png" alt-text="Select condition link":::    
-1. On the **Configure signal logic** page, select a signal supported by DevTest Labs. 
+1. On the **Condition** tab, select **See all signals**. 
 
-    :::image type="content" source="./media/activity-logs/select-signal.png" alt-text="Select signal":::
-1. Filter by **event level** (Verbose, Informational, Warning, Error, Critical, All), **status** (Failed, Started, Succeeded), and **who initiated** the event. 
-1. Select **Done** to complete configuring the condition. 
+    :::image type="content" source="./media/create-alerts/see-all-signals-link.png" alt-text="Screenshot of the Condition tab, with the See all signals link highlighted." lightbox="./media/create-alerts/see-all-signals-link.png":::       
 
-    :::image type="content" source="./media/activity-logs/configure-signal-logic-done.png" alt-text="Configure signal logic - done":::
-1. You have specified for the scope (lab) and the condition for the alert. Now, you need to specify an action group with actions to be run when the condition is met. Back on the **Create alert rule** page, choose **Select action group**. 
+1. On the **Select a signal** pane, select **All Administrative operations**, and then select **Apply**. 
 
-    :::image type="content" source="./media/activity-logs/select-action-group-link.png" alt-text="Select action group link":::
-1. Select **Create action group** link on the toolbar. 
+    :::image type="content" source="./media/create-alerts/all-administrative-operations.png" alt-text="Screenshot of the Select a signal pane, with All Administrative operations highlighted." lightbox="./media/create-alerts/all-administrative-operations.png":::
 
-    :::image type="content" source="./media/activity-logs/create-action-group-link.png" alt-text="Create action group link":::
-1. On the **Add action group** page, follow these steps:
-    1. Enter a **name** for the action group.
-    1. Enter a **short name** for the action group. 
-    1. Select the **resource group** in which you want the alert to be created. 
-    1. Enter a **name for the action**. 
-    1. Select the **action type** (in this example, **Email Azure Resource Manager Role**). 
+1. Select **Next: Actions**.
 
-        :::image type="content" source="./media/activity-logs/add-action-group.png" alt-text="Add action group page":::
-    1. On the **Email Azure Resource Manager Role** page, select the role. In this example, it's **Owner**. Then, select **OK**. 
+1. On the **Actions** tab, ensure **Use quick actions (preview)** is selected.
+ 
+1. On the **Use quick actions (preview)** pane, enter or select the following information, and then select **Save**.
+  
+   |Name |Value  |
+   |---------|---------|
+   |Action group name     |Enter an action group name that is unique within the resource group         |
+   |Display name     |Enter a display name to be shown as the action group name in email and SMS notifications.         |
+   |Email     | Enter an email address to receive alerts.         |
+   |Email Azure Resource Manager Role     | Select an Azure Resource Manager role to receive alerts.         |
+   |Azure mobile app notification    | Get a push notification on the Azure mobile app.        |
+ 
+   :::image type="content" source="./media/create-alerts/quick-actions-preview.png" alt-text="Screenshot showing the Use quick actions (preview) pane." lightbox="./media/create-alerts/quick-actions-preview.png":::
 
-        :::image type="content" source="./media/activity-logs/select-role.png" alt-text="Select role":::            
-    1. Select **OK** on the **Add action group** page. 
-1. Now, on the **Create alert rule** page, enter a name for the alert rule, and then select **OK**. 
+1. On the **Create an alert rule** page, enter a name for the alert rule, and then select **Review + create**.
+
+    :::image type="content" source="./media/create-alerts/details-alert-name.png" alt-text="Screenshot showing the Create an alert rule tab, with Alert rule name highlighted." lightbox="./media/create-alerts/details-alert-name.png"::: 
+ 
+1. On the **Review + create** tab, review the settings, and then select **Create**.
+
+    :::image type="content" source="./media/create-alerts/alert-review-create.png" alt-text="Screenshot showing the Review and create tab, with Create highlighted." lightbox="./media/create-alerts/alert-review-create.png":::
 
-    :::image type="content" source="./media/activity-logs/create-alert-rule-done.png" alt-text="Create alert rule - done":::
 
 ## View alerts 
-1. You will see alerts on the **Alerts** for all administrative operations (in this example). Alerts may take sometime to show up. 
 
-    :::image type="content" source="./media/activity-logs/alerts.png" alt-text="Screen capture displays alerts in the Dashboard.":::
-1. If you select number in a column (for example: **Total alerts**), you see the alerts that were raised. 
+1. You see alerts on the **Alerts** for all administrative operations (in this example). Alerts can take sometime to show up. 
+
+    :::image type="content" source="./media/create-alerts/alerts.png" alt-text="Screenshot showing the Alerts page with the full list of alerts." lightbox="./media/create-alerts/alerts.png":::
+
+1. To view all alerts of a specific severity, select the number in the relevant column (for example: **Warning**). 
+
+    :::image type="content" source="./media/create-alerts/select-type-alert.png" alt-text="Screenshot showing the Alerts page with the Warning column heading highlighted." lightbox="./media/create-alerts/select-type-alert.png":::
+
+1. To view the details of an alert, select the alert. 
+
+    :::image type="content" source="./media/create-alerts/select-alert.png" alt-text="Screenshot showing the Alerts page with the full list of alerts and one alert name highlighted." lightbox="./media/create-alerts/select-alert.png":::
+ 
+1. You see a details pane like the following screenshot: 
 
-    :::image type="content" source="./media/activity-logs/all-alerts.png" alt-text="All alerts":::
-1. If you select an alert, you see details about it. 
+    :::image type="content" source="./media/create-alerts/alert-details.png" alt-text="Screenshot showing the alert details." lightbox="./media/create-alerts/alert-details.png":::
 
-    :::image type="content" source="./media/activity-logs/alert-details.png" alt-text="Alert details":::
-1. In this example, you also receive an email with content as shown in the following example: 
+1. If you configured the alert to send an email notification, you  receive an email that contains a summary of the error and a link to view the alert. 
 
-    :::image type="content" source="./media/activity-logs/alert-email.png" alt-text="Alert email":::
+## Related content
 
-## Next steps
 - To learn more about creating action groups using different action types, see [Create and manage action groups in the Azure portal](../azure-monitor/alerts/action-groups.md).
 - To learn more about activity logs, see  [Azure Activity Log](../azure-monitor/essentials/activity-log.md).
 - To learn about setting alerts on activity logs, see [Alerts on activity log](../azure-monitor/alerts/activity-log-alerts.md).