Datadog MCP Server

Datadog MCP サーバー

英語 (本書) |日本語

ログ検索、トレーススパン検索、トレーススパン集約機能を有効にする、Datadog API 用の MCP サーバー。

特徴

• ログ検索: 柔軟なクエリオプションを使用して、Datadog からログを検索および取得します。
• トレーススパン検索: さまざまなフィルタリングオプションを使用して分散トレーススパンを検索します
• トレーススパンの集計: 分析のために異なるディメンションでトレーススパンを集計します

ツール

1. search_logs
   • Datadogでログを検索する
   • 入力:
     • filterQuery (オプションの文字列): ログを検索するためのクエリ文字列 (デフォルト: "*")
     • filterFrom (オプションの数値): UNIXタイムスタンプによる検索開始時刻（秒単位）（デフォルト: 15分前）
     • filterTo (オプションの数値): 検索終了時刻 (UNIX タイムスタンプ、秒単位) (デフォルト: 現在の時刻)
     • pageLimit (オプションの数値): 取得するログの最大数 (デフォルト: 25、最大: 1000)
     • pageCursor (オプションの文字列): 追加の結果を取得するためのページ区切りカーソル
   • 戻り値: 次の内容を含む書式設定されたテキスト:
     • 検索条件（クエリと時間範囲）
     • 見つかったログの数
     • 次のページカーソル（利用可能な場合）
     • 以下を含むログの詳細:
       • サービス名
       • タグ
       • タイムスタンプ
       • 状態
       • メッセージ（300文字以内）
       • ホスト
       • 重要な属性 (http.method、http.url、http.status_code、error)
2. search_spans
   • Datadogでトレーススパンを検索する
   • 入力:
     • filterQuery (オプションの文字列): 範囲を検索するクエリ文字列 (デフォルト: "*")
     • filterFrom (オプションの数値): UNIXタイムスタンプによる検索開始時刻（秒単位）（デフォルト: 15分前）
     • filterTo (オプションの数値): 検索終了時刻 (UNIX タイムスタンプ、秒単位) (デフォルト: 現在の時刻)
     • pageLimit (オプションの数値): 取得するスパンの最大数 (デフォルト: 25、最大: 1000)
     • pageCursor (オプションの文字列): 追加の結果を取得するためのページ区切りカーソル
   • 戻り値: 次の内容を含む書式設定されたテキスト:
     • 検索条件（クエリと時間範囲）
     • 見つかったスパンの数
     • 次のページカーソル（利用可能な場合）
     • スパンの詳細には以下が含まれます:
       • サービス名
       • タイムスタンプ
       • リソース名
       • 期間（秒）
       • ホスト
       • 環境
       • タイプ
       • 重要な属性 (http.method、http.url、http.status_code、error)
3. aggregate_spans
   • 指定されたディメンションで Datadog のトレース範囲を集計する
   • 入力:
     • filterQuery (オプションの文字列): 集計の範囲をフィルタリングするためのクエリ文字列 (デフォルト: "*")
     • filterFrom (オプションの数値): 開始時刻 (UNIX タイムスタンプ、秒単位) (デフォルト: 15 分前)
     • filterTo (オプションの数値): 終了時刻 (UNIX タイムスタンプ、秒単位) (デフォルト: 現在の時刻)
     • groupBy (オプションの文字列[]): グループ化するディメンション (例: ["service", "resource_name", "status"])
     • aggregation （オプションの文字列）：集計方法 - 「count」、「avg」、「sum」、「min」、「max」、「pct」（デフォルト：「count」）
     • interval （オプションの文字列）：時系列データの時間間隔（タイプが「timeseries」の場合のみ）
     • type (オプションの文字列): 結果の型。「timeseries」または「total」のいずれか (デフォルト:「timeseries」)
   • 戻り値: 次の内容を含む書式設定されたテキスト:
     • 集計結果はバケットにまとめられ、各バケットには次のものが含まれます。
       • バケットID
       • 値でグループ化する（groupByが指定されている場合）
       • 集計方法に基づいて計算された値
     • 追加のメタデータ:
       • 処理時間（経過）
       • リクエストID
       • 状態
       • 警告（ある場合）

設定

Datadog API とアプリケーション キーを設定する必要があります。

1. Datadog APIキーページからAPIキーとアプリケーションキーを取得します。
2. datadog-mcp プロジェクトに依存関係をインストールします。
   npm install # or pnpm install
3. TypeScript プロジェクトをビルドします。
   npm run build # or pnpm run build

Dockerのセットアップ

次のコマンドで Docker を使用してビルドできます。

Claude Desktopでの使用

Claude Desktop でこれを使用するには、 claude_desktop_config.jsonに以下を追加します。

Docker を使用している場合は、次のように設定できます。

VS Codeでの使用

VS Code で簡単にインストールするには、設定を構成します。

1. VS Code でユーザー設定 (JSON) を開く ( Ctrl+Shift+P → Preferences: Open User Settings (JSON) )
2. 次の構成を追加します。

Docker を使用している場合は、次のように設定できます。

あるいは、ワークスペースの.vscode/mcp.jsonファイルにこれを追加することもできます ( mcpキーなし)。

Docker を使用している場合は、次のように設定できます。