Datadog MCP 服务器

免责声明：这是一个社区维护的项目，与 Datadog, Inc. 没有官方关联、认可或支持。此 MCP 服务器利用 Datadog API，但作为模型上下文协议生态系统的一部分独立开发。

Datadog API 的 MCP 服务器，支持事件管理等。

特征

• 可观察性工具：提供一种机制，通过 MCP 服务器利用关键 Datadog 监控功能，例如事件、监视器、日志、仪表板和指标。

• 可扩展设计：设计用于轻松与其他 Datadog API 集成，从而实现未来的无缝功能扩展。

Related MCP server: Duck Duck MCP

工具

1. list_incidents

   • 从 Datadog 检索事件列表。

   • 输入：

     • filter （可选字符串）：事件的过滤参数（例如，状态、优先级）。

     • pagination （可选对象）：分页详细信息，如页面大小/偏移量。

   • 返回：Datadog 事件和相关元数据的数组。

2. get_incident

   • 检索有关特定 Datadog 事件的详细信息。

   • 输入：

     • incident_id （字符串）：要获取详细信息的事件 ID。

   • 返回：详细事件信息（标题、状态、时间戳等）。

3. get_monitors

   • 获取 Datadog 监视器的状态。

   • 输入：

     • groupStates （可选数组）：要过滤的状态（例如，警报、警告、无数据、正常）。

     • name （可选字符串）：按名称过滤。

     • tags （可选数组）：按标签过滤。

   • 返回：监控数据及其状态摘要。

4. get_logs

   • 从 Datadog 搜索并检索日志。

   • 输入：

     • query （字符串）：Datadog 记录查询字符串。

     • from （数字）：以纪元秒为单位的开始时间。

     • to （数字）：以纪元秒为单位的结束时间。

     • limit （可选数字）：返回的最大日志数量（默认为 100）。

   • 返回：匹配日志的数组。

5. list_dashboards

   • 从 Datadog 获取仪表板列表。

   • 输入：

     • name （可选字符串）：按名称过滤仪表板。

     • tags （可选数组）：按标签过滤仪表板。

   • 返回：带有 URL 引用的仪表板数组。

6. get_dashboard

   • 从 Datadog 检索特定的仪表板。

   • 输入：

     • dashboard_id （字符串）：要获取的仪表板的 ID。

   • 返回：仪表板详细信息，包括标题、小部件等。

7. query_metrics

   • 从 Datadog 检索指标数据。

   • 输入：

     • query （字符串）：指标查询字符串。

     • from （数字）：以纪元秒为单位的开始时间。

     • to （数字）：以纪元秒为单位的结束时间。

   • 返回：查询时间范围的指标数据。

8. list_traces

   • 从 Datadog 检索 APM 跟踪列表。

   • 输入：

     • query （字符串）：Datadog APM 跟踪查询字符串。

     • from （数字）：以纪元秒为单位的开始时间。

     • to （数字）：以纪元秒为单位的结束时间。

     • limit （可选数字）：要返回的最大跟踪数（默认为 100）。

     • sort （可选字符串）：跟踪的排序顺序（默认为“-timestamp”）。

     • service （可选字符串）：按服务名称过滤。

     • operation （可选字符串）：按操作名称过滤。

   • 返回：来自 Datadog APM 的匹配跟踪数组。

9. list_hosts

   • 从 Datadog 获取主机列表。

   • 输入：

     • filter （可选字符串）：搜索结果的过滤字符串。

     • sort_field （可选字符串）：用于对主机进行排序的字段。

     • sort_dir （可选字符串）：排序方向（升序/降序）。

     • start （可选数字）：分页的起始偏移量。

     • count （可选数字）：要返回的最大主机数（最大值：1000）。

     • from （可选数字）：从此 UNIX 时间戳搜索主机。

     • include_muted_hosts_data （可选布尔值）：包括静音主机状态和到期时间。

     • include_hosts_metadata （可选布尔值）：包含主机元数据（版本、平台等）。

   • 返回：主机数组，其中包含名称、ID、别名、应用程序、静音状态等详细信息。

10. get_active_hosts_count

• 获取 Datadog 中活跃主机的总数。

• 输入：

  • from （可选数字）：您想要获取活动主机总数的秒数（默认为 2 小时）。

• 返回：活跃和正常运行的主机总数。

11. mute_host

• 在 Datadog 中将主机静音。

• 输入：

  • hostname （字符串）：要静音的主机的名称。

  • message （可选字符串）：与此主机静音相关的消息。

  • end （可选数字）：静音结束的 POSIX 时间戳。

  • override （可选布尔值）：如果为真并且主机已静音，则替换现有的结束时间。

• 返回：成功状态和确认消息。

