Skip to content

Commit 282ada0

Browse files
authored
Merge pull request #277936 from ShawnJackson/set-up-alert-rules
[AQ] edit pass: Articles about alert rules
2 parents bd7c42d + d418b33 commit 282ada0

16 files changed

+388
-364
lines changed
Lines changed: 48 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
---
22
title: Create an activity log, service health, or resource health alert rule
3-
description: This article shows you how to create or edit a new activity log, service health, and resource health alert rule.
3+
description: This article shows you how to create or edit an activity log, service health, or resource health alert rule in Azure Monitor.
44
author: AbbyMSFT
55
ms.author: abbyweisberg
66
ms.topic: how-to
77
ms.date: 11/27/2023
88
ms.reviewer: harelbr
99

10-
# 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.
10+
# Customer intent: As an Azure cloud 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.
1111
---
1212

1313
# Create or edit an activity log, service health, or resource health alert rule
1414

15-
This article shows you how to create or edit an activity log, service health, or resource health alert rule. To learn more about alerts, see the [alerts overview](alerts-overview.md).
15+
This article shows you how to create or edit an activity log, service health, or resource health alert rule in Azure Monitor. To learn more about alerts, see the [alerts overview](alerts-overview.md).
1616

1717
You create an alert rule by combining the resources to be monitored, the monitoring data from the resource, and the conditions that you want to trigger the alert. You can then define [action groups](./action-groups.md) and [alert processing rules](alerts-action-rules.md) to determine what happens when an alert is triggered.
1818

