datadog

Datadog CLI

Datadog の可観測性データ（ログ、メトリクス、モニター、ダッシュボード、ホスト、APM スパン）に API から直接アクセスできます。

前提条件

次の環境変数を設定します。

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 キー：Organization Settings → API Keys
• App キー：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（スパンとサービス）

# 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 キーに必要なスコープがあることを確認します
• API キーが有効であることを確認します

認証情報が見つからない場合：

• DD_API_KEY と DD_APP_KEY がエクスポートされていることを確認します
• 環境変数名に誤字がないか確認します