datadog-cli

Datadog CLI

Datadog のログとメトリクスを使ってデバッグやトリアージを行う AI エージェント向けの CLI ツールです。

必読事項

いずれかのコマンドを使用する前に、関連するリファレンスドキュメントを必ず読んでください:

• Log Commands
• Metrics
• Query Syntax
• Workflows
• Dashboards

セットアップ

環境変数（必須）

export DD_API_KEY="your-api-key"
export DD_APP_KEY="your-app-key"

キーの取得先: https://app.datadoghq.com/organization-settings/api-keys

CLI の実行

npx @leoflores/datadog-cli <command>

米国以外の Datadog サイトを使用する場合は、--site フラグを使用してください:

npx @leoflores/datadog-cli logs search --query "*" --site datadoghq.eu

コマンド概要

コマンド	説明
logs search	フィルターを指定してログを検索
logs tail	ログをリアルタイムでストリーミング
logs trace	分散トレースに関連するログを検索
logs context	タイムスタンプの前後のログを取得
logs patterns	類似したログメッセージをグループ化
logs compare	期間ごとのログ件数を比較
logs multi	複数のクエリを並列実行
logs agg	ファセットごとにログを集計
metrics query	時系列メトリクスをクエリ
errors	サービス／タイプ別のエラー概要をすばやく表示
services	ログアクティビティのあるサービスを一覧表示
dashboards	ダッシュボードを管理（CRUD）
dashboard-lists	ダッシュボードリストを管理

クイック例

エラーを検索

npx @leoflores/datadog-cli logs search --query "status:error" --from 1h --pretty

ログをテール（リアルタイム）

npx @leoflores/datadog-cli logs tail --query "service:api status:error" --pretty

エラー概要

npx @leoflores/datadog-cli errors --from 1h --pretty

トレースの相関

npx @leoflores/datadog-cli logs trace --id "abc123def456" --pretty

メトリクスをクエリ

npx @leoflores/datadog-cli metrics query --query "avg:system.cpu.user{*}" --from 1h --pretty

期間の比較

npx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty

グローバルフラグ

フラグ	説明
--pretty	色付きの人間が読みやすい出力
--output <file>	結果を JSON ファイルにエクスポート
--site <site>	Datadog サイト（例: datadoghq.eu）

時刻の形式

• 相対指定: 30m, 1h, 6h, 24h, 7d
• ISO 8601: 2024-01-15T10:30:00Z

インシデントトリアージのワークフロー

# 1. Quick error overview
npx @leoflores/datadog-cli errors --from 1h --pretty

# 2. Is this new? Compare to previous period
npx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty

# 3. Find error patterns
npx @leoflores/datadog-cli logs patterns --query "status:error" --from 1h --pretty

# 4. Narrow down by service
npx @leoflores/datadog-cli logs search --query "status:error service:api" --from 1h --pretty

# 5. Get context around a timestamp
npx @leoflores/datadog-cli logs context --timestamp "2024-01-15T10:30:00Z" --service api --pretty

# 6. Follow the distributed trace
npx @leoflores/datadog-cli logs trace --id "TRACE_ID" --pretty

その他のデバッグワークフローについては workflows.md を参照してください。