用途:该技能用于创建、编辑或评审 Datadog 仪表盘,尤其是通过程序化方式组装的看板,也适用于编写发往组件的 Datadog 查询、选择可视化类型,或排查面板显示“No data”、数值不被信任、随时间范围变化等问题。
前提与用法:假定已连接 Datadog MCP 服务器(https://mcp.<site>/v1/mcp,toolsets=dashboards,widgets)。组件 schema 不在此技能中复述,由 get_widget_reference 在调用时返回最新内容;若服务器未连接需先配置。技能不覆盖 Terraform 或原始 Dashboard API 管理,也不涉及监控器、SLO 定义、Datadog 埋点或非 Datadog 平台。
规则结构:内容按七类组织。用途与范围(scope-)关注受众、决策、变量替代重复,以及何时不该用仪表盘;账户数据核对(disco-)要求在查询前确认指标、标签和 facet 存在;查询语义(query-)修正会返回数字但实际错误的查询;组件选择(widget-)将问题匹配到可视化;仪表盘 JSON(json-)处理组件校验看不到的问题;布局可读性(layout-)遵循 Datadog 结构规范;发布(ship-)要求写前验证与冒烟测试,并注意区域端点。
关键点示例:UI 会自动追加 .as_count() 而 API 不会,且默认用 avg 汇总;百分位需要启用百分位的分布;比率应先聚合再相除;仪表值默认会对最多 5 分钟空档插值;日志与跨度查询采用 search+compute+group_by,间隔为毫秒,百分位写作 pc95;查询作用域语法不可混用;已弃用的 q、default、is_read_only、week_before() 仍可解析。EU、AP、UK 组织需使用各自的 MCP 主机,GovCloud 不支持。建议先运行 scope-ask-audience-and-decision 与 disco-never-invent-metric-names,再输出任何内容。
限制:资料未提供具体价格、平台支持范围或效果保证,相关信息暂未提供;所有断言以 2026 年 7 月文档为准,使用前应重新核对版本相关变化。