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 （可选字符串）：结果类型，可以是“时间序列”或“总计”（默认值：“时间序列”）
   • 返回：格式化文本，包含以下内容：
     • 聚合结果存储在 buckets 中，每个 buckets 包括：
       • 存储桶 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，您可以像这样配置它：