Monitor Groups

This dataset provides access to Datadog Monitor Groups, which represent the individual group-by evaluation results of multi-alert monitors. While a monitor defines the overall alerting condition, each monitor group tracks the status of a specific scope (e.g., per host, per service) within that monitor. Each row includes the group’s current status, trigger timestamps, and the associated monitor metadata.

dd.monitor_groups

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 group (e.g., ’name’, ‘status’, ‘monitor_id’). Must follow with AS (…) to name and type outputs.
filterstringNoOptional search string. For example: filter => ‘status:Alert’.

Example Queries

-- Fetch monitor groups currently in Alert state
SELECT * FROM dd.monitor_groups(
  columns => ARRAY[
    'name',
    'monitor_id',
    'status',
    'monitor_type',
    'priority',
    'state_modified_at_ms',
    'last_triggered_at_ms'
  ],
  filter => 'status:Alert'
) AS (
  name                 VARCHAR,
  monitor_id           VARCHAR,
  status               VARCHAR,
  monitor_type         VARCHAR,
  priority             VARCHAR,
  state_modified_at    TIMESTAMP,
  last_triggered_at    TIMESTAMP
);

Fields

TitleIDTypeData TypeDescription
Group NamenamecorestringName identifying the monitor group scope (e.g., host:web-01, service:api).
Monitor IDmonitor_idcorestringUnique identifier of the parent monitor.
MutedmutedcoreboolWhether the monitor group is currently muted.
Muted Statusmuted_statuscorestringDetailed mute status of the monitor group.
StatusstatuscorestringCurrent evaluation status of the monitor group (e.g., OK, Alert, Warn, No Data).
NotificationsnotificationscorestringNotification targets configured for the parent monitor.
Creator Namecreator_namecorestringName of the user who created the parent monitor.
Creator Handlecreator_handlecorestringHandle (email) of the user who created the parent monitor.
MessagemessagecorestringMonitor notification message body, which may include notification handles and template variables.
Query Metadataquery_metadatacorestringMetadata about the monitor query and its group-by configuration.
State Modified Atstate_modified_at_mscoretimestampTimestamp when the monitor group's status last changed.
Last Triggered Atlast_triggered_at_mscoretimestampTimestamp when the monitor group last triggered an alert.
PriorityprioritycorestringPriority level assigned to the parent monitor (e.g., P1, P2, P3, P4, P5).
Monitor Typemonitor_typecorestringType of the parent monitor (e.g., metric, query alert, service check, event alert, synthetics).
TimestamptimestampcoretimestampTimestamp of the monitor group record.