Grafana 13.3：自 Grafana 7 以来最大的一次界面翻新，外加跨仪表盘变量和 Notebook
如果你在国内用自建 Grafana 托管了几百块大盘，升级这件事大概永远排在季度运维清单的中段——不是不敢升，而是升完发现”配置漂移”比想象中更难收拾。Grafana 13.3 的官方发布说明，通篇在回答一个问题：怎么让”共用同一个变量”这件事不必在每个大盘里各写一遍。
这个版本 2026 年 10 月 29 日由 Grafana Labs 团队发布，自称是 Grafana 7 以来最大的一次视觉改版（visual refresh）的第一阶段，同时带来三种新的一等公民：跨仪表盘变量（cross-dashboard variables）、Notebook 调查文档、以及可预览、可撤销的 Grafana Assistant 看板生成流程。
先说最要命的那条：变量可以只定义一次
在 13.3 之前，如果你的 30 块大盘都要用”环境 / 区域 / 集群”这几个选择器，你得在 30 块大盘里各配一遍。新增一个 region 意味着改 30 个 JSON，改漏一个就出现”同一块大盘在不同人手里显示不同数据”的经典事故。
13.3 引入的跨仪表盘变量把变量提到组织级统一管理：
| 作用域 | 可见范围 | 典型用法 |
|---|---|---|
| Global | 组织内每一块大盘 | 环境、区域、租户这类全局维度 |
| Folder | 同一文件夹下的大盘 | 业务线内部的集群选择器 |
配置入口在 Dashboards > Variables。编辑大盘时从侧边栏添加变量，Grafana 只显示当前作用域内可用的那些，可以逐个添加也可以一次全加。查看者仍然可以在大盘上改值，但配置本身由中心统一维护——这一句话正是治”配置漂移”的那一味药。
自建环境需要手动打开 grafana.dashboardGlobalVariables feature toggle；Grafana Cloud 与所有版本目前是 public preview 状态。
图：跨仪表盘变量支持 Global 与 Folder 两种作用域（图片来源：Grafana Labs 官方博客）
Notebook：把一次排查的证据链留在一个文档里
Notebook 是 13.3 引入的新 artifact 类型，用途非常具体：把散落在各个标签页、截图和聊天记录里的调查过程，收进一份可编辑、可分享的文档。
一份 Notebook 里可以同时放：
- – 来自大盘的 panel
- – Explore 里跑出来的查询
- – Grafana Assistant 给出的结论
- – 你自己写在数据旁边的推理过程
官方列出的三个典型场景是：边查边记的探索式提问、留档避免下一个人从头再来、以及已经把相关 panel 都摆好的事后复盘（post-incident review）。
新建的 Notebooks 页面支持搜索、筛选、编辑和导出。自建环境同样是 feature toggle 起步（dashboard.notebooks），Cloud 侧在逐步放量。
图：Notebook 中可将面板、Explore 查询与结论并排存放（图片来源：Grafana Labs 官方博客）
视觉翻新：官方反复强调”这不是重设计”
13.3 的第一阶段视觉翻新包含：新的一套默认深色与浅色主题（每个主题色都重做，并留出更多明暗档位）、更柔和的边框与圆角、重新调整尺寸的输入框/下拉/按钮/标签、混用字重与字号的全新字体阶梯。
图：13.3 引入的新默认主题与更柔和的边框、圆角（图片来源：Grafana Labs 官方博客）
对运维和插件开发者来说，最该记住的是官方给的三条边界：
- 1. 这是 visual refresh，不是 redesign——既有工作流与导航结构不变；
- 2. 对插件没有破坏性变更——使用标准 Grafana 组件与 theme token 的插件会自动继承新外观，自定义样式的插件可以按自己的节奏迁移；
- 3. 随时可以切回去——自建环境打开
grafana.visualDesignRefresh即可试用，不满意能退回旧设计。
Assistant：先给方案，再生成，还能一键撤销
AI 辅助建大盘这条线在 13.3 里补上了两个关键环节。
dashboard plans（public preview）：你描述想监控什么，Assistant 先在对话里给出一份只读方案——包含大盘标题、tab 或 row、panel、可视化类型和变量。确认无误再点 Build 真正生成。
图：dashboard plans 让生成的图表类型和变量在动手前就可以被审阅（图片来源：Grafana Labs 官方博客）
Undo turn（GA）：Assistant 改完大盘后可以一键回退到上一状态；如果一次请求改了多个 panel，可以一次性全部撤销。
除了这四件事，还有这些
13.3 的完整清单很长，但对自建用户更有用的部分大致可以归成三类：
| 类别 | 代表功能 | 状态 |
|---|---|---|
| 仪表盘 | Panel 副标题、Panel 时间设置与时段对比、多字段 Sort by 变换、静态 refId 保持变换链稳定、阈值支持变量插值 | 多为 GA |
| 告警 | 从 Prometheus / Mimir 直接导入 Alertmanager 配置、Alert Advisor 给出规则质量建议 | public preview |
| 运维 | 可关闭的公告横幅（incident / maintenance 通知）、Git Sync 文件夹内 Markdown 自动渲染为带 Mermaid 的标签页 | GA / preview |
唯一的破坏性变更与界面无关，而是权限：有权限管理角色或角色分配的管理员，现在可以撤销自己不持有的访问权限（涉及 /api/access-control/ 相关操作）。如果你把角色管理委派给了他人，这条需要提前复核一遍授权边界。
小夏点评
一、跨仪表盘变量真正解决的不是”少配几遍”，而是”谁有权改”。 过去一个大盘上写着哪个 region，用户改的是查询条件；现在变量配置集中到组织级，用户改的还是查询条件，但配置本身变成了一个需要权限、需要评审、需要审计的对象。这对国内团队尤其重要——很多单位的大盘变量是运维随手加的，加着加着就没人知道哪个变量在多少块大盘里被引用了。13.3 之后，这种”影子变量”会自然收敛到 Variables 页面里。建议升级前先把现有变量盘一遍：能提到全局的就提，提不动的注明原因，别指望新版本替你做这事。
二、Notebook 是这次更新里最容易被低估、也最容易用错的功能。 它的价值不在于”能写文档”，而在于把排查时的证据和推理留在了 Grafana 内部——过去一次线上排查的产物是几个截图和一段群聊记录，散落在各处；现在 panel、查询、结论、备注是同一个对象。这直接决定了事后复盘的成本。但要提醒一句：Notebook 里放的是生产查询结果，如果你的排查涉及用户数据，导出和分享前先确认权限模型——public preview 阶段的权限边界，官方文档说得还不算细。
三、对国内 IT 运维和开发者的启示：把这次升级当成一次”大盘资产盘点”，而不是一次 UI 换肤。 三个可执行的动作：一是先把 feature toggle 当灰度开关用，13.3 的三个 toggle（grafana.dashboardGlobalVariables、dashboard.notebooks、grafana.visualDesignRefresh）都支持按开关逐个启用，可以先在测试环境开视觉翻新和变量，观察一到两周再推生产；二是借 Notebooks 的导入导出来规范复盘流程，把过去散在文档和群里的排查记录回填一部分，形成团队能检索的资产，而不是重新造一套文档系统——Grafana 里的复盘文档至少自带了查询上下文和面板快照；三是别忽略那条权限破坏性变更，如果你把 Grafana 的角色管理下放给了团队管理员，这次升级前需要复核一遍授权模型和操作留痕。需要提醒的是，13.3 里的多数能力仍在 public preview，自建环境等于自己承担了版本演进的验证成本，升级节奏建议跟着官方 changelog 走，而不是跟着业务需求冲。
参考链接
- – 主源：Grafana Labs《Grafana 13.3 release: manage variables across dashboards, share findings with Notebooks, a UI refresh, and more》（2026-10-29）https://grafana.com/blog/grafana-13-3-release-all-the-latest-features
- – 官方文档：What’s new in Grafana v13.3（功能清单、GA/preview 状态与破坏性变更）https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v13/whats-new-in-v13-3
- – 官方文档：Upgrade to Grafana v13.3（升级步骤）https://grafana.com/docs/grafana/latest/setup-grafana/upgrade-guide/upgrade-v13-3/
- – 社区整理：Releasebot《Grafana Release Notes》（含 13.3 变更与日期标注）https://releasebot.io/updates/grafana
- – 第三方对照：Linuxiac《Grafana 13.3 Observability Platform Adds Shared Variables, UI Refresh》（2026-11）https://linuxiac.com/grafana-13-3-observability-platform-adds-shared-variables-ui-refresh
