Datadog

Datadog

Query metrics, monitors, and logs via the Datadog API.

Environment Variables

• DD_API_KEY - Datadog API key
• DD_APP_KEY - Datadog Application key
• DD_SITE - Datadog site (e.g. datadoghq.com, datadoghq.eu, default: datadoghq.com)

List monitors

curl -s -H "DD-API-KEY: $DD_API_KEY" -H "DD-APPLICATION-KEY: $DD_APP_KEY" \
  "https://api.${DD_SITE:-datadoghq.com}/api/v1/monitor" | jq '.[] | {id, name, type, overall_state}'

Get monitor details

curl -s -H "DD-API-KEY: $DD_API_KEY" -H "DD-APPLICATION-KEY: $DD_APP_KEY" \
  "https://api.${DD_SITE:-datadoghq.com}/api/v1/monitor/12345" | jq '{id, name, type, query, overall_state, message}'

Mute monitor

curl -s -X POST -H "DD-API-KEY: $DD_API_KEY" -H "DD-APPLICATION-KEY: $DD_APP_KEY" \
  -H "Content-Type: application/json" \
  "https://api.${DD_SITE:-datadoghq.com}/api/v1/monitor/12345/mute" \
  -d '{"end": '$(date -d '+1 hour' +%s)'}' | jq '{id, name}'

Query metrics

curl -s -G -H "DD-API-KEY: $DD_API_KEY" -H "DD-APPLICATION-KEY: $DD_APP_KEY" \
  "https://api.${DD_SITE:-datadoghq.com}/api/v1/query" \
  --data-urlencode "query=avg:system.cpu.user{host:my-server}" \
  --data-urlencode "from=$(date -d '1 hour ago' +%s)" \
  --data-urlencode "to=$(date +%s)" | jq '.series[0] | {metric, pointlist: .pointlist[-5:]}'

Search logs

curl -s -X POST -H "DD-API-KEY: $DD_API_KEY" -H "DD-APPLICATION-KEY: $DD_APP_KEY" \
  -H "Content-Type: application/json" \
  "https://api.${DD_SITE:-datadoghq.com}/api/v2/logs/events/search" \
  -d '{
    "filter": {"query": "service:my-app status:error", "from": "now-1h", "to": "now"},
    "page": {"limit": 10}
  }' | jq '.data[] | {timestamp: .attributes.timestamp, message: .attributes.message}'

List events

curl -s -G -H "DD-API-KEY: $DD_API_KEY" -H "DD-APPLICATION-KEY: $DD_APP_KEY" \
  "https://api.${DD_SITE:-datadoghq.com}/api/v1/events" \
  --data-urlencode "start=$(date -d '24 hours ago' +%s)" \
  --data-urlencode "end=$(date +%s)" | jq '.events[:5] | .[] | {title, date_happened, priority}'

Post event

curl -s -X POST -H "DD-API-KEY: $DD_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.${DD_SITE:-datadoghq.com}/api/v1/events" \
  -d '{"title": "Deployment Complete", "text": "v1.2.3 deployed to production", "priority": "normal", "tags": ["env:prod"]}' | jq '{id: .event.id}'

List dashboards

curl -s -H "DD-API-KEY: $DD_API_KEY" -H "DD-APPLICATION-KEY: $DD_APP_KEY" \
  "https://api.${DD_SITE:-datadoghq.com}/api/v1/dashboard" | jq '.dashboards[:10] | .[] | {id, title}'

Notes

• Use DD_SITE for EU or other regional endpoints.
• Metric queries use Datadog's query language (e.g. avg:metric{tags}).
• Confirm before muting monitors or posting events.