Grouping Notifications for an Alarm
Update an alarm in Monitoring to group notifications.
Group notifications when you want alarm-level notifications. Compare to Splitting Notifications for an Alarm.
For alarm troubleshooting, see Troubleshooting Alarms. See also Creating a Basic Alarm.
When to Group Notifications
Following are reasons to group notifications.
- Get alarm-level notifications. No matter how many metric streams are firing at a particular time, receive only one notification.
- Suppress at the level of the alarm. See Suppressing a Single Alarm and Removing a Suppression from a Single Alarm.
You can always view status at the level of the alarm, whether notifications are grouped or split. See Listing Status of Alarms.
Behavior of Grouped Notifications
In the following description of grouped notification behavior, consider an alarm with two trigger rules: a critical trigger rule for 95 percent and a warning trigger rule for 90 percent.
- When many metric streams fire at the same time, then only one (alarm-level) notification is sent.
- When the alarm isn't in firing status, and multiple trigger rules are breached at the same time (such as both the critical 95 percent trigger rule and the warning 90 percent trigger rule), then an alarm-level notification is sent for the highest-priority trigger rule only (such as critical 95 percent).
- On the Alarm Definitions list page, select the alarm that you want to work with. If you need help finding the list page or the alarm, see Listing Alarms.
- Go to Actions and then select Edit alarm.
- In the Message grouping section, select Group notifications across metric streams.
- Select Save alarm.
Use the oci monitoring alarm update command and required parameters to update an alarm to send a message for each metric stream. Set
--is-notifications-per-metric-dimension-enabled
tofalse
.oci monitoring alarm update --is-notifications-per-metric-dimension-enabled false [...]
For a complete list of parameters and values for CLI commands, see the Command Line Reference for Monitoring.
Run the UpdateAlarm operation to update an alarm to send a message for each metric stream.
When defining details for UpdateAlarmDetails, set
isNotificationsPerMetricDimensionEnabled
tofalse
.