Grafana 版本之间的差异
创建 Grafana 工作区时,必须选择要创建的 Grafana 版本。您可以选择与 Grafana 8、9 和 10 兼容的版本。每个版本都增加了以前版本的功能。以下主题介绍版本 9 和 10 中的更改,包括版本 10 中的更改,这些更改可能会破坏您在版本 9 中使用的功能。
注意
您可以在 使用 Grafana 版本 8、使用 Grafana 版本 9 和 使用 Grafana 版本 10 主题中阅读有关使用 Grafana 工作区的版本特定文档。
有关各版本的详细说明以及 Grafana Labs 的更多信息,请参阅 Grafana Labs 文档中的 Grafana 新增功能
Grafana 10
Grafana 10 中增加了以下功能。
-
关联:关联定义了如何使用一个数据来源中的数据来查询另一个数据来源中的数据,并允许 Explore 可视化轻松运行与所示数据相关的查询。有关更多详细信息,请参阅 Grafana 10 版本中的关联。
-
子文件夹:在整理控制面板时,您现在可以使用子文件夹创建嵌套层次结构。有关更多详细信息,请参阅 创建控制面板文件夹。
-
警报:Grafana Alerting 现在支持警报静默。此外,Grafana Alerting 不再发送 3 次通知。
-
警报升级预览:在从经典控制面板警报升级到 Grafana 警报之前,您可以查看警报的外观,甚至进行迁移时应用的更改。有关更多详细信息,请参阅 将经典控制面板警报迁移到 Grafana Alerting。Grafana Labs 宣布 Grafana 11 及更高版本将不再支持经典控制面板警报。
-
支持捆绑包:支持捆绑包提供了一种简单的方法,来收集有关 Grafana 工作区的信息,以便与产品支持人员共享。您可以快速创建一个支持捆绑包,其中包含有关迁移、插件、设置等方面的数据。有关更多详细信息,请参阅 收集信息以获得支持。
-
新增可视化:提供了三种新的可视化效果。XY 图表、数据网格和趋势面板都适用于与版本 10 兼容的工作区。版本 9 工作区也可以使用 XY 图表。
-
PagerDuty:企业插件现在包括用于 PagerDuty 的插件。
-
转换重新设计:“转换”选项卡改善了用户体验和视觉设计。转换已分类,每种转换类型都有一个插图,来帮助您选择正确的转换。
-
Prometheus 指标百科全书:Prometheus 查询生成器中 Prometheus 指标的指标下拉列表已替换为分页且可搜索的指标百科全书。
-
API 密钥 UI 已停用:建议使用服务账户来验证对 Grafana HTTP API 的调用。作为 Grafana Labs 停用 API 密钥的一部分,您无法再通过工作区用户界面创建 API 密钥。您只能通过 AWS API 创建 API 密钥。
有关 Grafana Labs 停用 API 密钥的更多信息,请参阅 Grafana GitHub 问题列表中的 APIKey:API 密钥停用
。
重大更改
Grafana 10.4 发行版包含从 Grafana 版本 9.5 到 10.4 的更改。Grafana 10.0 和 10.3 进行了一些更改,在某些情况下可能会破坏功能。更新到新版本时,建议先在非生产环境中进行测试,然后再更新生产工作区。
以下更改可能会影响某些更新到 Grafana 10 的用户。
-
Angular 已停用:Grafana 的未来版本将不再支持使用 Angular 的插件。在版本 10 中,使用 angular 的面板将显示一条横幅,说明他们使用的是已停用的功能,以此告知在未来的版本中将无法使用。
-
已删除 CloudWatch 中的别名:CloudWatch 查询编辑器中的别名模式已替换为标签(动态标签)。
打开任何使用“别名”字段的控制面板,然后将其保存。别名会自动迁移到“标签”。
-
旧插件需要升级:Athena 和 Amazon Redshift 数据来源的插件必须在 Grafana v10 工作区中更新。Athena 数据来源插件必须是 2.9.3 或更高版本;Amazon Redshift 数据来源插件必须是 1.8.3 或更高版本。
有关安装或升级插件的更多信息,请参阅 使用插件目录查找插件。
-
不再支持 DoiT BigQuery 插件:不再支持 DoiT BigQuery 数据来源插件。改用官方的 Grafana Labs BigQuery 数据来源插件。
-
转换更改:Grafana 10 对字段名称和键进行了一些错误修复更改。有关完整详细信息,请参阅 Grafana Labs 文档中的重大转换更改
。 -
数据来源权限 API:用来访问数据来源权限的端点已更改。有关完整详细信息,请参阅 Grafana Labs 文档中的数据来源权限更改
。
有关重大更改以及影响插件开发人员的更改的详细信息,请参阅 Grafana Labs 文档中的以下主题:
Grafana 9
Grafana 9 中增加了以下功能。
-
Alerting:Grafana 管理的警报规则现在支持组名称。
-
Explore:从 Explore 视图中创建控制面板。
-
Prometheus 查询:Prometheus 查询的新查询生成器(使用 PromQL)使编写查询变得更加容易。
-
Loki 查询:Loki 查询的新查询生成器(使用 LogQL)使编写查询变得更加容易。
-
API 令牌/服务账户:服务账户简化了 Grafana 中的机器访问,以帮助您管理 API 令牌。
-
插件管理:您可以启用插件管理,以便在工作区中安装、删除或更新社区插件。这使您可以访问更多的数据来源和可视化,并控制您使用的每个插件的版本。
-
指标跟踪:配置跟踪数据来源,以添加指向带有查询和标签的指标链接。
-
画布面板:一种新的面板可视化效果,包含静态和动态元素,用于创建包含图像和叠加文本的数据驱动型自定义面板。
-
重新整理界面:更新了 UI,在 Grafana 控制台中导航更加方便。
-
CloudWatch:Amazon CloudWatch 数据来源现在可以跨 AWS 账户 和跨 AWS 区域 监控指标。
-
日志:改进了日志详细信息的界面。
-
常规:整个过程中,修复了错误并进行了细微改进。
重大更改
Grafana 版本 9.4 在先前版本的基础上包含一系列新功能和改进。此版本进行了一些更改,在某些情况下可能会破坏功能。更新到新版本时,建议先在非生产环境中进行测试,然后再更新生产工作区。
以下更改可能会影响某些更新到 Grafana 9.4 的用户。有关这些更改的详细列表,请参阅 GitHub 上的 Grafana 9.4 更改日志
-
API 已停用:
/api/tsdb/queryAPI 已被移除。所需操作:改用
/api/ds/query。请参阅《Grafana 公共文档》中的查询数据来源和 GitHub 上的问题 #49916 。 -
API 端点更改:多个警报 API 端点现在需要数据来源 UID 而不是数字 ID。
受影响的端点:
api/v1/rule/test、api/prometheus/、api/ruler/、api/alertmanager/所需操作:更新 API 调用进而使用数据来源 UID 作为路径参数。参见 GitHub 上的问题 #48070
、#48052 、#48046 和 #47978 。 -
Azure Monitor 查询已移除:不再支持 Application Insights 和 Insight Analytics 查询。
在 Grafana 8.0 中已弃用,在 9.0 中已移除。已弃用的查询将无法执行。
所需操作:有关迁移指南,请参阅《Grafana 公共文档》中的 Azure Monitor 数据来源
。 -
浏览器访问模式已移除:浏览器访问模式不再适用于 InfluxDB 和 Prometheus 数据来源。
所需操作:在数据来源配置中切换到服务器访问模式。InfluxDB:在 8.0.0 中已弃用,在 9.2.0 中已移除。参见 GitHub 上的问题 #53529
。Prometheus:在 7.4.0 中已弃用,在 9.2.0 中已移除。参见 GitHub 上的问题 #50162 。 -
控制面板设置访问受限:编辑面板时您无法再打开控制面板设置。
面板编辑模式处于活动状态时,控制面板设置将被锁定。在访问控制面板设置之前,请关闭面板编辑模式。参见 GitHub 上的问题 #54746
。 -
数据来源密码加密:不再支持未加密的密码。
所需操作:使用
secureJsonData.password和secureJsonData.basicAuthPassword。之前在 v8.1.0 中已停用。参见 GitHub 上的问题 #49987。 -
默认数据来源行为:默认数据来源选择不再影响现有面板。
默认数据来源仅适用于新面板。更改默认值不会更新现有控制面板。先前保存的面板会保留其数据来源配置。参见 GitHub 上的问题 #45132
。 -
Elasticsearch 间隔属性已更改:已更新 Elasticsearch 7.x 的查询间隔规范。
从
interval更改为fixed_interval属性。与 Elasticsearch 8.x 保持一致。大多数查询不会显示可见的更改。参见 GitHub 上的问题 #50297。 -
Elasticsearch 原始文档模式已停用:Elasticsearch 数据来源的显示模式发生了变化。
所需操作:改用原始数据模式。参见 GitHub 上的问题 #62236
。 -
Elasticsearch 版本支持:不再支持较早的 Elasticsearch 版本。
所需操作:将 Elasticsearch 升级到 7.10.0 或更高版本。低于 7.10.0 的版本已终止支持。参见 GitHub 上的问题 #48715
。 -
Explore URL 格式已停用:简洁 Explore URL 将在未来版本中移除。
所需操作:更新硬编码链接以使用标准 URL 格式。简洁 URL:
&left=["now-1h","now"...]。标准 URL:&left={"datasource":"test"...}。参见 GitHub 上的问题 #50873。 -
GitHub OAuth 显示屏发生了变化:GitHub 名称和登录名显示已更新。
GitHub 名称显示为 Grafana 名称。GitHub 登录名显示为 Grafana 登录名。提高了用户标识的清晰度。参见 GitHub 上的问题 #45438
。 -
热图面板实现已更新:热图面板使用从 9.1.0 开始的新实现。
显著提高了渲染性能。存储桶放置在合理的边界(1m、5m、30s)。不再支持圆形单元格。
所需操作:升级后测试您的热图面板。如果需要,可通过将
useLegacyHeatmapPanel功能标志设置为 true 来禁用新的实现。将?__feature.useLegacyHeatmapPanel=true添加到控制面板 URL 进行测试。参见 GitHub 上的问题 #50229。 -
InfluxDB 后端迁移:InfluxDB 数据解析行为已更改。
由于后端处理问题,重新引入了 InfluxDB 后端迁移功能切换(
influxdbBackendMigration)。默认情况下,InfluxDB 数据是在前端解析的。如果您升级到 9.4.4 并对 InfluxDB 数据添加了转换,则这些面板将无法渲染。所需操作:移除受影响的面板并重新创建,或者按照
panel.json或dashboard.json中的Time编辑time字段。参见 GitHub 上的问题 #64842。 -
日志消息格式已更新:日志消息结构已更改。
lvl现在为level。eror和dbug现在为error和debug。提高时间戳的精度。可通过oldlog功能切换(临时)选择退出。参见 GitHub 上的问题 #47584。 -
Loki 数据格式优化:Loki 日志数据使用更高效的数据帧格式。
带有标签列的单个数据帧,而不是单独的数据帧。浏览和日志面板无需更改即可运行。其他面板或转换可能需要调整。
所需操作:使用提取字段转换替换标签到字段转换。参见 GitHub 上的问题 #47153
。 -
NaN 值处理:Prometheus 和 Loki 数据来源之间一致的
NaN表示。NaN值仍然为NaN,而不是转换为null。大多数情况下,更改应该对用户不可见。同时影响控制面板和警报路径。参见 GitHub 上的问题 #49475和 #45389 。 -
密码重置链接失效:升级后,现有的密码重置链接将无法使用。
升级前发送的密码重置链接无效。用户必须请求新的密码重置链接。链接将在 2 小时后过期。参见 GitHub 上的问题 #42334
。 -
预留的标签前缀:以
grafana_开头的标签被预留。手动配置的以
grafana_开头的标签可能会被覆盖。当前预留标签:grafana_folder(包含警报的文件夹标题)。参见 GitHub 上的问题 #50262。 -
转换改进:通过正则表达式重命名转换现在支持全局模式。
全局模式使用格式
/<stringToReplace>/g。有些转换的行为可能有所不同。用正斜杠将匹配字符串换成先前的行为:(.*)变成/(.*)/。参见 GitHub 上的问题 #48179。