---

name: datadog description: Monitor infrastructure and applications via Datadog API. Query metrics, manage dashboards, and create alerts. metadata: {"clawdbot":{"emoji":"🐕","requires":{"env":["DD_API_KEY","DD_APP_KEY"]}}}

Datadog

Infrastructure monitoring.

Environment

export DD_API_KEY="xxxxxxxxxx"
export DD_APP_KEY="xxxxxxxxxx"
export DD_SITE="datadoghq.com"  # or datadoghq.eu, us3.datadoghq.com, etc.

Submit Metrics

curl -X POST "https://api.$DD_SITE/api/v2/series" \
  -H "DD-API-KEY: $DD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "series": [{
      "metric": "custom.metric",
      "type": 0,
      "points": [{"timestamp": '$(date +%s)', "value": 42}],
      "tags": ["env:prod"]
    }]
  }'

Query Metrics

curl "https://api.$DD_SITE/api/v1/query?from=$(date -d '1 hour ago' +%s)&to=$(date +%s)&query=avg:system.cpu.user{*}" \
  -H "DD-API-KEY: $DD_API_KEY" \
  -H "DD-APPLICATION-KEY: $DD_APP_KEY"

List Monitors

curl "https://api.$DD_SITE/api/v1/monitor" \
  -H "DD-API-KEY: $DD_API_KEY" \
  -H "DD-APPLICATION-KEY: $DD_APP_KEY"

Create Monitor

curl -X POST "https://api.$DD_SITE/api/v1/monitor" \
  -H "DD-API-KEY: $DD_API_KEY" \
  -H "DD-APPLICATION-KEY: $DD_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CPU High Alert",
    "type": "metric alert",
    "query": "avg(last_5m):avg:system.cpu.user{*} > 90",
    "message": "CPU usage is above 90%!"
  }'

Send Event

curl -X POST "https://api.$DD_SITE/api/v1/events" \
  -H "DD-API-KEY: $DD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Deployment", "text": "Deployed v1.2.3", "tags": ["env:prod"]}'

List Dashboards

curl "https://api.$DD_SITE/api/v1/dashboard" \
  -H "DD-API-KEY: $DD_API_KEY" \
  -H "DD-APPLICATION-KEY: $DD_APP_KEY"

Links

• Dashboard: https://app.datadoghq.com
• Docs: https://docs.datadoghq.com/api