What is MQL (Monitoring Query Language) and how is it used in alarms?

MQL is the query language used to define metric conditions in OCI alarms. A typical MQL query specifies the metric namespace, metric name, statistic, interval, and optional grouping dimensions. For example: CpuUtilization[5m]{availabilityDomain = "AD-1"}.mean() > 80. The alarm evaluates this query at the specified interval and enters FIRING state when the condition is true for the configured number of consecutive evaluation periods.

How do alarm severity levels and notification destinations work?

OCI alarms support four severity levels: CRITICAL, ERROR, WARNING, and INFO. The severity is informational and determines the visual indicator in the console but does not change how the alarm is evaluated. Each alarm sends notifications to an OCI Notification Service topic, which can deliver messages via email, Slack, PagerDuty, HTTPS webhooks, or OCI Functions. You can configure different notification topics for different severity levels.

Can I suppress alarm notifications during maintenance windows?

Yes, OCI supports alarm suppressions that prevent notifications during specified time windows. You define the suppression start time, end time, and an optional description. During the suppression window, the alarm continues to evaluate and change state, but notifications are not sent. This is useful for planned maintenance, deployments, or known capacity changes that would otherwise trigger false alerts.

OCI Alarm Config Builder

MonitoringOCI

Build OCI Monitoring alarm configurations with MQL queries and notification topics.

OCI Alarm Configuration

Display Name

Compartment OCID

Namespace

Severity

Enabled

MQL Query

Message Body

Pending Duration

Repeat Notification

Notification Destinations (Topic OCIDs)

Display name is required
At least one destination (topic OCID) is required

Generated OCI Alarm JSON

Output will appear here...

About This Tool

OCI Monitoring alarms evaluate metric conditions and trigger notifications when thresholds are breached. Configuring alarms requires specifying the target metric, statistic (mean, max, min, sum, rate, count), aggregation interval, comparison operator, threshold value, and the notification destination. Alarms support composite conditions with grouping dimensions and suppression windows for maintenance periods. This builder helps you assemble alarm definitions with correct MQL (Monitoring Query Language) queries, evaluation periods, and notification topic references, outputting configurations for Terraform, the OCI CLI, or the Monitoring API.

When to Use This Tool

•Building CPU utilization alarms that trigger when average CPU exceeds 85% across all instances in a compartment for 5 consecutive minutes
•Creating composite alarms that fire only when both memory utilization exceeds 90% and disk I/O latency exceeds 50ms simultaneously
•Configuring alarm suppressions during scheduled maintenance windows to prevent false alert notifications
•Generating alarms for custom application metrics published via the OCI Monitoring API with appropriate grouping dimensions

Frequently Asked Questions

What is MQL (Monitoring Query Language) and how is it used in alarms?: MQL is the query language used to define metric conditions in OCI alarms. A typical MQL query specifies the metric namespace, metric name, statistic, interval, and optional grouping dimensions. For example: CpuUtilization[5m]{availabilityDomain = "AD-1"}.mean() > 80. The alarm evaluates this query at the specified interval and enters FIRING state when the condition is true for the configured number of consecutive evaluation periods.
How do alarm severity levels and notification destinations work?: OCI alarms support four severity levels: CRITICAL, ERROR, WARNING, and INFO. The severity is informational and determines the visual indicator in the console but does not change how the alarm is evaluated. Each alarm sends notifications to an OCI Notification Service topic, which can deliver messages via email, Slack, PagerDuty, HTTPS webhooks, or OCI Functions. You can configure different notification topics for different severity levels.
Can I suppress alarm notifications during maintenance windows?: Yes, OCI supports alarm suppressions that prevent notifications during specified time windows. You define the suppression start time, end time, and an optional description. During the suppression window, the alarm continues to evaluate and change state, but notifications are not sent. This is useful for planned maintenance, deployments, or known capacity changes that would otherwise trigger false alerts.

Related Learning Guides

OCI Cost Optimization Strategies18 min read

Disclaimer: This tool runs entirely in your browser. No data is sent to our servers. Always verify outputs before using them in production. AWS, Azure, and GCP are trademarks of their respective owners.