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 前完成遷移。