Splitting Notifications for an Alarm
Update an alarm in Monitoring to split notifications.
Split notifications when you want metric stream-level notifications. Compare to Grouping Notifications for an Alarm.
For alarm troubleshooting, see Troubleshooting Alarms. See also Creating a Basic Alarm.
When to Split Notifications
Following are reasons to split notifications.
- Get a notification for each firing metric stream.
- Suppress at the level of a metric stream. SeeSuppressing a Single Alarm and Removing a Suppression from a Single Alarm.
- View status at the level of a metric stream. See Listing Metric Stream Status in an Alarm.
- You can always view status at the level of the alarm, whether notifications are grouped or split. See Listing Status of Alarms.
For a scenario of split notifications with examples, see Scenario: Split Messages by Metric Stream.
Behavior of Split Notifications
In the following description of split 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 a notification is sent for each firing metric stream and associated trigger rule.
- When the metric stream 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 metric stream-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 Split notifications per metric stream.
- 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-enabledtotrue.oci monitoring alarm update --is-notifications-per-metric-dimension-enabled true [...]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
isNotificationsPerMetricDimensionEnabledtotrue.