12. unmute_host

• 在 Datadog 中取消主机静音。

• 输入：

  • hostname （字符串）：要取消静音的主机的名称。

• 返回：成功状态和确认消息。

13. list_downtimes

• 列出 Datadog 的计划停机时间。

• 输入：

  • currentOnly （可选布尔值）：为真时仅返回当前活动的停机时间。

  • monitorId （可选数字）：按监视器 ID 过滤。

• 返回：计划停机时间数组，其中包含范围、监控信息和计划等详细信息。

14. schedule_downtime

• 在 Datadog 中安排停机时间。

• 输入：

  • scope （字符串）：应用停机时间的范围（例如“host：my-host”）。

  • start （可选数字）：停机开始的 UNIX 时间戳。

  • end （可选数字）：停机结束的 UNIX 时间戳。

  • message （可选字符串）：包含在停机时间内的消息。

  • timezone （可选字符串）：停机时间的时区（例如“UTC”、“America/New_York”）。

  • monitorId （可选数字）：要静音的监视器的 ID。

  • monitorTags （可选数组）：用于过滤的监视器标签列表。

  • recurrence （可选对象）：停机时间的重复设置。

    • type （字符串）：重复类型（“天”、“周”、“月”、“年”）。

    • period （数字）：重复的频率（必须> = 1）。

    • weekDays （可选数组）：每周重复的星期几。

    • until （可选数字）：循环结束时的 UNIX 时间戳。

• 返回：计划停机详细信息，包括 ID 和活动状态。

15. cancel_downtime

• 取消 Datadog 中的预定停机时间。

• 输入：

  • downtimeId （数字）：要取消的停机时间的 ID。

• 返回：停机取消确认。

16. get_rum_applications

• 获取组织内的所有 RUM 应用程序。

• 输入：无。

• 返回：RUM 应用程序列表。

17. get_rum_events

• 从 Datadog 搜索并检索 RUM 事件。

• 输入：

  • query （字符串）：Datadog RUM 查询字符串。

  • from （数字）：以纪元秒为单位的开始时间。

  • to （数字）：以纪元秒为单位的结束时间。

  • limit （可选数字）：要返回的最大事件数（默认值：100）。

• 返回：RUM 事件数组。

18. get_rum_grouped_event_count

• 按指定维度搜索、分组和计数 RUM 事件。

• 输入：

  • query （可选字符串）：RUM 搜索的附加查询过滤器（默认值：“*”）。

  • from （数字）：以纪元秒为单位的开始时间。

  • to （数字）：以纪元秒为单位的结束时间。

  • groupBy （可选字符串）：按维度对结果进行分组（默认值：“application.name”）。

• 返回：分组事件计数。

19. get_rum_page_performance

• 从 RUM 数据中获取页面（视图）性能指标。

• 输入：

  • query （可选字符串）：RUM 搜索的附加查询过滤器（默认值：“*”）。

  • from （数字）：以纪元秒为单位的开始时间。

  • to （数字）：以纪元秒为单位的结束时间。

  • metricNames （字符串数组）：要检索的指标名称数组（例如，“view.load_time”、“view.first_contentful_paint”）。

• 返回：性能指标，包括每个指标的平均值、最小值、最大值和计数。

20. get_rum_page_waterfall

• 检索按应用程序名称和会话 ID 过滤的 RUM 页面（视图）瀑布数据。

• 输入：

  • applicationName （字符串）：用于过滤事件的应用程序名称。

  • sessionId （字符串）：用于过滤事件的会话 ID。

• 返回：指定应用程序和会话的瀑布数据。

设置

Datadog 凭证

您需要有效的 Datadog API 凭证才能使用此 MCP 服务器：

• DATADOG_API_KEY ：您的 Datadog API 密钥

• DATADOG_APP_KEY ：您的 Datadog 应用程序密钥

• DATADOG_SITE （可选）：Datadog 网站（例如datadoghq.eu ）

在运行服务器之前将它们导出到您的环境中：

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Datadog MCP 服务器：

手动安装

与 Claude Desktop 一起使用

要将其与 Claude Desktop 一起使用，请将以下内容添加到您的claude_desktop_config.json中：

在 MacOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上： %APPDATA%/Claude/claude_desktop_config.json

或者通过npx指定：

调试

由于 MCP 服务器通过标准输入/输出进行通信，调试有时会比较棘手。我们建议使用MCP 检查器。您可以使用以下命令运行检查器：

检查器将提供一个 URL，您可以在浏览器中打开它来查看日志并手动发送请求。

贡献

欢迎贡献代码！如果您有任何建议、错误报告或改进建议，欢迎随时提交问题或拉取请求。

执照

该项目采用Apache 许可证 2.0 版授权。