Datadog MCP Server

🚀 Datadog MCP サーバードキュメント

Datadog MCP サーバーは、ログとトレースデータの検索や分析を行うためのツールです。このドキュメントでは、その主要な機能や使用方法、インストール手順などを説明します。

✨ 主な機能

• ログ検索：キーワードや時間範囲などの条件を使って、ログデータを検索できます。
• トレーススパン検索：サービス名、操作、タイムスタンプなどに基づいて、トレースデータをフィルタリングできます。
• 集計機能：ログとトレースデータに対して統計分析を行い、特定のイベントの発生回数などを計算できます。

📦 インストール

クイックインストール

npm を使ってグローバルにインストールします。

npm install -g @your-org/datadog-mcp-server

環境変数の設定

Datadog サービスに接続するために、以下の環境変数を設定します。

• DD_API_KEY：必須。Datadog API キーです。
• DD_APP_KEY：必須。Datadog アプリキーです。

📚 ドキュメント

ツールガイド

1. search_logs ツール

機能説明

ログデータを検索および取得するためのツールで、様々なフィルタ条件とソートオプションをサポートしています。

入力パラメータ

• query：必須。検索キーワードまたはフレーズです。
• start_time：オプション、デフォルトは現在の時間から24時間前。開始時間を指定します。形式はYYYY-MM-DDTHH:MM:SSZです。
• end_time：オプション、デフォルトは現在の時間。終了時間を指定します。形式は上記と同じです。
• sort_by：オプション、デフォルトは時間でソート。サポートされるフィールドにはtimestamp, log_level, message_lengthがあります。

返却結果

• logs：一致するログのリストで、各ログにはタイムスタンプ、ログレベル、ソース、メッセージ内容が含まれます。
• total_count：総一致数です。
• duration：検索にかかった時間（秒）です。

2. search_spans ツール

機能説明

トレースデータを検索および取得するためのツールで、サービス名とサービス操作に基づくフィルタリングをサポートしています。

入力パラメータ

• service_name：オプション。フィルタリングするサービス名を指定します。
• operation_name：オプション。フィルタリングする操作名を指定します。
• start_time：上記と同じ。
• end_time：上記と同じ。
• sort_by：timestamp, span_id, durationをサポートします。

返却結果

• spans：一致するトレースのリストで、各トレースにはタイムスタンプ、スパンID、持続時間、関連情報が含まれます。
• total_count：総一致数です。
• duration：検索にかかった時間（秒）です。

3. aggregate ツール

機能説明

ログまたはトレースデータに対して統計的な集計を行い、様々なグループ化と集計方法をサポートしています。

入力パラメータ

• resource：必須。集計するリソースのタイプを指定します。例えばlogs または spansです。
• group_by：オプション、デフォルトは時間粒度（5分）でグループ化。カスタムフィールドによるグループ化もサポートしています。
• aggregations：オプション、デフォルトはcount。sum, avg, min, maxなどの他の統計方法もサポートしています。

返却結果

• result：集計後のデータのリストで、各エントリにはグループ化情報と対応する統計値が含まれます。
• stats：総レコード数、平均値などのグローバルな統計データを提供します。
• duration：操作にかかった時間（秒）です。

使用方法

Claude Desktop との統合

claude_desktop_config.jsonに以下の設定を追加します。

{
  "mcpServers": {
    "datadog": {
      "command": "node",
      "args": [
        "/path/to/datadog-mcp-server/index.js"
      ],
      "env": {
        "DD_API_KEY": "<YOUR_DATADOG_API_KEY>",
        "DD_APP_KEY": "<YOUR_DATADOG_APP_KEY>"
      }
    }
  }
}

Docker を使用する場合

以下のように設定します。

{
  "mcpServers": {
    "datadog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DD_API_KEY=your_api_key_here",
        "-e",
        "DD_APP_KEY=your_app_key_here",
        "datadog-mcp-server:latest"
      ]
    }
  }
}

VS Code の設定

ユーザー設定（JSON形式）に以下の内容を追加します。

{
  "mcpServers": {
    "datadog": {
      "command": "node",
      "args": [
        "/path/to/datadog-mcp-server/index.js"
      ],
      "env": {
        "DD_API_KEY": "<YOUR_DATADOG_API_KEY>",
        "DD_APP_KEY": "<YOUR_DATADOG_APP_KEY>"
      }
    }
  }
}

💻 使用例

ログの検索

search_logs --query="error" --start_time="2023-10-01T00:00:00Z"

トレースデータの集計

aggregate --resource=spans --group_by=service_name --aggregations=count,duration_avg

🔧 問題解決

問題が発生した場合は、以下の点を確認してください。

1. 環境変数が正しく設定されていることを確認します。
2. ネットワーク接続が正常で、Datadog サービスにアクセスできることを確認します。
3. ログとトレースデータが正しくインデックス付けされていることを確認します。

その他の質問や追加の支援が必要な場合は、技術サポートチームにお問い合わせください。