@@ -22,88 +22,90 @@ Alerts triggered by these alert rules contain a payload that uses the [common al
2222

2323
### Edit an existing alert rule
2424

25-
1. In the [portal](https://portal.azure.com/), either from the home page or from a specific resource, select **Alerts** from the left pane.
25+
1. In the [Azure portal](https://portal.azure.com/), either from the home page or from a specific resource, select **Alerts** on the left pane.
2626
1. Select **Alert rules**.
2727
1. Select the alert rule you want to edit, and then select **Edit**.
2828

29-
:::image type="content" source="media/alerts-create-activity-log-alert-rule/alerts-edit-activity-log-alert-rule.png" alt-text="Screenshot that shows steps to edit an existing activity log alert rule.":::
29+
:::image type="content" source="media/alerts-create-activity-log-alert-rule/alerts-edit-activity-log-alert-rule.png" alt-text="Screenshot that shows the button for editing an existing activity log alert rule.":::
3030
1. Select any of the tabs for the alert rule to edit the settings.
3131

3232
[!INCLUDE [alerts-wizard-scope](../includes/alerts-wizard-scope.md)]
3333

34-
## Configure the alert rule conditions
34+
## Configure alert rule conditions
3535

36-
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.
36+
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.
3737

38-
:::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.":::
38+
:::image type="content" source="media/alerts-create-new-alert-rule/alerts-popular-signals.png" alt-text="Screenshot that shows popular signals for creating an alert rule.":::
3939

40-
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:
41-
- **Signal type**: The [type of alert rule](alerts-overview.md#types-of-alerts) you're creating.
42-
- **Signal source**: The service sending the signal.
40+
1. (Optional) If you selected **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:
41+
- **Signal type**: The [type of alert rule](alerts-overview.md#types-of-alerts) that you're creating.
42+
- **Signal source**: The service that sends the signal.
4343

44-
This table describes the services available for activity log alert rules:
44+
This table describes the available services for activity log alert rules:
4545

4646
| Signal source | Description |
4747
|--------------------------|-----------------------------------------------------------------|
48-
| Activity log – Policy | The service that provides the Policy activity log events. |
49-
| Activity log – Autoscale | The service that provides the Autoscale activity log events. |
50-
| Activity log – Security | The service that provides the Security activity log events. |
51-
| Resource health | The service that provides the resource-level health status. |
52-
| Service health | The service that provides the subscription-level health status. |
48+
| **Activity log – Policy** | The service that provides the policy-related activity log events. |
49+
| **Activity log – Autoscale** | The service that provides the autoscale-related activity log events. |
50+
| **Activity log – Security** | The service that provides the security-related activity log events. |
51+
| **Resource health** | The service that provides the resource-level health status. |
52+
| **Service health** | The service that provides the subscription-level health status. |
5353

54-
Select the **Signal name** and **Apply**.
54+
Select the signal name, and then select **Apply**.
5555

5656
#### [Activity log alert](#tab/activity-log)
5757

58-
1. On the **Conditions** pane, select the **Chart period**.
59-
1. The **Preview** chart shows you the results of your selection.
60-
1. Select values for each of these fields in the **Alert logic** section:
58+
1. On the **Conditions** pane, select the **Chart period** value.
59+
60+
The **Preview** chart shows the results of your selection.
61+
1. In the **Alert logic** section, select values for each of these fields:
6162

6263
|Field |Description |
6364
|---------|---------|
64-
|Event level| Select the level of the events for this alert rule. Values are **Critical**, **Error**, **Warning**, **Informational**, **Verbose**, and **All**.|
65-
|Status|Select the status levels for the alert.|
66-
|Event initiated by|Select the user or service principal that initiated the event.|
65+
|**Event level**| Select the level of the events for this alert rule. Values are **Critical**, **Error**, **Warning**, **Informational**, **Verbose**, and **All**.|
66+
|**Status**|Select the status levels for the alert.|
67+
|**Event initiated by**|Select the user principal or service principal that initiated the event.|
6768

68-
#### [Resource Health alert](#tab/resource-health)
69+
#### [Resource health alert](#tab/resource-health)
6970

70-
1. On the **Conditions** pane, select values for each of these fields:
71+
- On the **Conditions** pane, select values for each of these fields:
7172

72-
|Field |Description |
73-
|---------|---------|
74-
|Event status| Select the statuses of Resource Health events. Values are **Active**, **In Progress**, **Resolved**, and **Updated**.|
75-
|Current resource status|Select the current resource status. Values are **Available**, **Degraded**, and **Unavailable**.|
76-
|Previous resource status|Select the previous resource status. Values are **Available**, **Degraded**, **Unavailable**, and **Unknown**.|
77-
|Reason type|Select the causes of the Resource Health events. Values are **Platform Initiated**, **Unknown**, and **User Initiated**.|
73+
|Field |Description |
74+
|---------|---------|
75+
|**Event status**| Select the statuses of resource health events. Values are **Active**, **In Progress**, **Resolved**, and **Updated**.|
76+
|**Current resource status**|Select the current resource status. Values are **Available**, **Degraded**, and **Unavailable**.|
77+
|**Previous resource status**|Select the previous resource status. Values are **Available**, **Degraded**, **Unavailable**, and **Unknown**.|
78+
|**Reason type**|Select the causes of the resource health events. Values are **Platform Initiated**, **Unknown**, and **User Initiated**.|
7879

79-
#### [Service Health alert](#tab/service-health)
80+
#### [Service health alert](#tab/service-health)
8081

81-
1. On the **Conditions** pane, select values for each of these fields:
82+
- On the **Conditions** pane, select values for each of these fields:
8283

8384
|Field |Description |
8485
|---------|---------|
85-
|Services| Select the Azure services.|
86-
|Regions|Select the Azure regions.|
87-
|Event types|Select the types of Service Health events. Values are **Service issue**, **Planned maintenance**, **Health advisories**, and **Security advisories**.|
86+
|**Services**| Select the Azure services.|
87+
|**Regions**|Select the Azure regions.|
88+
|**Event types**|Select the types of service health events. Values are **Service issue**, **Planned maintenance**, **Health advisories**, and **Security advisories**.|
8889

8990
---
9091

9192
[!INCLUDE [alerts-wizard-actions](../includes/alerts-wizard-actions.md)]
9293

93-
## Configure the alert rule details
94+
## Configure alert rule details
9495

95-
:::image type="content" source="media/alerts-create-new-alert-rule/alerts-activity-log-rule-details-tab.png" alt-text="Screenshot that shows the Actions tab when creating a new activity log alert rule.":::
96+
1. On the **Details** tab, enter values for **Alert rule name** and **Alert rule description**.
97+
1. Select **Enable alert rule upon creation** for the alert rule to start running as soon as you finish creating it.
98+
1. (Optional) For **Region**, select a region in which your alert rule will be processed. If you need to make sure the rule is processed within the [EU Data Boundary](/privacy/eudb/eu-data-boundary-learn), select the North Europe or West Europe region. In all other cases, you can select the Global region (which is the default).
9699

97-
1. Enter values for the **Alert rule name** and the **Alert rule description**.
98-
1. Select **Enable upon creation** for the alert rule to start running as soon as you're done creating it.
99-
1. (Optional) Select a region in which your alert rule will be processed. If you need to make sure the rule is processed within [EU Data Boundary](/privacy/eudb/eu-data-boundary-learn), select the North Europe or West Europe region. In all other cases you can select the Global region (which is the default).
100+
> [!NOTE]
101+
> Service Health alert rules can only be located in the Global region.
100102
101-
> [!NOTE]
102-
> Service Health alert rules can only be located in the Global region.
103+
:::image type="content" source="media/alerts-create-new-alert-rule/alerts-activity-log-rule-details-tab.png" alt-text="Screenshot that shows the Details tab for creating a new activity log alert rule.":::
103104

104105
1. [!INCLUDE [alerts-wizard-custom=properties](../includes/alerts-wizard-custom-properties.md)]
105106

106107
[!INCLUDE [alerts-wizard-finish](../includes/alerts-wizard-finish.md)]
107108

108-
## Next steps
109-
[View and manage your alert instances](alerts-manage-alert-instances.md)
109+
## Related content
110+
111+
- [View and manage your alert instances](alerts-manage-alert-instances.md)

0 commit comments

Comments
 (0)