Skip to content

Commit 17e512b

Browse files
Update alerts-action-rules.md
1 parent 78b6a2c commit 17e512b

File tree

1 file changed

+9
-6
lines changed

1 file changed

+9
-6
lines changed

articles/azure-monitor/platform/alerts-action-rules.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -12,16 +12,19 @@ ms.component: alerts
1212

1313
# Action rules (preview)
1414

15-
This article describes what action rules are, and how to configure and manage them.
15+
Action rules allow you to define actions (or suppression of actions) at any Resource Manager scope (Subscription, Resource Group, or Resource). They have a variety of filters that allow you to narrow down to the specific subset of alert instances that you want to act on.
1616

17-
## What are action rules?
17+
## Why and when should you use action rules?
1818

19-
Action rules allow you to define actions (or suppression of actions) at any Resource Manager scope (Subscription, Resource Group, or Resource). They have a variety of filters that allow you to narrow down to the specific subset of alert instances that you want to act on.
19+
### Suppression of alerts
20+
21+
There are often many scenarios where it would be useful to suppress the notifications generated by alerts, which could range from suppression during a planned maintenance window to suppression during non-business hours. For example, the team responsible for 'ContosoVM' wants to suppress alert notifications for the upcoming weekend since 'ContosoVM' is undergoing a planned maintenance. While they can disable each and every alert rule configured on 'ContosoVM' manually (and re-enable it post the maintenance), it is not a simple experience. Action rules allow you to define alert suppression at scale with the ability to flexibly configure the period of suppression. Going back to the previous example, the team can now define one action rule on 'ContosoVM' that will suppress all alert notifications for the weekend.
22+
23+
24+
### Actions at scale
2025

21-
With action rules you can:
26+
Although alert rules allow you to define the action group that triggers when the alert is generated, customers often tend to have a common action group across their scope of operations. For example, a team responsible for the resource group 'ContosoRG' will probably define the same action group for all alert rules defined within 'ContosoRG'. Action rules allow you to simplify this process by allowing you to define actions at scale, so that an action group can be triggered for any alert generated on the configured scope. Going back to the previous example, the team can now define one action rule on 'ContosoRG' that will trigger the same action group for all alerts generated within it.
2227

23-
* Suppress actions and notifications if you have planned maintenance windows or for the weekend/holidays, instead of having to disable each alert rule individually.
24-
* Define actions and notifications at scale: Instead of having to define an action group individually for each alert rule, you can now define an action group to trigger for alerts generated at any scope. For example, I can choose to have action group 'ContosoActionGroup' trigger for every alert generated within my subscription.
2528

2629
## Configuring an action rule
2730

0 commit comments

Comments
 (0)