---
title: Monitor Groups
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > DDSQL Reference > Data Directory > Monitor Groups
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# 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 
{% icon name="icon-external-link" /%}
 Monitors API Public Documentation 
{% icon name="icon-external-link" /%}
 
## Query Parameters

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

| Parameter | Type            | Required | Description                                                                                                                               |
| --------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `columns` | `array<string>` | Yes      | List of fields to return for each monitor group (e.g., 'name', 'status', 'monitor_id'). Must follow with AS (…) to name and type outputs. |
| `filter`  | `string`        | No       | Optional search string. For example: filter => 'status:Alert'.                                                                            |

## Example Queries

```sql
-- 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

| Title             | ID                   | Type | Data Type | Description                                                                                       |
| ----------------- | -------------------- | ---- | --------- | ------------------------------------------------------------------------------------------------- |
| Group Name        | name                 | core | string    | Name identifying the monitor group scope (e.g., host:web-01, service:api).                        |
| Monitor ID        | monitor_id           | core | string    | Unique identifier of the parent monitor.                                                          |
| Muted             | muted                | core | bool      | Whether the monitor group is currently muted.                                                     |
| Muted Status      | muted_status         | core | string    | Detailed mute status of the monitor group.                                                        |
| Status            | status               | core | string    | Current evaluation status of the monitor group (e.g., OK, Alert, Warn, No Data).                  |
| Notifications     | notifications        | core | string    | Notification targets configured for the parent monitor.                                           |
| Creator Name      | creator_name         | core | string    | Name of the user who created the parent monitor.                                                  |
| Creator Handle    | creator_handle       | core | string    | Handle (email) of the user who created the parent monitor.                                        |
| Message           | message              | core | string    | Monitor notification message body, which may include notification handles and template variables. |
| Query Metadata    | query_metadata       | core | string    | Metadata about the monitor query and its group-by configuration.                                  |
| State Modified At | state_modified_at_ms | core | timestamp | Timestamp when the monitor group's status last changed.                                           |
| Last Triggered At | last_triggered_at_ms | core | timestamp | Timestamp when the monitor group last triggered an alert.                                         |
| Priority          | priority             | core | string    | Priority level assigned to the parent monitor (e.g., P1, P2, P3, P4, P5).                         |
| Monitor Type      | monitor_type         | core | string    | Type of the parent monitor (e.g., metric, query alert, service check, event alert, synthetics).   |
| Timestamp         | timestamp            | core | timestamp | Timestamp of the monitor group record.                                                            |