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應用密鑰。

💻 使用示例

基礎用法

查詢日誌

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

聚合跟蹤數據

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

高級用法

與Claude Desktop集成

在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 使用

如果使用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>"
      }
    }
  }
}

📚 詳細文檔

工具指南

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：操作耗時（秒）。

🔧 問題排查

如遇問題，請檢查以下幾點：

1. 確保環境變量已正確設置。
2. 網絡連接正常，可訪問Datadog服務。
3. 日誌和跟蹤數據已被正確索引。

如有其他疑問或需要進一步幫助，請聯繫技術支持團隊。