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

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

# 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 
{% 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 (e.g., 'name', 'status', 'monitor_type'). Must follow with AS (…) to name and type outputs. |
| `filter`  | `string`        | No       | Optional search string. For example: filter => 'status:Alert'.                                                                        |

## Example Queries

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

| Title          | ID             | Type | Data Type | Description                                                                                       |
| -------------- | -------------- | ---- | --------- | ------------------------------------------------------------------------------------------------- |
| Monitor Name   | name           | core | string    | Name of the monitor as configured by the user.                                                    |
| Monitor ID     | monitor_id     | core | string    | Unique identifier for the monitor.                                                                |
| Muted          | muted          | core | bool      | Whether the monitor is currently muted.                                                           |
| Muted Status   | muted_status   | core | string    | Detailed mute status of the monitor.                                                              |
| Status         | status         | core | string    | Current evaluation status of the monitor (e.g., OK, Alert, Warn, No Data).                        |
| Notifications  | notifications  | core | string    | Notification targets configured for the monitor.                                                  |
| Created At     | created_at_ms  | core | timestamp | Timestamp when the monitor was created.                                                           |
| Modified At    | modified_at_ms | core | timestamp | Timestamp when the monitor was last modified.                                                     |
| Creator Name   | creator_name   | core | string    | Name of the user who created the monitor.                                                         |
| Creator Handle | creator_handle | core | string    | Handle (email) of the user who created the monitor.                                               |
| Message        | message        | core | string    | Monitor notification message body, which may include notification handles and template variables. |
| Priority       | priority       | core | string    | Priority level assigned to the monitor (e.g., P1, P2, P3, P4, P5).                                |
| Monitor Type   | monitor_type   | core | string    | Type of the monitor (e.g., metric, query alert, service check, event alert, synthetics).          |
| Timestamp      | timestamp      | core | timestamp | Timestamp of the monitor record.                                                                  |