Datadog CLI

AI エージェントが Datadog のログとメトリクスを使用してデバッグとトリアージを行うための 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>

US 以外の 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. クイックエラー概要
npx @leoflores/datadog-cli errors --from 1h --pretty

# 2. これは新しいものか? 前の期間と比較
npx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty

# 3. エラーパターンを検索
npx @leoflores/datadog-cli logs patterns --query "status:error" --from 1h --pretty

# 4. サービスで範囲を狭める
npx @leoflores/datadog-cli logs search --query "status:error service:api" --from 1h --pretty

# 5. タイムスタンプ周辺のコンテキストを取得
npx @leoflores/datadog-cli logs context --timestamp "2024-01-15T10:30:00Z" --service api --pretty

# 6. 分散トレースをたどる
npx @leoflores/datadog-cli logs trace --id "TRACE_ID" --pretty

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