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 编写.

东风微鸣云原生
30 声望9 粉丝