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. Open the navigation menu and click Observability & Management. Under Monitoring, click Alarm Definitions.
    2. Click the name of the alarm that you want.
    3. On the alarm details page, next to Metric streams, click 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 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.