Grafana 仪表板 JSON 迁移工具

仪表板跨实例迁移的常见痛点

当需要把 Grafana 仪表板从开发环境搬到预发或生产环境时，直接复制 JSON 往往带来一串连锁问题。数据源 UID 在源实例中是唯一标识，但到了目标实例可能完全不存在；文件夹层级可能在目标环境里被重组，导致仪表板散落或权限错乱；如果仪表板里还挂了告警规则，引用也可能因为 ID 变化而失效。

核心能力与关键步骤

这个技能通过 Grafana HTTP API 拉取源实例的仪表板 JSON，然后按目标环境做三类转换：

• 数据源 UID 替换：解析 JSON 中的数据源引用，根据目标实例的配置映射到可用的 UID。
• 文件夹结构重组：处理 folderUid 和 folderTitle，把仪表板放进目标环境对应的目录，而不是照搬源路径。
• 告警规则引用修正：识别 alertRuleRef 类字段，同步更新告警规则 ID 或 UID，避免告警静默失效。

最后通过 HTTP API 将转换后的 JSON 重新发布到目标实例，完成跨环境提升。

适用边界与注意点

适合做开发到生产、测试到预发的环境间迁移，但不适合一次性迁移整套 Grafana 实例，也不处理权限和告警通道配置。建议在测试实例上先跑一遍，确认 UID 映射规则和文件夹结构无误后再用到正式环境。