Oracle Cloud Infrastructure Documentation

Creating an Alarm Configuration

Configure alarms by using the guided, multi-step process in the Control Center dashboard.

  • Alarms are tenancy-specific and associated with the operator's tenancy.

    To create an alarm:

    1. On the Alarm notifications list page, select Create alarm. If you need help finding the list page, see Listing Alarms.
    2. Enter a meaningful name and description for the alarm.
    3. For Namespace, select one of the following options:
      • Compute: Select the shape (for example, Intel Standard) and, optionally, hardware generation (for example, X7) for greater granularity.
      • Storage: Select the type (Block Storage, Object Storage, or File Storage).
      • Exadata: Select the category (for example, Exadata nodes) and type (for example, DB or HC).
    4. Turn Alarm status on or off to enable or disable notifications.
    5. For alarm details:
      • Frequency: By default, the frequency is set to weekly. Daily and hourly options aren't available because of customer requirements.
      • Threshold: Set a percentage (for example, 65%) for total usage (OCI, overhead, and customer). Control Center sends notifications if the threshold is breached.
    6. For ONS topics, use the Notifications service to get notified when a threshold is exceeded and to manage subscriptions:

      • To use an existing topic, select Choose existing topic . You must already be added as a subscriber. Each topic supports up to three email subscribers. To add more email addresses, manage subscriptions in the Notifications section of the Notifications service

        service. For information about managing Notifications topics, see Managing Topics.
      • To create a topic in the Notifications service, select Create new topic.
    7. If you selected Create new topic in the previous step, complete the following actions:
      • Enter a topic name and description.
      • Add subscriber email addresses, such as operator@example.com.
      Note

      The Notifications service handles emails for secure delivery. Control Center does not store email addresses.

      By default, the topic is created in the root compartment.

    8. After configuring the alarm, select Create.
    The alarm is created with a unique alarm ID. You can view details such as resource configuration, threshold, and subscriptions.

  • Use the oci demand-signal occ-metric-alarm create command and required parameters to create an alarm:

    oci demand-signal occ-metric-alarm create --compartment-id <compartment_OCID> --display-name <text> --frequency <text> --is-active <boolean> --resource-configuration <json_file_or_string> -threshold <number> [OPTIONS]

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

  • Run the CreateOccMetricAlarm operation to create an alarm.