SuperAPI AI 工具集

datadog-automation

部署与运维

查看项目

更新于 10-15 10:21

技能介绍

用途

该技能用于通过 Rube MCP(Composio)自动执行 Datadog 的监控与可观测性任务,包括查询指标、搜索日志、管理监控器与仪表盘、创建事件与停机时间,以及查看主机与分布式追踪。

主要能力

  • 指标:列出可用指标名称,查询指标时间序列数据。
  • 日志:列出日志索引,按查询与过滤条件搜索日志。
  • 监控器:列出、查看、创建、更新、静音、取消静音监控器。
  • 仪表盘:列出、查看、更新、删除仪表盘。
  • 事件与停机:列出事件,创建事件,创建维护停机时间。
  • 主机与追踪:列报主机,按 ID 获取分布式追踪。

使用方式

前置条件:Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用);需通过 RUBE_MANAGE_CONNECTIONS(toolkit 为 datadog)建立有效的 Datadog 连接。始终先调用 RUBE_SEARCH_TOOLS 获取当前工具结构。

设置:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥,只需添加端点即可。确认 RUBE_SEARCH_TOOLS 可响应后,调用 RUBE_MANAGE_CONNECTIONS(toolkit 为 datadog)。若连接不是 ACTIVE,按返回的授权链接完成 Datadog 认证,确认状态为 ACTIVE 后再运行工作流。

核心工作流:

  1. 查询与探索指标:可选 DATADOG_LIST_METRICS,必选 DATADOG_QUERY_METRICS。关键参数包括 query(如 avg:system.cpu.user{host:web01})、from、to(Unix 秒)、q(搜索字符串)。
  2. 搜索与分析日志:可选 DATADOG_LIST_LOG_INDEXES,必选 DATADOG_SEARCH_LOGS。关键参数包括 query、from、to、sort、limit。
  3. 管理监控器:必选 DATADOG_LIST_MONITORS;可选 DATADOG_GET_MONITOR、CREATE_MONITOR、UPDATE_MONITOR、MUTE_MONITOR、UNMUTE_MONITOR。关键参数包括 monitor_id、name、type、query、message、tags、thresholds。
  4. 管理仪表盘:必选 DATADOG_LIST_DASHBOARDS;可选 GET_DASHBOARD、UPDATE_DASHBOARD、DELETE_DASHBOARD。关键参数包括 dashboard_id、title、layout_type、widgets、description。
  5. 创建事件与管理停机:可选 DATADOG_LIST_EVENTS;必选 DATADOG_CREATE_EVENT;可选 DATADOG_CREATE_DOWNTIME。事件参数包括 title、text、alert_type、tags;停机参数包括 scope、start、end、message、monitor_id。
  6. 管理主机与追踪:必选 DATADOG_LIST_HOSTS;可选 DATADOG_GET_TRACE_BY_ID。关键参数包括 filter、sort_field、sort_dir、trace_id。

适用场景

适用于需要通过 Rube MCP 在自动化流程中执行 Datadog 监控与可观测性操作的场景,例如查询指标、检索日志、管理监控器与仪表盘、发布事件、安排维护停机、查看主机与追踪等。

限制与注意事项

  • 时间戳:多数端点使用 Unix 秒级时间戳而非毫秒;部分端点接受 ISO 8601,需检查工具结构;时间范围应合理。
  • 查询语法:指标查询为 aggregation:metric{tags};日志查询为 field:value 对;监控器查询因类型而异。
  • 聚合值:有效聚合为 avg、sum、min、max、count;标签过滤使用花括号 {host:web01,env:prod},多标签为 AND 逻辑,支持 host:web* 通配符。
  • 监控器:type 必须与 query 类型匹配;message 支持 @mentions;thresholds 因类型而异;静音仅抑制通知,监控器仍会评估;monitor_id 为数字整数。
  • 仪表盘:dashboard_id 为字母数字字符串;layout_type 创建后不可更改;DELETE 不可撤销。
  • 停机:省略 end 会创建无限期停机;monitor_id 限定单个监控器,scope 作用于所有匹配监控器。
  • 分页:根据端点使用 page/page_size 或 offset 分页;检查 total 判断是否还有页。
  • 速率限制:Datadog API 有按端点的速率限制;遇 429 应退避;尽量批量操作。