SuperAPI AI 工具集

datadog

部署与运维

查看项目

更新于 10-16 06:38

技能介绍

用途

该技能用于借助 Datadog MCP 工具,对 Gram 项目进行可观测性排查,覆盖日志、指标、链路追踪(Traces & Spans)、事件与监控(Incidents & Monitors)、RUM 与事件流,以及服务与基础设施信息。当用户询问错误、性能问题等相关内容时激活使用。

Gram 服务范围

查询 Datadog 时,应始终按相关服务进行过滤:

  • gram:Dashboard 前端(RUM)
  • gram-dashboard:Dashboard 后端
  • gram-server:主后端 API 服务器
  • gram-worker:Temporal worker
  • fly:Fly.io,Gram Functions 日志的收集位置

主要能力(可用工具)

除非用户明确要求其他工具,否则仅使用以下 Datadog MCP 工具:

日志:

  • mcp__datadog-mcp__search_datadog_logs — 搜索并过滤日志事件
  • mcp__datadog-mcp__analyze_datadog_logs — 分析日志模式并聚合统计

指标:

  • mcp__datadog-mcp__get_datadog_metric — 获取指定指标的时间序列数据
  • mcp__datadog-mcp__get_datadog_metric_context — 获取指标的上下文与元数据
  • mcp__datadog-mcp__search_datadog_metrics — 按名称搜索可用指标

链路与 Span:

  • mcp__datadog-mcp__get_datadog_trace — 按 ID 获取指定链路
  • mcp__datadog-mcp__search_datadog_spans — 搜索 Span(适用于延迟排查)

事件与监控:

  • mcp__datadog-mcp__search_datadog_incidents — 搜索活跃/近期事件
  • mcp__datadog-mcp__get_datadog_incident — 获取指定事件详情
  • mcp__datadog-mcp__search_datadog_monitors — 查找监控项及其当前状态

RUM 与事件:

  • mcp__datadog-mcp__search_datadog_rum_events — 搜索真实用户监控事件(前端错误、会话)
  • mcp__datadog-mcp__search_datadog_events — 搜索 Datadog 事件流

服务与基础设施:

  • mcp__datadog-mcp__search_datadog_services — 发现 APM 中的服务
  • mcp__datadog-mcp__search_datadog_service_dependencies — 查看服务依赖关系图

使用方式与排查指引

  • 在可用时,始终使用 service 过滤器将一个或多个 Gram 服务限定为查询范围。
  • 先窄后宽:先查询 15–30 分钟的时间窗口,再按需扩大。
  • 错误排查:先使用 search_datadog_logs,按 status:error 过滤,再用 get_datadog_trace 沿 trace ID 追踪。
  • 延迟问题:使用 search_datadog_spans,配合 service:<name> 并按 duration 排序。
  • 前端问题:优先使用 search_datadog_rum_events 查询 gram。
  • 事件排查:先检查 search_datadog_incidents,再深入日志。

适用场景

适用于针对 Gram 项目的错误调查、性能与延迟分析、前端错误与会话排查、事件与监控状态查询,以及服务发现与依赖关系查看。

限制

除上述工具外,除非用户明确要求,否则不应使用其他 Datadog MCP 工具。查询需限定在 Gram 相关服务范围内。关于收费、价格、平台支持范围等信息,资料暂未提供。