如何通过程序化方式批量更新Grafana Data Links中适配新域名的URL

针对几十到上百个仪表盘的Data Links域名替换需求，完全不需要逐页手动修改，Grafana的全量配置是结构化JSON存储的，完全支持程序化批量处理，以下是按推荐优先级排序的落地方案：

方案一：通过Grafana官方API遍历批量修改（50个仪表盘规模下最优解，无侵入、低风险） #

• 权限准备：在Grafana服务账号中创建具备仪表盘读取、仪表盘写入权限的API访问令牌，无需获取数据库权限
• 执行流程：
  1. 调用Grafana仪表盘搜索接口，拉取环境内所有仪表盘的唯一标识（uid）、当前版本号
  2. 对每个仪表盘的uid调用详情接口，获取完整的仪表盘配置JSON结构
  3. 递归遍历JSON的所有节点，定位到所有Data Links的配置项（覆盖面板级链接、字段级链接两类配置），对配置项中的URL字段做正则匹配：精确匹配旧域名的完整字符串，替换为新域名的对应部分，全程保留URL中的原有路径、查询参数、Grafana变量占位符（如${__from}、$自定义变量这类语法不做修改）
  4. 把替换完成的JSON结构，通过仪表盘更新接口提交回Grafana，提交时带上原仪表盘的版本号，避免版本冲突覆盖
• 配套保障：所有拉取到的原始仪表盘JSON先本地全量备份，一旦替换逻辑出现偏差，可以直接通过回传原始JSON恢复配置

方案二：后端存储层批量文本替换（适合超大规模仪表盘集群，50个报表场景不推荐） #

如果Grafana实例的仪表盘规模达到数千个，逐API遍历效率偏低，可以直接操作后端存储（默认关系型数据库的dashboard表）：

• 提前开启Grafana维护模式，暂停所有用户的仪表盘写操作，避免操作过程中的配置变更造成数据不一致
• 对存储表中存储仪表盘JSON的文本字段，做正则匹配替换旧域名部分，替换后必须逐条校验JSON结构合法性，避免破坏JSON转义规则导致仪表盘加载失败
• 替换完成后重启Grafana服务，抽样验证仪表盘的Data Links配置
• 风险提示：操作前必须对整张存储表做全量备份，无备份不建议直接操作数据库

长期优化：用全局变量解耦写死的域名，避免后续重复操作 #

完成本次域名替换后，可以做一次架构优化从根源减少后续重复工作：

• 在Grafana的全局设置中新增一个隐藏的自定义变量，比如命名为$link_base_domain，变量值配置为当前的外部域名
• 把所有Data Links中写死的域名部分，替换为拼接变量的形式：https://${link_base_domain}/实际路径
• 后续如果再发生域名变更，只需要修改这一个全局变量的默认值，所有关联的Data Links会自动生效，不需要再遍历仪表盘修改

操作避坑要点 #

• 正则匹配时尽量精确匹配旧域名的完整前缀，避免误伤URL中其他位置的同名字符串
• 全程不要修改URL里的Grafana变量语法、原有查询参数，只替换固定的域名字符串部分
• 替换完成后抽样点击若干Data Link，确认跳转后的时间范围、参数传递和原配置完全一致，没有被字符串替换截断

内容的提问来源于stack exchange，提问作者tenet testuser1