Oracle Cloud Infrastructure Documentation

Listing Status of Alarms

List status levels for alarms in Monitoring.

Note

You can suppress alarms during a given time range. You can also disable and delete alarms.

For information about alarm evaluations for determining alarm status, see Alarm Evaluations.

Optionally filter listed alarms by resource or status value. Filtering is available using the CLI or API.

For alarm troubleshooting, see Troubleshooting Alarms.

Before You Begin

IAM policies: To list status of alarms, you must be given the required type of access in a policy  written by an administrator. This requirement applies whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don't have permission or are unauthorized, check with the administrator. You might not have the required type of access in the current compartment .

Administrators: For an example policy, see List Alarms and Alarm Status.

  • Listing Firing Alarms

    1. Open the navigation menu and click Observability & Management. Under Monitoring, click Alarm Status.
    2. Select the compartment that contains the alarms you want to work with.
      The page lists firing alarms in the selected compartment. Tiles at the top of the page indicate the number of firing alarms for each severity (critical, error, warning, and informational).
    3. (Optional) To filter the list of alarms, select the severity, namespace, resource group, or relative time window that the alarm was triggered (such as the last hour).
    4. (Optional) To customize table columns:
      1. Go to Actions and then select Configure table columns.
      2. To add or remove a column, select its name.
      3. Select Save changes.
      The column configuration is saved, and it persists after refresh.
    5. (Optional) To list the status of metric streams associated with a trigger rule, select the linked number in the Metric streams column.
    6. (Optional) To get details about a firing alarm, select the alarm.

    Listing All Alarms

    1. Open the navigation menu and click Observability & Management. Under Monitoring, click Alarm Definitions.
    2. Select the compartment that contains the alarms you want to work with.
    3. (Optional) To filter the list by alarm status, select a status value from the Status list.
    4. (Optional) To filter the list by tag:
      1. Next to Tag filters, click add.
      2. In the Add a tag filter dialog, enter the following:
        • Tag namespace: Select the tag namespace.
        • Tag key: Select the key.
        • Tag value: Select from the following:
          • Match any value - returns all resources tagged with the selected namespace and key, regardless of the tag value.
          • Specify matching values - returns resources with the tag value you enter in the text box. Enter a single value in the text box. To specify multiple values for the same namespace and key, click + to display another text box. Enter one value per text box.
      3. Click Apply filter.
    5. (Optional) To get details about an alarm, select the alarm.

  • Use the oci monitoring alarm-status list-alarms-status command and required parameters to list status of alarms:

    oci monitoring alarm-status list-alarms-status --compartment-id <compartment_OCID>

    Example command to list status of alarms for a specific resource:

    oci monitoring alarm-status list-alarms-status --compartment-id <compartment_OCID> --resource-id <resource_OCID>

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

  • Run the ListAlarmsStatus operation to list status of alarms.