Monitors

This dataset provides access to Datadog Monitors and their current evaluation state. Monitors evaluate metrics, integration statuses, and network endpoints against user-configured thresholds and conditions, producing a status (OK, Alert, Warn, No Data, etc.) when state transitions occur. Each row represents a monitor definition along with its current status, notification configuration, and metadata such as creator and priority.

dd.monitors

Monitors Public Documentation

Monitors API Public Documentation

Query Parameters

This dataset uses a polymorphic table function. You must specify parameters when querying.

ParameterTypeRequiredDescription
columnsarray<string>YesList of fields to return for each monitor (e.g., ’name’, ‘status’, ‘monitor_type’). Must follow with AS (…) to name and type outputs.
filterstringNoOptional search string. For example: filter => ‘status:Alert’.

Example Queries

-- Fetch monitors currently in Alert state
SELECT * FROM dd.monitors(
  columns => ARRAY[
    'name',
    'monitor_id',
    'status',
    'monitor_type',
    'priority',
    'creator_name',
    'muted'
  ],
  filter => 'status:Alert'
) AS (
  name          VARCHAR,
  monitor_id    VARCHAR,
  status        VARCHAR,
  monitor_type  VARCHAR,
  priority      VARCHAR,
  creator_name  VARCHAR,
  muted         BOOLEAN
);

Fields

TitleIDTypeData TypeDescription
Monitor NamenamecorestringName of the monitor as configured by the user.
Monitor IDmonitor_idcorestringUnique identifier for the monitor.
MutedmutedcoreboolWhether the monitor is currently muted.
Muted Statusmuted_statuscorestringDetailed mute status of the monitor.
StatusstatuscorestringCurrent evaluation status of the monitor (e.g., OK, Alert, Warn, No Data).
NotificationsnotificationscorestringNotification targets configured for the monitor.
Created Atcreated_at_mscoretimestampTimestamp when the monitor was created.
Modified Atmodified_at_mscoretimestampTimestamp when the monitor was last modified.
Creator Namecreator_namecorestringName of the user who created the monitor.
Creator Handlecreator_handlecorestringHandle (email) of the user who created the monitor.
MessagemessagecorestringMonitor notification message body, which may include notification handles and template variables.
PriorityprioritycorestringPriority level assigned to the monitor (e.g., P1, P2, P3, P4, P5).
Monitor Typemonitor_typecorestringType of the monitor (e.g., metric, query alert, service check, event alert, synthetics).
TimestamptimestampcoretimestampTimestamp of the monitor record.