Grafana 仪表板同步代理

要解决什么问题

在多环境可观测性架构中，Grafana 实例往往不止一个：开发、测试、预发、生产各自有一套，仪表板面板（dashboard）却需要保持一致。手动导出 JSON 再导入的方式既慢又容易出错，文件夹层级和数据源 UID 在目标实例中通常对不上，导致同一份排障视图在不同环境里长得完全不一样。

核心能力

该技能基于 Grafana HTTP API v5 工作，负责三件事：

• 资源供应（provisioning）：按声明方式把仪表板写入目标实例，而不是靠人工点界面
• 文件夹管理：在目标实例中重建组织结构，保持来源的层级关系
• 数据源重映射：将面板内引用的数据源替换为目标环境实际可用的实例，避免面板渲染失败

典型工作流

1. 从来源实例读取仪表板定义（JSON 模型）
2. 在目标实例中解析或创建对应的文件夹
3. 逐面板处理数据源引用的替换
4. 通过 HTTP API v5 提交写入

这样一套流程适合多环境可观测性搭建场景：同一组面板在不同实例间流转时，保持结构一致、引用正确。

适用边界与注意事项

• 没有自动提取到安装与使用说明：官方资料中未能自动解析出完整的安装与使用流程，使用前需要自行通读上游项目仓库，理解其实现方式
• 敏感流程慎用：官方建议在敏感业务流中运行前，先审阅上游项目代码
• 依赖 API v5：技能绑定 Grafana HTTP API v5，目标实例的 API 版本需与之匹配
• 数据源映射是手动环节：不同环境的指标口径、标签体系可能不同，重映射只解决引用问题，不解决数据语义差异

源仓库：github.com/1991513ccie-png/skills