datadog

Datadog CLI

直接访问 Datadog 可观测性数据的 API，包括日志、指标、监控器、仪表板、主机和 APM Span。

前置条件

设置以下环境变量：

export DD_API_KEY="your-32-char-hex-api-key"
export DD_APP_KEY="your-application-key"
export DD_SITE="us5.datadoghq.com"  # or datadoghq.com, datadoghq.eu, etc.

从 Datadog 获取密钥：

• API Key：Organization Settings → API Keys
• App Key：Organization Settings → Application Keys

必需的权限范围（用于只读访问）：

• dashboards_read、monitors_read、metrics_read、logs_read_data、incidents_read、hosts_read、apm_read

快速开始

# Test credentials
npx tsx <skill-path>/scripts/datadog.ts validate

# Search logs
npx tsx <skill-path>/scripts/datadog.ts search-logs "status:error" --from -1h

# Query metrics
npx tsx <skill-path>/scripts/datadog.ts query-metrics "avg:system.cpu.user{*}" --from -4h

# List monitors
npx tsx <skill-path>/scripts/datadog.ts list-monitors

命令

日志

# Search logs (default: last hour, 50 results)
npx tsx <skill-path>/scripts/datadog.ts search-logs "service:api status:error"
npx tsx <skill-path>/scripts/datadog.ts search-logs "env:prod" --from -30m --limit 100

指标

# Query metric timeseries
npx tsx <skill-path>/scripts/datadog.ts query-metrics "avg:system.cpu.user{*}" --from -4h
npx tsx <skill-path>/scripts/datadog.ts query-metrics "sum:requests.count{service:api}.as_count()" --from -1d

监控器

# List all monitors
npx tsx <skill-path>/scripts/datadog.ts list-monitors

# Filter monitors
npx tsx <skill-path>/scripts/datadog.ts list-monitors --query "status:alert"

# Get specific monitor
npx tsx <skill-path>/scripts/datadog.ts get-monitor 12345

仪表板

npx tsx <skill-path>/scripts/datadog.ts list-dashboards

主机

npx tsx <skill-path>/scripts/datadog.ts list-hosts
npx tsx <skill-path>/scripts/datadog.ts list-hosts --filter "env:production"

事件

npx tsx <skill-path>/scripts/datadog.ts list-incidents

APM（Span 和服务）

# Search spans
npx tsx <skill-path>/scripts/datadog.ts search-spans "service:api @http.status_code:500" --from -1h

# List services
npx tsx <skill-path>/scripts/datadog.ts list-services

时间格式

--from 和 --to 标志接受以下格式：

• 相对时间：-1h、-30m、-1d、-4h
• ISO 8601：2026-03-20T00:00:00Z

Datadog 站点

区域	DD_SITE 值
US1	datadoghq.com
US3	us3.datadoghq.com
US5	us5.datadoghq.com
EU	datadoghq.eu
AP1	ap1.datadoghq.com

故障排除

403 Forbidden：

• 检查 DD_SITE 是否与 Datadog 区域匹配
• 确认 App Key 具有所需的权限范围
• 确认 API Key 处于启用状态

未找到凭据：

• 确保已导出 DD_API_KEY 和 DD_APP_KEY
• 检查环境变量名称是否有拼写错误