Oracle Cloud Infrastructure Documentation

Creating an Alarm

Create an alarm in Big Data Service.

For basic alarm creation steps with an example CPU utilization alarm, see the following.

Alarm Details

Field Description
Alarm name (under Define alarm) User-friendly name for the new alarm. This name is sent as the title for notifications related to this alarm. Avoid entering confidential information.
Alarm severity The perceived type of response required when the alarm is in the firing state.
Alarm body (optional) The human-readable content of the notification delivered. We recommend providing guidance to operators for resolving the alarm condition. Consider adding links to standard practices.
Tags (optional) If you have permissions to create a resource, then you can also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. If you are not sure whether to apply tags, skip this option or ask your administrator.
Compartment (under Metrics) The compartment containing the resources that emit the metrics evaluated by the alarm. The selected compartment is also the storage location of the alarm. By default, the compartment you previously selected is entered.
Metric namespace The source service or application emitting the metric. Options depend on the types of resources that exist in the selected compartment.
Resource group (Optional) The group that the metric belongs to. Use resource groups to match custom metrics.
Metric name The name of the metric that's evaluated by the alarm.
Interval The aggregation window to apply when converting a selection of data points to aggregated data, or the frequency at which data points are aggregated. Example: 5 minutes.

For Custom interval, specify a Custom value and select a Unit (Minutes or Hours).
Statistic The aggregation function.
  • Count - The number of observations received in the specified time periods.
  • Max - The highest value observed during the specified time periods.
  • Mean - The value of Sum divided by Count during the specified time period.
  • Min - The lowest value observed during the specified time.
  • P50 - The value of the 50th percentile.
  • P90 - The value of the 90th percentile.
  • P95 - The value of the 95th percentile.
  • P99 - The value of the 99th percentile.
  • Rate - The per interval average rate of change.
  • Sum - All values added together.
Dimension name The name of a qualifier provided in a metric definition. Use dimensions to filter metric data.
Dimension value The value to use when filtering metric data by the specified dimension.
resourceID The value to use when filtering metric data by the specified dimension.
Aggregate metric streams Returns the combined value of all metric streams for the selected statistic. This option is equivalent to the grouping() query component.
Additional dimension Click to add an additional dimension name-value pair.
Trigger rule The condition that must be satisfied for the alarm to be in the firing state. The condition can specify a threshold, such as 90% for CPU utilization, or an absence. Fill in the fields:
  • Operator - The operator for the condition to be met for the firing state.
    • greater than
    • greater than or equal to
    • equal to
    • less than
    • between (inclusive of specified values)
    • outside (inclusive of specified values)
    • absent
  • Value - The value of the condition threshold.
  • Trigger delay minutes - The number of minutes that the condition must be maintained before the alarm is in firing state.
Destination The provider of the destination to use for alarm notifications.
  • Destination service - The provider to use when setting up notification destinations for firing alarms. For the Notifications service, each notification destination includes a topic and subscription protocol (such as PagerDuty).
  • Compartment - The compartment for this destination.
  • Topic - Select a topic.
  • Create topic - Click to create a new topic. and enter the following information.
    • Topic name
    • Topic description
    • Subscription protocol
    • Subscription email
Message grouping Select an option:
  • Group messages across metric streams - Collectively track metric status across all metric streams. Send a message when metric status across all metric streams changes.
  • Split messages per metric stream - Individually track metric status by metric stream. Send a message when metric status for each metric stream changes.
Message format Select an option for appearance of messages you receive from this alarm (Notifications destination only).
  • Send formatted message - Simplified, user-friendly layout.
  • Send Pretty JSON messages (raw text with line breaks) - JSON with new lines and indents.
  • Send raw messages - Raw JSON blob.
Repeat notification? While the alarm is in the firing state, resends notifications at the specified interval.
Suppress notifications Sets up suppression time window during which to suspend evaluations an notifications. Useful for avoiding alarm notifications during system maintenance periods. Specify Start Time, End time, and optionally Suppression description.
Enable this alarm Whether or not the alarm is enabled. When disabled, no evaluations or notifications occur.