update upgrade-note.md

Author: Frapschen

docs/zh/docs/insight/images/dashboard-discover.jpg renamed to docs/zh/docs/insight/images/upgrade-note01.jpg

@@ -17,12 +17,12 @@ kubectl delete grafanadatasources.grafana.integreatly.org -n insight-system --se
 
 这部分命令只清理了 insight-system 命名空间下的 CR, 其他命名空间可以用相同的方式处理。
 
-在 v0.40.x 的 grafana Deployment 会添加一个 [dashboard-discover](https://github.com/openinsight-proj/dashboard-discover) sidecar
+在 v0.40.x 的 grafana deployment 会添加一个 [dashboard-discover](https://github.com/openinsight-proj/dashboard-discover) sidecar
 用于将现有环境中特定的 GrafanaDashboard(v4)，ConfigMap 写入到 grafana dashboard provider 指定目录(/var/lib/grafana/plugins/dashboards)中。
 
 架构图如下：
 
-![img](../../images/dashboard-discover.jpg)
+![img](../../images/upgrade-note01.jpg)
 
 具体规则如下：
 
@@ -39,6 +39,33 @@ kubectl delete grafanadatasources.grafana.integreatly.org -n insight-system --se
 
 > 如果需要将 Json 文件存入特定文件夹中，可以在对应资源 label 中添加：`operator.insight.io/dashboard-folder=you-folder`
 
+在 v0.40.0 版本中， grafana 从 9.3.14 升级到 12.1.3。grafana 12.1.3 已完全移除对 AngularJS 的支持，转而优先支持 React。具体可以看[社区说明](https://grafana.com/blog/2025/04/03/angularjs-support-will-be-removed-in-grafana-12-what-you-need-to-know)。
+
+insight 以及兄弟团队维护的仪表盘已经自动迁移，开箱即用。对于客户自己维护的仪表盘，grafana 12.1.3 对部分核心预置（pre-installed）的
+AngularJS 面板提供自动迁移支持。在客户首次在 Grafana 12.1.3 打开自定义仪表盘后 grafana 会自动触发迁移, 迁移完成后，务必点击仪表盘的「Save」按钮保存变更，避免每次加载时重复迁移。
+
+若未完成 AngularJS 面板迁移，在 Grafana 12.1.3 后会出现以下问题：
+
+1. 依赖 AngularJS 的插件无法加载，在插件目录中不会显示已安装状态。
+2. 已配置的 AngularJS 数据源不会出现在数据源列表中。
+3. 仪表盘中原 AngularJS 面板会显示错误提示，如 `Error loading: plugin_name` 或 `Panel plugin not found: plugin_name`； 如下图：
+
+   <img src="../../images/upgrade-note02.png" alt="angularjs-deprecation-warning-panel" width="50%" />
+
+   可以手动替换类似的面板或插件。
+
+4. 仪表盘中原 Datasource 丢失，如 `Datasource XXX was not found`, 如下图：
+
+   <img src="../../images/upgrade-note03.png" alt="datasource-not-found" width="50%" />
+
+   可以手动创建一个 Datasource 变量:
+
+   <img src="../../images/upgrade-note04.png" alt="grafana-prometheus-ds-var" height="500" />
+
+   然后在面板中使用：
+
+   <img src="../../images/upgrade-note05.png" alt="grafana-use-prometheus-ds-var" width="30%" />
+
 
 ### 从 v0.26.x（或更低版本）升级到 v0.27.x 或更高版本