Grafana 版本之间的差异 - Amazon Managed Grafana
Grafana 10Grafana 9

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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 密钥用户界面已停用 — 建议使用服务帐号来验证对 Grafana HTTP 的调用。 APIs随着 Grafana Labs 努力停用 API 密钥，您无法再通过工作区用户界面创建 API 密钥。您只能通过创建 API 密钥 AWS APIs。

    有关 Grafana Labs 停用 API 密钥的更多信息，APIKeys请参阅 Grafana 问题列表中的 API 密钥注销。 GitHub

重大更改

Grafana 10.4 发行版包含从 Grafana 版本 9.5 到 10.4 的更改。Grafana 10.0 和 10.3 进行了一些更改，在某些情况下可能会破坏功能。更新到新版本时，建议先在非生产环境中进行测试，然后再更新生产工作区。

以下更改可能会影响某些更新到 Grafana 10 的用户。

  • Angular 已停产 — Grafana 的未来版本将不再支持使用 Angular 的插件。在版本 10 中，使用 angular 的面板将显示一条横幅，说明他们使用的是已停产的功能，以表明它们在 future 版本中将无法运行。

  • CloudWatch 已删除别名- CloudWatch 查询编辑器中的别名模式被标签（动态标签）所取代。

    打开任何使用“别名”字段的控制面板，然后将其保存。别名会自动迁移到“标签”。

  • 旧插件需要升级：Athena 和 Amazon Redshift 数据来源的插件必须在 Grafana v10 工作区中更新。Athena 数据来源插件必须是 2.9.3 或更高版本；Amazon Redshift 数据来源插件必须是 1.8.3 或更高版本。

    有关安装或升级插件的更多信息，请参阅 使用插件目录查找插件。

  • 不再支持 DoIt BigQuery 插件 — 不再支持 DoIt BigQuery 数据源插件。改用官方的 Grafana BigQuery Labs 数据源插件。

  • 转换更改：Grafana 10 对字段名称和键进行了一些错误修复更改。有关完整详细信息，请参阅 Grafana Labs 文档中的重大转换更改。

  • 数据源权限 APIs-访问数据源权限的端点已更改。有关完整详细信息，请参阅 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 版本的用户。有关这些变更的详细列表，请参阅上的 Grafana 9.4 更新日志。GitHub

  • API 已停用 — /api/tsdb/query API 已被删除。

    需要执行的操作：/api/ds/query改用。请参阅 Grafana 公共文档中的查询数据源和问题 #49916 GitHub

  • API 端点更改 — 多个警报 API 端点现在需要数据源 UID 而不是数字 ID。

    受影响的端点：api/v1/rule/test、api/prometheus/、api/ruler/、api/alertmanager/

    所需操作：更新 API 调用以使用数据源 UID 作为路径参数。参见问题 #48070、#48052、#48046 和 GitHub#47978

  • Azure Monitor 查询已移除-不再支持应用程序见解和洞察分析查询。

    在 Grafana 8.0 中已弃用，9.0 版本中已移除。已弃用的查询将无法执行。

    所需操作：有关迁移指南，请参阅 Grafana 公共文档中的 Azure Monitor 数据源。

  • 浏览器访问模式已移除 — 浏览器访问模式不再适用于 InfluxDB 和 Prometheus 数据源。

    所需操作：在数据源配置中切换到服务器访问模式。InfluxDB：在 8.0.0 中已弃用，在 9.2.0 中已移除。参见第 #53529 期GitHub。Prometheus：在 7.4.0 中已弃用，9.2.0 中已移除。参见第 #50162 期GitHub。

  • 控制板设置访问受限-编辑面板时您无法再打开仪表板设置。

    面板编辑模式处于活动状态时，仪表板设置处于锁定状态。在访问仪表板设置之前，请关闭面板编辑模式。参见第 #54746 期GitHub。

  • 数据源密码加密-不再支持未加密的密码。

    需要执行的操作：使用secureJsonData.password和secureJsonData.basicAuthPassword。之前已在 v8.1.0 中停产。参见第 #49987 期GitHub。

  • 默认数据源行为-默认数据源选择不再影响现有面板。

    默认数据源仅适用于新面板。更改默认值不会更新现有仪表板。先前保存的面板会保留其数据源配置。参见第 #45132 期GitHub。

  • Elasticsearch 间隔属性已更改 — 已更新 Elasticsearch 7.x 的查询间隔规范。

    已从属性更改interval为fixed_interval属性。与 Elasticsearch 8.x 保持一致。大多数查询不会显示可见的更改。参见第 #50297 期GitHub。

  • Elasticsearch 原始文档模式已停产 — Elasticsearch 数据源的显示模式发生了变化。

    需要执行的操作：改用原始数据模式。参见第 #62236 期GitHub。

  • Elasticsearch 版本支持 — 不再支持较旧的 Elasticsearch 版本。

    所需操作：将 Elasticsearch 升级到 7.10.0 或更高版本。7.10.0 以下的版本已过去。 end-of-life参见第 #48715 期GitHub。

  • 浏览网址格式已停用 — Compact Explore URLs 将在未来的版本中移除。

    所需操作：更新硬编码链接以使用标准 URL 格式。紧凑 URLs：&left=["now-1h","now"...]。标准 URLs：&left={"datasource":"test"...}。参见第 #50873 期GitHub。

  • GitHub OAuth 显示更改- GitHub 名称和登录显示已更新。

    GitHub 名字显示为 Grafana 的名字。 GitHub 登录名显示为 Grafana 登录名。提高了用户识别的清晰度。参见第 #45438 期GitHub。

  • 热图面板实现已更新 — 热图面板使用从 9.1.0 开始的新实现。

    显著提高了渲染性能。水桶放置在合理的边界（1 米、5 米、30 秒）。不再支持圆形单元格。

    所需操作：升级后测试您的热图面板。如果需要，可通过将useLegacyHeatmapPanel功能标志设置为 true 来禁用新的实现。?__feature.useLegacyHeatmapPanel=true添加到仪表板 URLs 进行测试。参见第 #50229 期GitHub。

  • InfluxDB 后端迁移 — InfluxDB 数据解析行为已更改。

    由于后端处理问题，重新引入了 InfluxDB 后端迁移功能 toggle (influxdbBackendMigration)。默认情况下，InfluxDB 数据是在前端解析的。如果您升级到9.4.4并对InfluxDB数据添加了转换，则这些面板将无法呈现。

    所需操作：移除受影响的面板并重新创建它们，或者按照panel.json或Timedashboard.json中的方式编辑该time字段。参见第 #64842 期GitHub。

  • 日志消息格式已更新-日志消息结构已更改。

    lvl现在是level。 eror而且dbug现在error和debug。提高了时间戳精度。可通过oldlog功能切换（临时）选择退出。参见第 #47584 期GitHub。

  • Loki 数据格式优化 — Loki 日志数据使用更高效的数据帧格式。

    带有标签列的单个数据框，而不是单独的数据框。“浏览” 和 “日志” 面板无需更改即可运行。其他面板或变换可能需要调整。

    所需操作：使用提取字段转换替换字段转换的标签。参见第 #47153 期GitHub。

  • NaN 值处理 — Prometheus 和 Loki 数据源之间的一致NaN表示。

    NaN值保持不变，NaN而不是转换为null。用户应该基本上看不到更改。同时影响仪表板和警报路径。请参阅有关的问题 #49475 和 #45389 GitHub。

  • 密码重置链接失效-升级后，现有的密码重置链接将无法使用。

    升级前发送的密码重置链接无效。用户必须请求新的密码重置链接。链接将在 2 小时后过期。参见第 #42334 期GitHub。

  • 保留的标签前缀-以开头的标签grafana_被保留。

    手动配置的以开头的标签grafana_可能会被覆盖。当前保留的标签：grafana_folder（包含警报的文件夹的标题）。参见第 #50262 期GitHub。

  • 转换改进-通过正则表达式重命名转换现在支持全局模式。

    全局模式使用该格式/<stringToReplace>/g。有些变换的行为可能有所不同。用正斜杠将匹配字符串换成前面的行为：(.*)变成/(.*)/。参见第 #48179 期GitHub。