用途
该技能用于借助 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 相关服务范围内。关于收费、价格、平台支持范围等信息,资料暂未提供。