AngularJS 弃用时间线
AngularJS 支持已在 Grafana 9 中正式弃用。在 2024 年 5 月发布的 Grafana 11 中,所有 Grafana Cloud 和自托管安装默认关闭该功能。到 Grafana 12 版本时,将完全移除对 AngularJS 的支持,包括配置参数开关 angular_support_enabled。
AngularJS 插件迁移指南
以下是分步迁移方案:
-
检测是否使用 AngularJS 插件:
- 检查仪表板和面板中的警告图标
- 使用 detect-angular-dashboards 工具识别所有依赖 AngularJS 的仪表板
- 在管理页面的插件中心查看警告提示
-
更新插件至最新版本 :许多插件已完成从 AngularJS 到 React 的升级,直接更新可能解决问题 Grafana 移除 AngularJS 支持须知
-
核心可视化组件自动迁移:以下组件支持自动迁移:
- 旧版图表 → 时间序列
- 单值统计 → 统计面板
- 旧版统计 → 统计面板
- 旧版表格 → 表格
- 世界地图 → 地理地图
可通过启用功能开关autoMigrateOldPanels
或面板编辑器手动操作触发迁移 Grafana 移除 AngularJS 支持须知
-
其他插件处理 :参考 Angular 插件文档 获取迁移方案
-
自定义/私有插件迁移:需从 AngularJS 重写为 React,具体包括:
- 使用 React 重构插件
- 通过 JSON 专用字段实现编辑器定制
- 使用迁移处理器确保向后兼容
-
升级 Grafana 11 前测试 :通过设置
angular_support_enabled=false
模拟关闭 AngularJS 支持的环境进行验证
插件开发者可参照 配置设置迁移指南 进行改造。请注意:当 AngularJS 支持关闭后,所有依赖它的插件将无法加载,仪表板面板将不显示数据,请务必在升级至 Grafana 11 前完成迁移。
三人行, 必有我师; 知识共享, 天下为公. 本文由东风微鸣技术博客 EWhisper.cn 编写.