Datadog MCP Server

🚀 Datadog MCP 服务器文档（中文翻译）

Datadog MCP 服务器提供强大的日志和跟踪数据处理功能，支持搜索、过滤和聚合操作，能帮助用户高效分析数据。

🚀 快速开始

Datadog MCP 服务器可通过 npm 全局安装，安装后需配置环境变量以连接 Datadog 服务。安装和配置完成后，即可使用相关工具进行日志和跟踪数据的搜索与聚合操作。

✨ 主要特性

• 日志搜索：支持通过关键词、时间范围等条件查询日志数据。
• 跟踪跨度搜索：允许根据服务名称、操作和时间戳过滤跟踪数据。
• 聚合功能：能够对日志和跟踪数据进行统计分析，例如计算特定事件的发生次数。

📦 安装指南

快速安装

通过 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

📚 详细文档

工具指南

1. search_logs 工具

功能描述

用于查询和检索日志数据，支持多种过滤条件和排序选项。

输入参数

返回结果

2. search_spans 工具

功能描述

用于查询和检索跟踪数据，支持基于服务名称和服务操作的过滤。

输入参数

返回结果

3. aggregate 工具

功能描述

对日志或跟踪数据进行统计聚合，支持多种分组和汇总方式。

输入参数

返回结果

使用说明

与 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. 确保环境变量已正确设置。
2. 网络连接正常，可访问 Datadog 服务。
3. 日志和跟踪数据已被正确索引。

如有其他疑问或需要进一步帮助，请联系技术支持团队。