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. Under List Scope, select a compartment that you have permission to work in.

      For the selected compartment, the page lists firing alarms. 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 the Actions menu (Actions Menu) and then select Configure table columns.
      2. To add or remove a column, click its name.
      3. Click 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, click the linked number in the Metric streams column.
    6. (Optional) To get details about a firing alarm, click the alarm.

    Listing All Alarms

    1. Open the navigation menu and click Observability & Management. Under Monitoring, click Alarm Definitions.
    2. Under List Scope, select a compartment that you have permission to work in.
      The page lists alarms in the selected compartment.
    3. To find the status of an alarm, click the alarm.
      The alarm details page opens.

  • 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.