Grafana v9.0 升级指南与技术要点解析

Grafana v9.0 升级指南与技术要点解析

grafana The open and composable observability and data visualization platform. Visualize metrics, logs, and traces from multiple sources like Prometheus, Loki, Elasticsearch, InfluxDB, Postgres and many more. 项目地址: https://gitcode.com/gh_mirrors/gr/grafana

前言

Grafana v9.0 是一次重要的版本升级，带来了多项功能改进和技术变更。作为一款领先的开源可视化和监控分析平台，Grafana 的每次大版本更新都会对系统架构和用户体验产生深远影响。本文将深入解析 v9.0 版本的升级要点，帮助管理员和技术人员顺利完成升级过程。

升级前的准备工作

在开始升级前，必须做好以下准备工作：

1. 完整备份：包括 Grafana 配置文件、数据库和插件目录
2. 环境检查：确认当前系统满足 v9.0 的运行要求
3. 兼容性评估：特别关注本文提到的技术变更点

核心变更解析

1. 基于角色的访问控制(RBAC)正式发布

RBAC 功能从预览版转为正式发布，带来了以下重要变化：

• 基础角色重构：原内置角色(built-in roles)改称基础角色(basic roles)，现在直接由权限组成而非角色
• 权限继承取消：Viewer 角色的权限修改不再自动传播到 Editor 和 Admin 角色
• API 变更：多项 RBAC 操作名称已更新，需检查现有自动化脚本
• Terraform 变更：builtin_role_assignment 资源已弃用，应改用 grafana_role 资源

迁移建议：仔细检查现有权限配置，更新相关自动化脚本和配置模板。

2. 数据源相关变更

Loki 数据源

• 日志数据格式优化：采用单一数据帧结构，包含"labels"字段，替代原有的多数据帧方案
  • 影响：使用"Labels to fields"转换的仪表板需调整为"Extract fields"转换
• NaN 值处理统一：所有查询类型(包括仪表板和探索)现在都保留原始 NaN 值

Elasticsearch 数据源

• 版本支持调整：仅支持 7.10.0 及以上版本
• 访问模式变更：移除浏览器访问模式，必须使用服务器访问模式

Prometheus 数据源

• NaN 值处理：与 Loki 类似，所有查询类型现在都保留原始 NaN 值

3. 面板插件兼容性

• 时钟面板(Clock Panel)：必须升级至 2.0.0 版本，否则会导致 Grafana 崩溃
• Polystat 面板：需升级至 1.2.10 版本，旧版本在 v9.0 中将无法正常渲染

操作建议：升级前检查仪表板中使用的插件版本，提前完成插件更新。

4. 信封加密默认启用

v9.0 中信封加密(Envelope Encryption)成为默认加密机制：

• 变更影响：v9.0 创建/更新的密钥无法被旧版本解密
• 高可用环境：在滚动升级或回滚场景下需特别注意
• 推荐方案：
  • 升级前在旧版本中启用 envelopeEncryption 特性
  • 或在新版本中临时启用 disableEnvelopeEncryption

5. 企业版许可变更

• 许可计算简化：不再区分查看者(Viewer)和编辑管理员(Editor-Admin)许可
• 统一计数：所有用户无论角色均计入总许可数
• 影响评估：对大多数客户来说这是更宽松的政策

升级后检查清单

完成升级后，建议执行以下验证步骤：

1. 检查所有数据源连接状态
2. 验证关键仪表板的显示效果
3. 测试告警规则和通知渠道
4. 确认 RBAC 权限配置符合预期
5. 检查加密数据的可访问性

总结

Grafana v9.0 带来了多项架构改进和安全增强，特别是 RBAC 的正式发布和默认启用的信封加密机制，显著提升了系统的安全性和管理能力。升级过程中需要特别注意数据源兼容性和插件版本要求，合理规划升级路径可以确保平稳过渡。

对于企业用户，新的许可计算方式简化了管理复杂度，建议利用此机会重新评估用户权限分配策略，充分发挥 v9.0 版本的各项优势。

grafana The open and composable observability and data visualization platform. Visualize metrics, logs, and traces from multiple sources like Prometheus, Loki, Elasticsearch, InfluxDB, Postgres and many more. 项目地址: https://gitcode.com/gh_mirrors/gr/grafana