Datadog
Monitor infrastructure, applications, and logs with Datadog
Configuration
Submit Metrics
Operation
Submit Metrics
API Key*
••••••••
Datadog Site
US1 (datadoghq.com)
Metrics Data (JSON)*
json
[
{
"metric": "custom.app.response_time",
"type": "gauge",
"points": [{"timestamp": 1700000000, "value": 0.85}],
"tags": ["env:production", "service:api"]
}
]
Submit Metrics (
datadog_submit_metrics)Submit custom metrics to Datadog. Use for tracking application performance, business metrics, or custom monitoring data.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
series | string | Yes | JSON array of metric series to submit. Each series should include metric name, type (gauge/rate/count), points (timestamp/value pairs), and optional tags. |
apiKey | string | Yes | Datadog API key |
site | string | No | Datadog site/region (default: datadoghq.com) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the metrics were submitted successfully |
errors | array | Any errors that occurred during submission |
Query Timeseries
Operation
Query Timeseries
API Key*
••••••••
Datadog Site
US1 (datadoghq.com)
Query*
avg:system.cpu.user{*}
From (Unix Timestamp)*
e.g., 1701360000
To (Unix Timestamp)*
e.g., 1701446400
Application Key*
••••••••
Query Timeseries (
datadog_query_timeseries)Query metric timeseries data from Datadog. Use for analyzing trends, creating reports, or retrieving metric values.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Datadog metrics query (e.g., "avg:system.cpu.user{*}") |
from | number | Yes | Start time as Unix timestamp in seconds |
to | number | Yes | End time as Unix timestamp in seconds |
apiKey | string | Yes | Datadog API key |
applicationKey | string | Yes | Datadog Application key |
site | string | No | Datadog site/region (default: datadoghq.com) |
Output
| Parameter | Type | Description |
|---|---|---|
series | array | Array of timeseries data with metric name, tags, and data points |
status | string | Query status |
Create Event
Operation
Create Event
API Key*
••••••••
Datadog Site
US1 (datadoghq.com)
Event Title*
Deployment completed
Event Text*
Describe the event...
Alert Type
Info
Priority
Normal
Tags
env:production, service:api
Create Event (
datadog_create_event)Post an event to the Datadog event stream. Use for deployment notifications, alerts, or any significant occurrences.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Event title |
text | string | Yes | Event body/description. Supports markdown. |
alertType | string | No | Alert type: error, warning, info, success, user_update, recommendation, or snapshot |
priority | string | No | Event priority: normal or low |
host | string | No | Host name to associate with this event |
tags | string | No | Comma-separated list of tags (e.g., "env:production,service:api") |
aggregationKey | string | No | Key to aggregate events together |
sourceTypeName | string | No | Source type name for the event |
dateHappened | number | No | Unix timestamp when the event occurred (defaults to now) |
apiKey | string | Yes | Datadog API key |
site | string | No | Datadog site/region (default: datadoghq.com) |
Output
| Parameter | Type | Description |
|---|---|---|
event | object | The created event details |
Create Monitor
Operation
Create Monitor
API Key*
••••••••
Datadog Site
US1 (datadoghq.com)
Monitor Name*
High CPU Usage Alert
Monitor Type*
Metric Alert
Monitor Query*
avg(last_5m):avg:system.cpu.idle{*} < 20
Notification Message
Alert! CPU usage is high. @slack-alerts
Tags
team:backend, priority:high
Priority (1-5)
3
Options (JSON)
json
{"notify_no_data": true, "thresholds": {"critical": 90}}
Application Key*
••••••••
Create Monitor (
datadog_create_monitor)Create a new monitor/alert in Datadog. Monitors can track metrics, service checks, events, and more.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Monitor name |
type | string | Yes | Monitor type: metric alert, service check, event alert, process alert, log alert, query alert, composite, synthetics alert, slo alert |
query | string | Yes | Monitor query (e.g., "avg(last_5m):avg:system.cpu.idle{*} < 20") |
message | string | No | Message to include with notifications. Can include @-mentions and markdown. |
tags | string | No | Comma-separated list of tags |
priority | number | No | Monitor priority (1-5, where 1 is highest) |
options | string | No | JSON string of monitor options (thresholds, notify_no_data, renotify_interval, etc.) |
apiKey | string | Yes | Datadog API key |
applicationKey | string | Yes | Datadog Application key |
site | string | No | Datadog site/region (default: datadoghq.com) |
Output
| Parameter | Type | Description |
|---|---|---|
monitor | object | The created monitor details |
Get Monitor
Operation
Get Monitor
API Key*
••••••••
Datadog Site
US1 (datadoghq.com)
Monitor ID*
12345678
Application Key*
••••••••
Get Monitor (
datadog_get_monitor)Retrieve details of a specific monitor by ID.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
monitorId | string | Yes | The ID of the monitor to retrieve |
groupStates | string | No | Comma-separated group states to include: alert, warn, no data, ok |
withDowntimes | boolean | No | Include downtime data with the monitor |
apiKey | string | Yes | Datadog API key |
applicationKey | string | Yes | Datadog Application key |
site | string | No | Datadog site/region (default: datadoghq.com) |
Output
| Parameter | Type | Description |
|---|---|---|
monitor | object | The monitor details |
List Monitors
Operation
List Monitors
API Key*
••••••••
Datadog Site
US1 (datadoghq.com)
Filter by Name
CPU
Filter by Tags
env:production
Application Key*
••••••••
List Monitors (
datadog_list_monitors)List all monitors in Datadog with optional filtering by name, tags, or state.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
groupStates | string | No | Comma-separated group states to filter by: alert, warn, no data, ok |
name | string | No | Filter monitors by name (partial match) |
tags | string | No | Comma-separated list of tags to filter by |
monitorTags | string | No | Comma-separated list of monitor tags to filter by |
withDowntimes | boolean | No | Include downtime data with monitors |
page | number | No | Page number for pagination (0-indexed) |
pageSize | number | No | Number of monitors per page (max 1000) |
apiKey | string | Yes | Datadog API key |
applicationKey | string | Yes | Datadog Application key |
site | string | No | Datadog site/region (default: datadoghq.com) |
Output
| Parameter | Type | Description |
|---|---|---|
monitors | array | List of monitors |
Mute Monitor
Operation
Mute Monitor
API Key*
••••••••
Datadog Site
US1 (datadoghq.com)
Monitor ID*
12345678
Scope
host:myhost (optional)
End Time (Unix Timestamp)
Leave empty for indefinite
Application Key*
••••••••
Mute Monitor (
datadog_mute_monitor)Mute a monitor to temporarily suppress notifications.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
monitorId | string | Yes | The ID of the monitor to mute |
scope | string | No | Scope to mute (e.g., "host:myhost"). If not specified, mutes all scopes. |
end | number | No | Unix timestamp when the mute should end. If not specified, mutes indefinitely. |
apiKey | string | Yes | Datadog API key |
applicationKey | string | Yes | Datadog Application key |
site | string | No | Datadog site/region (default: datadoghq.com) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the monitor was successfully muted |
Query Logs
Operation
Query Logs
API Key*
••••••••
Datadog Site
US1 (datadoghq.com)
Search Query*
service:web-app status:error
From*
now-1h
To*
now
Limit
50
Application Key*
••••••••
Query Logs (
datadog_query_logs)Search and retrieve logs from Datadog. Use for troubleshooting, analysis, or monitoring.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Log search query (e.g., "service:web-app status:error") |
from | string | Yes | Start time in ISO-8601 format or relative (e.g., "now-1h") |
to | string | Yes | End time in ISO-8601 format or relative (e.g., "now") |
limit | number | No | Maximum number of logs to return (default: 50, max: 1000) |
sort | string | No | Sort order: timestamp (oldest first) or -timestamp (newest first) |
indexes | string | No | Comma-separated list of log indexes to search |
apiKey | string | Yes | Datadog API key |
applicationKey | string | Yes | Datadog Application key |
site | string | No | Datadog site/region (default: datadoghq.com) |
Output
| Parameter | Type | Description |
|---|---|---|
logs | array | List of log entries |
nextLogId | string | Cursor for pagination |
Send Logs
Operation
Send Logs
API Key*
••••••••
Datadog Site
US1 (datadoghq.com)
Logs (JSON)*
json
[
{
"message": "Application started successfully",
"service": "my-app",
"ddsource": "custom",
"ddtags": "env:production"
}
]
Send Logs (
datadog_send_logs)Send log entries to Datadog for centralized logging and analysis.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
logs | string | Yes | JSON array of log entries. Each entry should have message and optionally ddsource, ddtags, hostname, service. |
apiKey | string | Yes | Datadog API key |
site | string | No | Datadog site/region (default: datadoghq.com) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the logs were sent successfully |
Create Downtime
Operation
Create Downtime
API Key*
••••••••
Datadog Site
US1 (datadoghq.com)
Scope*
host:myhost or env:production or *
Message
Scheduled maintenance
Start Time (Unix Timestamp)
Leave empty for now
End Time (Unix Timestamp)
e.g., 1701450000
Monitor ID (optional)
12345678
Application Key*
••••••••
Create Downtime (
datadog_create_downtime)Schedule a downtime to suppress monitor notifications during maintenance windows.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
scope | string | Yes | Scope to apply downtime to (e.g., "host:myhost", "env:production", or "*" for all) |
message | string | No | Message to display during downtime |
start | number | No | Unix timestamp for downtime start (defaults to now) |
end | number | No | Unix timestamp for downtime end |
timezone | string | No | Timezone for the downtime (e.g., "America/New_York") |
monitorId | string | No | Specific monitor ID to mute |
monitorTags | string | No | Comma-separated monitor tags to match (e.g., "team:backend,priority:high") |
muteFirstRecoveryNotification | boolean | No | Mute the first recovery notification |
apiKey | string | Yes | Datadog API key |
applicationKey | string | Yes | Datadog Application key |
site | string | No | Datadog site/region (default: datadoghq.com) |
Output
| Parameter | Type | Description |
|---|---|---|
downtime | object | The created downtime details |
List Downtimes
Operation
List Downtimes
API Key*
••••••••
Datadog Site
US1 (datadoghq.com)
Current Only
Disabled
Application Key*
••••••••
List Downtimes (
datadog_list_downtimes)List all scheduled downtimes in Datadog.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
currentOnly | boolean | No | Only return currently active downtimes |
monitorId | string | No | Filter by monitor ID |
apiKey | string | Yes | Datadog API key |
applicationKey | string | Yes | Datadog Application key |
site | string | No | Datadog site/region (default: datadoghq.com) |
Output
| Parameter | Type | Description |
|---|---|---|
downtimes | array | List of downtimes |
Cancel Downtime
Operation
Cancel Downtime
API Key*
••••••••
Datadog Site
US1 (datadoghq.com)
Downtime ID*
abc123
Application Key*
••••••••
Cancel Downtime (
datadog_cancel_downtime)Cancel a scheduled downtime.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
downtimeId | string | Yes | The ID of the downtime to cancel |
apiKey | string | Yes | Datadog API key |
applicationKey | string | Yes | Datadog Application key |
site | string | No | Datadog site/region (default: datadoghq.com) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the downtime was successfully canceled |
Usage Instructions
Integrate Datadog monitoring into workflows. Submit metrics, manage monitors, query logs, create events, handle downtimes, and more.
Notes
- Category:
tools - Type:
datadog