Grafana 仪表板组装器

你要解决的问题

手写 Grafana 仪表板 JSON 时，panels 数组、targets 查询结构、templating.list 变量声明和 annotations.list 注解查询分散在不同层级，拼接起来容易出错：面板类型与 fieldConfig 不匹配、数据源 uid 写成不存在的值，或模板变量的 query 格式不符合后端期望，导致保存后面板报错或刷新无数据。

技能如何工作

围绕运维仪表板的常见形态，按以下方式组装模型：

• 选择面板类型：根据指标含义组装 timeseries（趋势）、stat（单值概览）、table（明细列表）和 heatmap（分布热力），并生成对应 panelId。
• 配置数据源引用：为每个 target 填入正确的 datasource.uid，避免混用不同环境的 Prometheus 或 Elasticsearch 实例。
• 声明模板变量：在 templating.list 中生成变量项，支持下拉选择或多选，并把变量引用（如 $metric）写入查询表达式。
• 加入注解查询：在 annotations.list 中配置事件或日志注解源，让异常时间点在图上可见。

适用边界

生成结果面向标准 Grafana JSON 模型，未包含数据源自动探测、实时查询验证或告警规则生成。仓库未提供可验证的安装与使用说明，接入敏感流程前应先在测试实例中审查生成的 JSON。

推荐实践

• 先确认环境中已存在对应的 datasource，再让组装器引用 uid。
• 用变量替换固定时间范围，方便同一仪表板跨服务复用。
• 保存前在 Grafana UI 打开 Explore 视图验证查询是否返回数据。