Oracle Cloud Infrastructure Documentation

Listing Metric Stream Status in an Alarm

List the status of each metric stream in an alarm in Monitoring. A metric stream corresponds to a set of dimension key-value pairs.

Note

Ensure that the alarm is configured for split notifications (Split notifications per metric stream). Viewing states of metric streams is available only for alarms with this configuration.

Monitoring stops tracking metric streams associated with RESET messages. For more information about message types, see Message Types.

Messages are sent at the time the alarm transitions, either collectively for all metric streams or individually per metric stream. For more information about messages sent, see Message Types. For a scenario using individual messages per metric stream, see Scenario: Split Messages by Metric Stream.

For alarm troubleshooting, see Troubleshooting Alarms.

    1. 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.
    2. Next to Metric streams, select View status.

      Metric streams is shown on details pages only for those alarms that are configured for split notifications (Split notifications per metric stream). Viewing states of metric streams is only available for alarms with this configuration.

    The Metric streams status dialog box is displayed, listing the current state (Firing or OK) for each metric stream that transitioned to another alarm state. The list includes alarm summaries and trigger rules.

    The name of each trigger rule indicates its severity, query, and rule number. The query indicator depends on which mode was used to save the alarm query. If the query was saved in Basic mode, then the query indicator includes the metric namespace, operator, and value (example: oci_computeagent-greater-than-90). If the query was saved in Advanced mode, then the name includes the phrase advanced.

    Example names of trigger rules:

    • Basic mode: Critical-oci_computeagent-greater-than-90-Rule2
    • Advanced mode: Critical-advanced-Rule2

  • Use the oci monitoring alarm-dimension-states-collection retrieve-dimension-states command and required parameters to list status of each metric stream in an alarm:

    oci monitoring alarm-dimension-states-collection retrieve-dimension-states --alarm-id <alarm_OCID>

    For a complete list of parameters and values for CLI commands, see the Command Line Reference for Monitoring.

  • Run the RetrieveDimensionStates operation to list the status of each metric stream in an alarm.