Datadog
Connects to the Datadog API. An agent can query metrics and logs, create events, and list/mute monitors and dashboards.
Add to an agent node's tools array with _node_type: "tool-datadog". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
api_key | Yes | Datadog API key, sent as the DD-API-KEY header. |
app_key | No | Datadog application key, sent as the DD-APPLICATION-KEY header. Required by some endpoints (e.g. monitors, dashboards). |
site | No | Datadog site, e.g. datadoghq.com or datadoghq.eu. Defaults to datadoghq.com. |
{
"name": "datadog",
"_node_type": "tool-datadog",
"api_key": "{{ secret.DATADOG_API_KEY }}",
"app_key": "{{ secret.DATADOG_APP_KEY }}",
"site": "datadoghq.com"
}
Tools
datadog_query_metrics
Query Datadog time-series metrics. Returns data points for a metric query.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Datadog metric query e.g. avg:system.cpu.user{host:web01} |
from | number | No | Start time as unix timestamp (default: 1 hour ago) |
to | number | No | End time as unix timestamp (default: now) |
Returns: A newline-separated list of <metric name>: latest=<value> (<N> points) lines, or "No data found for query: <query>".
datadog_create_event
Create a Datadog event (visible in Event Stream and dashboards).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Event title |
text | string | Yes | Event body text |
tags | string | No | Comma-separated tags e.g. env:prod,service:api |
alert_type | string | No | info, warning, error, success (default info) |
Returns: A confirmation message: Event created: <title>.
datadog_list_monitors
List Datadog monitors and their current state (OK, ALERT, WARN, NO DATA).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
tags | string | No | Filter by tags e.g. env:prod |
Returns: A newline-separated list of [<id>] <name> <overall_state> lines.
datadog_mute_monitor
Mute a Datadog monitor to suppress alerts.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | number | Yes | Monitor ID to mute |
duration | number | No | Mute duration in seconds (0 = until unmuted) |
Returns: A confirmation message: Monitor <id> muted.
datadog_list_dashboards
List all Datadog dashboards with their URLs.
No parameters.
Returns: A newline-separated list of <title> <url> lines.
datadog_query_logs
Search Datadog logs. Returns recent log messages matching the query.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Datadog log query e.g. service:api status:error |
limit | number | No | Max logs to return (default 20) |
Returns: A newline-separated list of [<timestamp>] <message> lines, or "No logs found for: <query>". Searches the last hour.