Grafana将弃用AngularJS-我们该如何迁移

AngularJS 弃用时间线

AngularJS 支持已在 Grafana 9 中正式弃用。在 2024 年 5 月发布的 Grafana 11 中，所有 Grafana Cloud 和自托管安装默认关闭该功能。到 Grafana 12 版本时，将完全移除对 AngularJS 的支持，包括配置参数开关 angular_support_enabled。

AngularJS 插件迁移指南

以下是分步迁移方案：

1. 检测是否使用 AngularJS 插件：

   • 检查仪表板和面板中的警告图标
   • 使用 detect-angular-dashboards 工具识别所有依赖 AngularJS 的仪表板
   • 在管理页面的插件中心查看警告提示

2. 更新插件至最新版本：许多插件已完成从 AngularJS 到 React 的升级，直接更新可能解决问题 Grafana 移除 AngularJS 支持须知

3. 核心可视化组件自动迁移：以下组件支持自动迁移：

   • 旧版图表 → 时间序列
   • 单值统计 → 统计面板
   • 旧版统计 → 统计面板
   • 旧版表格 → 表格
   • 世界地图 → 地理地图
     
     可通过启用功能开关 autoMigrateOldPanels 或面板编辑器手动操作触发迁移 Grafana 移除 AngularJS 支持须知

4. 其他插件处理：参考 Angular 插件文档 获取迁移方案

5. 自定义/私有插件迁移：需从 AngularJS 重写为 React，具体包括：

   • 使用 React 重构插件
   • 通过 JSON 专用字段实现编辑器定制
   • 使用迁移处理器确保向后兼容

6. 升级 Grafana 11 前测试：通过设置 angular_support_enabled=false 模拟关闭 AngularJS 支持的环境进行验证

插件开发者可参照 配置设置迁移指南 进行改造。请注意：当 AngularJS 支持关闭后，所有依赖它的插件将无法加载，仪表板面板将不显示数据，请务必在升级至 Grafana 11 前完成迁移。

三人行, 必有我师; 知识共享, 天下为公. 本文由东风微鸣技术博客 EWhisper.cn 编写.