Datadog · Schema

Datadog Monitor

A Datadog monitor that continuously evaluates a query against defined thresholds and sends notifications when alert conditions are triggered. Monitors are the foundation of Datadog's alerting system and support metric thresholds, anomaly detection, outlier detection, log patterns, APM traces, synthetic test results, and composite conditions. Each monitor tracks the status of one or more groups defined by the query's group-by tags.

AnalyticsDashboardsMonitoringPlatformT1Visualizations

Properties

Name Type Description
id integer The unique numeric identifier assigned by Datadog when the monitor is created. Read-only and used to reference the monitor in API calls and URLs.
type string The type of monitor which determines the query language, threshold options, and evaluation behavior. The most common type is 'metric alert' for threshold-based alerting on metrics.
query string The monitor query expression defining what to evaluate and when to alert. The query syntax depends on the monitor type. For metric alerts, uses Datadog's metrics query language with threshold conditio
name string A descriptive name for the monitor shown in the Monitors list, notification subject lines, and dashboard widgets. Should clearly describe what is being monitored and what constitutes an alert conditio
message string The notification message body sent to alert recipients when the monitor triggers. Supports Datadog template variables (e.g., {{host.name}}, {{value}}), conditional blocks, and @-mentions for routing n
tags array List of tags to associate with the monitor for organization, filtering, and scoping. Tags appear in the Monitors list and can be used to group monitors by team, service, or environment. Tags do not af
options object
priority integer The monitor priority level from 1 (highest/most critical) to 5 (lowest). Priority is used for sorting monitors in the Monitors list and can be used to filter monitors in notification rules.
state object
creator object
created string ISO 8601 timestamp when the monitor was created. Set automatically by Datadog and cannot be modified.
modified string ISO 8601 timestamp when the monitor was last modified. Updated automatically whenever the monitor configuration is changed.
deleted stringnull ISO 8601 timestamp when the monitor was soft-deleted, or null if the monitor is active. Soft-deleted monitors are hidden but retained for a period before permanent deletion.
restricted_roles array List of role IDs whose members are allowed to edit this monitor. When set, only users with at least one of the specified roles can modify the monitor. An empty array means all users with monitor write
View JSON Schema on GitHub