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

# Grafana 版本之间的差异
<a name="version-differences"></a>

[创建 Grafana 工作区](AMG-create-workspace.md)时，必须选择要创建的 Grafana 版本。你可以在与 Grafana 版本 8、9、10 和 12 兼容的版本之间进行选择。每个版本都增加了以前版本的功能。以下主题描述了版本 9、10 和 12 中的更改，包括可能会破坏您在先前版本中使用的功能的更改。

**注意**  
您可以在、、和主题中阅读有关使用 Grafana 工作空间的[在 Grafana 版本 12 中工作](using-grafana-v12.md)特定版本文档。[使用 Grafana 版本 10](using-grafana-v10.md) [使用 Grafana 版本 9](using-grafana-v9.md) [使用 Grafana 版本 8](using-grafana-v8.md)

有关各版本的详细说明以及 Grafana Labs 的更多信息，请参阅 *Grafana Labs 文档*中的 [Grafana 新增功能](https://grafana.com/docs/grafana/latest/whatsnew/)。

## Grafana 版本 12
<a name="version-diff-v12"></a>

Grafana 版本 12 中增加了以下功能。

**深入分析应用程序**
+ **Metrics Drilldown** — 一种无需查询的体验， point-and-click用于探索 Prometheus 指标数据。请参阅[指标深入分析](v12-drilldown-metrics.md)。
+ L@@ **ogs Drilldown** — 浏览带有音量和文本模式的 Loki 日志的无查询体验。请参阅[日志 Drilldown](v12-drilldown-logs.md)。
+ T@@ **races Drilldown — 探索分布式 Tempo 轨迹**的无查询体验。请参阅[追踪向下钻取](v12-drilldown-traces.md)。
+ Profil@@ **es Drilldown** — 浏览 Pyroscope 分析数据的无查询体验。请参阅[个人资料深入分析](v12-drilldown-profiles.md)。

**仪表板和可视化**
+ **场景驱动的仪表板** — 仪表板渲染引擎已使用场景框架进行了重建，提供了改进的性能、更好的模板变量支持和更灵活的布局。
+ **新的表格可视化** — 表格面板经过全面重建，以提高性能和新功能，包括 CSS 单元格样式、从表格字段生成工具提示、改进的页脚、用于交互式按钮的新操作单元格类型以及 Cell Inspect 中的自动格式化单元格值。
+ **画布可视化改进** — 画布面板现在支持一键式数据链接和操作、动态连接方向、禁用工具提示的功能以及平移和缩放方面的改进，使您可以更好地控制交互式数据驱动的布局。
+ **可视化操作** — 现在，您可以向触发 API 调用或导航到的可视化项添加交互式操作 URLs，支持自定义变量、一键式数据链接以及用于表格可视化的新 Actions 单元格类型。
+ **带条件格式的彩色表格行**-表格可视化现在支持行级条件格式，允许您根据数据值为整行着色。
+ **统计数据可视化百分比变化** — 统计面板现在通过可配置的颜色模式选项显示变化百分比，从而更容易一目了然地查看趋势。
+ **条形仪表支持图例** — 条形仪表可视化现在支持图例，从而提高了显示多个系列时的可读性。
+ **州时间轴分页** — 州时间轴可视化现在支持分页，因此可以更轻松地浏览大型数据集。
+ **重新设计的仪表板筛选器**-重新设计了仪表板列表筛选器，以提供更直观的浏览体验。
+ **切换变量类型**-新的 Switch 变量类型允许您在查询中的值之间快速切换，从而简化仪表板交互。
+ **查询变量的静态选项**-查询变量现在支持静态选项，让您无需数据源查询即可更好地控制变量值。
+ **增强的即席筛选器** — 即席筛选器现在可以改进跨数据源的支持，从而更轻松地动态筛选仪表板数据。
+ **使用 Cron 语法更好地控制时间区域** — 标注现在支持时间区域的 Cron 语法，从而可以更精确地控制基于时间的注释。
+ **提高了地理地图性能 — 通过改进性能优**化，Geomap可视化现在可以显著加快渲染速度。
+ **导航书签**-您现在可以在导航菜单中为常用页面添加书签，以便快速访问。
+ 通过查询@@ **设置阈值颜色 — 来自查询**转换的 Config 现在支持根据查询结果动态设置阈值颜色。
+ **增强的自定义货币格式**-新的自定义货币格式选项允许您通过精确的十进制控制来显示精确的财务价值。
+ **服务器可配置的快速时间范围**-管理员现在可以配置仪表板时间选择器中可用的快速时间范围选项。
+ **公告横幅** — 管理员现在可以显示公告横幅，向工作空间用户传达重要信息。

**代码转换**
+ 按值@@ **筛选中的子字符串匹配器 — “按值**筛选” 转换现在包括子字符串匹配器，可以更轻松地根据部分文本匹配来筛选数据。
+ **趋势线转换** — 新的趋势线变换允许您通过在可视化中添加趋势线和移动平均线来发现数据中的模式。
+ **所有数值字段的二进制变换**-现在，您可以同时对表中的所有数值字段应用相同的二进制变换，从而减少重复配置。
+ 提取字段@@ **的新正则表达式选项-提取字段**转换现在支持正则表达式，可提供更强大的文本数据字段提取功能。
+ **转换更新** — 添加了多项转换改进，包括整个转换管道的新模式和可用性增强。
+ **所有转换中的仪表板变**量 — 现在所有转换类型都支持仪表板变量，从而扩展了数据处理管道的灵活性。

**警报**
+ **保留 Grafana 托管警报的最后状态** — 现在可以将警报规则配置为在查询未返回任何数据或错误时保持其最后状态，从而防止不必要的警报状态更改。
+ **警报详细信息视图重新设计**-警报规则详细信息视图已重新设计，布局更清晰，信息更具可操作性。
+ **警报模板选择器** — 警报界面中的新模板选择器使选择和应用通知模板变得更加容易。
+ **改善了暂停的警报可见性**-用户界面中现在可以更清楚地显示暂停的警报规则，从而更容易识别哪些规则未进行主动评估。
+ **仅适用于 Grafana 管理的警报：特定于规则的静音 — 您现在可以创建适用于具有精**细权限的特定警报规则的静音，从而提供更有针对性的警报抑制。
+ **Grafana 管理的警报**的记录规则 — Grafana 管理的警报现在可以使用记录规则，允许您预先计算常用的查询以提高性能。这取代了已弃用的记录查询功能。请参阅[配置记录规则](v12-alerting-configure-recordingrules.md)。
+ **警报规则版本历史记录**-警报规则现在保留版本历史记录，允许您跟踪更改并恢复到以前的配置。
+ **Grafana 管理的警报规则 “正在恢复” 状态** — 警报规则现在支持 “恢复” 状态，该状态表示警报条件何时不再触发但尚未恢复正常。
+ **警报规则改进** — Grafana 管理的警报规则包括多项可用性改进，包括更新的列表页面、活动时间间隔、从 Prometheus YAML 导入规则的功能以及重新设计的设置页面。

**浏览和记录**
+ **新的日志可视化** — 新的日志可视化面板通过新的字段选择器组件改进了日志呈现，用于自定义显示哪些字段。
+ **JSON 日志行查看器** — Logs Drilldown 应用程序现在包括一个用于结构化日志行的 JSON 查看器，可以更轻松地检查 JSON 格式的日志数据。
+ **向前搜索 Loki** — Explore 中的 Loki 查询现在支持向前搜索，允许您搜索从最旧到最新的日志。
+ Expl@@ **ore 中的相关**性 — 现在，您可以 URLs 直接从 “浏览” 中向外部添加相关性，从而实现数据源和外部系统之间的无缝导航。请参阅[Grafana 版本 12 中的相关性](v12-correlations.md)。

**数据来源**
+ **适用于 Prometheus 数据源迁移的亚马逊托管服务** — 从本版本开始，Core Prometheus 插件中的 Sigv4 身份验证支持已被弃用。当你升级到 Grafana 版本 12 时，所有以前使用 Core Prometheus 插件的亚马逊 Prometheus 托管服务数据源都会自动迁移到适用于 Prometheus 的亚马逊托管服务插件。使用这些数据源的任何仪表板都会自动更新以反映这一变化。
+ **带有 PPL 和 SQL 的 Amazon L CloudWatch ogs** Insights — 除了标准查询语言外，您现在还可以使用 PPL（管道处理语言）和 SQL 语法来查询 Amazon Lo CloudWatch gs Insights。
+ **Amazon M CloudWatch etric Insights 跨账户支持** — Amazon M CloudWatch etric Insights 现在支持跨账户可观察性，允许您跨多个账户查询指标。 AWS 账户
+ **Amazon CloudWatch Logs 异常检测和模式分析** — Amazon CloudWatch 数据源现在支持日志异常检测和模式分析，用于识别日志数据中的异常模式。
+ **OpenSearch PPL 和示例查询** — OpenSearch 数据源现在支持 PPL 语言和示例查询，便于构建查询。
+ **MSSQL Windows Active Directory 身份验证** — 微软 SQL Server 数据源现在支持 Windows 活动目录 (Kerberos) 身份验证。
+ **移除旧的 Tempo 和 Loki Search** — 已删除传统的 Tempo Search 和 Loki Search 界面，转而使用 TraceQL 支持的搜索体验。
+ **BigQuery 服务帐户模拟**- BigQuery 数据源现在支持服务帐户模拟，以实现更灵活的身份验证。
+ **Google 表格模板变量** — Google 表格数据源现在支持用于动态数据查询的模板变量。
+ 对 **SQL 数据源的时间序列宏支持** — SQL 数据源的可视查询生成器现在支持时间序列宏，从而简化了基于时间的查询。
+ **Databricks 中支持 Unity Catalog — Grafana Databricks** 插件现在支持 Unity Catalog 以实现统一的数据治理。
+ **Honeycomb 原始查询支持** — Honeycomb 数据源现在支持用于高级查询功能的原始查询。
+ **GitHub 应用程序身份验证**- GitHub 数据源现在支持 GitHub 应用程序身份验证作为个人访问令牌的替代方案。

**身份验证和安全**
+ **API 密钥已迁移到服务帐号** — API 密钥已完全弃用并自动迁移到服务帐号，从而提高了安全性和管理功能。请参阅[使用服务账号](v12-authenticating-grafana-apis.md#v12-service-accounts)。
+ **OAuth 以及 SAML 会话处理方面的改进** — 已改进 OAuth 和 SAML 身份验证提供程序的会话处理，以提高可靠性和安全性。
+ **Entra 工作负载身份支持** — Grafana 现在支持 Microsoft Entra 工作负载身份在 Azure 环境中进行身份验证。
+ **OAuth2 对于 Alertmanager 和 Mimir** — 你现在可以在普通的 Alertmanager 和 Mimir 数据源的 HTTP 设置中配置 OAuth2 身份验证。

**可访问性**
+ **GeoMap 键盘支持**- GeoMap 可视化现在支持键盘导航，以提高可访问性。
+ **面板快捷键盘支持**-仪表板面板现在支持常用操作的键盘快捷键。
+ **航向和减少动作改进** — 屏幕阅读器的标题结构已得到改进，并且为喜欢最少动画的用户增加了减少的动作支持。

**重大更改**

**重要**  
**旧版警报已完全移除** — Amazon Managed Grafana v12 中已完全删除传统警报，具有旧警报设置的工作空间将无法启动。在升级到 v12 之前，您必须从旧版警报迁移到 Grafana 警报。请参阅[将经典控制面板警报迁移到 Grafana Alerting](v10-alerting-use-grafana-alerts.md)和[经典控制面板警报](old-alerts-overview.md)。

**重要**  
**AngularJS 支持已删除 — Amazon M** anaged Grafana v12 中完全取消了 AngularJS 支持，因此基于 Angular 的插件将无法加载，使用它们的仪表板将显示错误。在升级之前，你必须将所有基于 Angular 的插件迁移到 React 替代品。[使用插件目录查找插件](grafana-plugins.md#plugin-catalog)有关管理工作区中的插件的信息，请参阅。

**重要**  
**API 密钥已移除** — Amazon Managed Grafana v12 中的 API 密钥已完全删除，转而使用服务账户，并且现有的 API 密钥将不再起作用。升级之前，您必须创建服务帐号来替换所有 API 密钥，并更新自动化以使用服务帐号令牌。请参阅[使用服务账号](v12-authenticating-grafana-apis.md#v12-service-accounts)。

**重要**  
**警报规则评估结果限制**-每条警报规则的查询评估结果数量现在限制为 500。如果警报规则的条件查询产生的结果超过此限制，则评估会导致错误。要在发生此错误时接收警报，请在警报规则的设置`Error`下配置为`Alert state if execution error or timeout`。请参阅[警报规则的状态和运行状况](v12-alerting-explore-state.md)。

**重要**  
**注释限制为 300 万**个 — 现在每个工作区的批注数量限制为 300 万个。如果创建的批注超过 300 万个，则将首先删除最早的批注。
+ **输入数据源已移除**-输入数据源插件已完全移除，因此升级前必须将受影响的仪表板迁移到 TestData 数据源。请参阅 *Grafana 实验室TestData *[文档中的文档](https://grafana.com/docs/grafana/latest/datasources/testdata/)。
+ **查询筛选行为更改**-“禁用查询” 按钮现在变为 “隐藏 response/Show 响应”，隐藏查询的响应将不再返回到面板，因此，如果升级后数据丢失，请查看您的查询配置并更新面板。请参阅 *Grafana Labs 文档*中的[查询筛选更改](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v11-0/#data-sources-query-filtering-changes)。
+ **数据源 UIDs 必须遵循更严格的格式**-数据源现在 UIDs 必须仅使用字母数字字符、连字符和下划线，因此在升级之前，您应该更新任何不合规的内容 UIDs 及其仪表板引用。请参阅 *Grafana* Labs 文档中的[更严格的数据源 UID 格式](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-0/#enforcing-stricter-data-source-uid-format)。
+ **重复面板的面板视图已 URLs 更改 — 用于**查看单个重复面板的 URL 格式已更改，旧面板 URLs 将返回 “找不到面板” 错误，因此请通过在视图模式下打开面板来更新所有书签或自动化以获取新面板 URLs。请参阅 *Grafana* Labs 文档中的[面板视图网址更改](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v11-0/#changes-to-how-the-panel-view-url-is-generated-for-repeated-panels)。
+ **带有正斜杠的文件夹需要转义匹配器** — 引入子文件夹可能会破坏与包含正斜杠的文件夹相关的警报规则，因此在升级之前，请使用转义的匹配器（例如`grafana_folder=MyFolder\/sub-folder`）更新通知策略，或者重命名文件夹以删除正斜杠。请参阅[创建控制面板文件夹](v12-dash-managing-dashboards.md#v12-dash-create-dashboard-folder)和[配置通知策略](v12-alerting-configure-notification-policies.md)。
+ **警报模板 \$1value 变量行为更改** — 警报通知模板中的`$value`变量现在在查询单个数据源时会返回查询值，因此请查看使用`$value`和更新格式的警报模板（如果需要）。请参阅[模板化标签和注释](v12-alerting-overview-labels-templating.md)。
+ **放宽警报规则访问权限**-已放宽访问警报规则的权限要求。*在 Grafana [Labs 文档中查看 [使用权限](Grafana-permissions.md) Grafana v11.1 中的新增内容](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-1/#removes-requirement-of-datasourcesquery-permission-for-reading-rules)。*
+ **默认启用录制规则**-Grafana Alerting 中现在默认启用录制规则。请参阅[配置记录规则](v12-alerting-configure-recordingrules.md)。
+ **已移除内部 Alertmanager 配置** POST 端点 — 内部 Grafana Alertmanager 配置的 POST 端点已删除，因此在升级之前，您必须更新 API 集成以使用新的配置端点（例如）。`POST /api/v1/provisioning/alert-rules`
+ **查看者和编辑者权限已扩展**-查看者现在可以读取和写入批注，编辑者可以创建和删除批注。请参阅[使用权限](Grafana-permissions.md)。
+ **创建者权限已更改**-授予资源（例如仪表板或文件夹）创建者的权限已更改，因此请在升级后查看您的访问控制设置。请参阅 *Grafana* Labs 文档中的对[创作者权限的更改](https://grafana.com/whats-new/2025-10-16-change-to-creator-permissions/)。
+ **已移除 API 密钥相关权限**-作为向服务帐号全面迁移的一部分，之前与 API 密钥关联的权限已被删除。请参阅 Gra *fana Labs 文档中的 “移*[除 API 密钥相关权限](https://grafana.com/whats-new/2025-10-03-removal-of-api-key-associated-permissions/)”。
+ **SNS 联络点迁移** — SNS 联系人会自动迁移到较新的 SNS 通知器。此迁移不需要任何手动操作。但是，SNS 的联络点设置架构已更改。[创建通知渠道](v12-Grafana-API-AlertingNotificationChannels.md#v12-Grafana-API-AlertNotificationChannels-Create)有关更新的请求格式的示例，请参阅。
+ **警报规则评估结果限制**-每条警报规则的查询评估结果数量现在限制为 500。如果警报规则的条件查询产生的结果超过此限制，则评估会导致错误。要在发生此错误时接收警报，请在警报规则的设置`Error`下配置为`Alert state if execution error or timeout`。
+ **从 Core Prometheus 插件中移除了 Sigv4 身份验证 — Core Prometheus 插件**中的 Sigv4 身份验证支持已被删除。当你升级到 Grafana 版本 12 时，所有以前使用 Core Prometheus 插件的亚马逊 Prometheus 托管服务数据源都会自动迁移到适用于 Prometheus 的亚马逊托管服务插件。使用这些数据源的任何仪表板都会自动更新以反映这一变化。请参阅[连接到 Prometheus 数据源的亚马逊托管服务](amazon-prometheus-data-source.md)。

亚马逊 Managed Grafana v12 包括从开源 Grafana v11.0 到 v12.4 的功能。有关 AWS特定功能，请参阅亚马逊托管 Grafana 用户指南。*有关新增功能的详细信息，请参阅 Grafana [Labs 文档中的 Grafana v11.x 和 v12.x 版的新增](https://grafana.com/docs/grafana/latest/whatsnew/)功能。*版本 11.x 和 12.x 包含可能会破坏功能的更改，因此在更新生产工作区之前，请在非生产环境中进行测试。

有关重大变更的更多详细信息，请参阅 *Grafana Labs 文档*中的以下主题：

**Grafana 12**
+ [Grafana v12.4 中的新增功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-4/)
+ [Grafana v12.3 中的新增功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-3/)
+ [Grafana v12.2 中的新增功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-2/)
+ [Grafana v12.1 的新增功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-1/)
+ [Grafana v12.0 中的新增功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-0/)

**Grafana 11**
+ [Grafana v11.6 中的新增功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-6/)
+ [Grafana v11.5 的新增功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-5/)
+ [Grafana v11.4 的新增功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-4/)
+ [Grafana v11.3 的新增功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-3/)
+ [Grafana v11.2 的新增功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-2/)
+ [Grafana v11.1 的新增功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-1/)
+ [Grafana v11.0 中的新增功能](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-0/)

## Grafana 10
<a name="version-diff-v10"></a>

Grafana 10 中增加了以下功能。
+ **关联**：关联定义了如何使用一个数据来源中的数据来查询另一个数据来源中的数据，并允许 Explore 可视化轻松运行与所示数据相关的查询。有关更多详细信息，请参阅[Grafana 10 版本中的关联](v10-correlations.md)。
+ **子文件夹**：在整理控制面板时，您现在可以使用子文件夹创建嵌套层次结构。有关更多详细信息，请参阅[创建控制面板文件夹](v10-dash-managing-dashboards.md#v10-dash-create-dashboard-folder)。
+ **警报**：Grafana Alerting 现在支持警报静默。此外，Grafana Alerting 不再发送 3 次通知。
+ **警报升级预览**：在从经典控制面板警报升级到 Grafana 警报之前，您可以查看警报的外观，甚至进行迁移时应用的更改。有关更多详细信息，请参阅[将经典控制面板警报迁移到 Grafana Alerting](v10-alerting-use-grafana-alerts.md)。Grafana Labs 宣布 Grafana 11 及更高版本将不再支持经典控制面板警报。
+ **支持捆绑包**：支持捆绑包提供了一种简单的方法，来收集有关 Grafana 工作区的信息，以便与产品支持人员共享。您可以快速创建一个支持捆绑包，其中包含有关迁移、插件、设置等方面的数据。有关更多详细信息，请参阅[收集信息以获得支持](support-bundles.md)。
+ **新增可视化**：提供了三种新的可视化效果。[XY 图表](v10-panels-xychart.md)、[数据网格](v10-panels-datagrid.md)和[趋势面板](v10-panels-trend.md)都适用于与版本 10 兼容的工作区。版本 9 工作区也可以使用 XY 图表。
+ **PagerDuty**— 企业插件现在包括一个用于的插件 PagerDuty。
+ **转换重新设计**：“转换”选项卡改善了用户体验和视觉设计。转换已分类，每种转换类型都有一个插图，来帮助您选择正确的转换。
+ **Prometheus 指标百科全书**：Prometheus 查询生成器中 Prometheus 指标的指标下拉列表已替换为分页且可搜索的指标*百科全书*。
+ **API 密钥用户界面已停用** — 建议使用[服务帐号](v12-authenticating-grafana-apis.md#v12-service-accounts)来验证对 Grafana HTTP 的调用。 APIs作为 Grafana Labs 停用 API 密钥的一部分，您无法再通过工作区用户界面创建 API 密钥。您只能通过创建 API 密钥 AWS APIs。

  有关 Grafana Labs 停用 API 密钥的更多信息，[APIKeys请参阅 Grafana 问题列表中的 API 密钥注销](https://github.com/grafana/grafana/issues/53567)。 GitHub 

**重大更改**

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 或更高版本。

  有关安装或升级插件的更多信息，请参阅 [使用插件目录查找插件](grafana-plugins.md#plugin-catalog)。
+ **不再支持 DoIt BigQuery 插件 — 不再支持** DoIt BigQuery 数据源插件。改用官方的 Grafana BigQuery Labs 数据源插件。
+ **转换更改**：Grafana 10 对字段名称和键进行了一些错误修复更改。有关完整详细信息，请参阅 Grafana Labs 文档中的[重大转换更改](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v10-3/#transformations)。
+ **数据源权限 APIs**-访问数据源权限的端点已更改。有关完整详细信息，请参阅 Grafana Labs 文档中的[数据来源权限更改](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v10-3/#data-source-permissions)。

有关重大变更的更多详细信息，请参阅 *Grafana Labs 文档*中的以下主题：
+ [Grafana v10.0 中的重大更改](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v10-0/)
+ [Grafana v10.3 中的重大更改](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v10-3/)

## Grafana 9
<a name="version-diff-v9"></a>

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 更新](https://github.com/grafana/grafana/blob/release-9.4.17/CHANGELOG.md)日志。*GitHub*
+ **API 已停用**：`/api/tsdb/query` API 已被移除。

  **所需操作：**改用 `/api/ds/query`。[请参阅 *Grafana 公共*文档中的[查询数据源](https://grafana.com/docs/grafana/latest/http_api/data_source/#query-a-data-source)和问题 \$149916 *GitHub*](https://github.com/grafana/grafana/issues/49916)
+ **API 端点更改**：多个警报 API 端点现在需要数据来源 UID 而不是数字 ID。

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

  **所需操作：**更新 API 调用进而使用数据来源 UID 作为路径参数。参见问题 [\$148070](https://github.com/grafana/grafana/issues/48070)、[\$148052](https://github.com/grafana/grafana/issues/48052)、[\$148046](https://github.com/grafana/grafana/issues/48046) 和 [*GitHub*\$147978](https://github.com/grafana/grafana/issues/47978)
+ **Azure Monitor 查询已移除**：不再支持 Application Insights 和 Insight Analytics 查询。

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

  **所需操作：**有关迁移指南，请参阅《Grafana 公共文档》**中的 [Azure Monitor 数据来源](https://grafana.com/docs/grafana/latest/datasources/azuremonitor/deprecated-application-insights/)。
+ **浏览器访问模式已移除**：浏览器访问模式不再适用于 InfluxDB 和 Prometheus 数据来源。

  **所需操作：**在数据来源配置中切换到服务器访问模式。InfluxDB：在 8.0.0 中已弃用，在 9.2.0 中已移除。参见[第 \$153529](https://github.com/grafana/grafana/issues/53529) 期*GitHub*。Prometheus：在 7.4.0 中已弃用，在 9.2.0 中已移除。参见[第 \$150162](https://github.com/grafana/grafana/issues/50162) 期*GitHub*。
+ **控制面板设置访问受限**：编辑面板时您无法再打开控制面板设置。

  面板编辑模式处于活动状态时，控制面板设置将被锁定。在访问控制面板设置之前，请关闭面板编辑模式。参见[第 \$154746](https://github.com/grafana/grafana/issues/54746) 期*GitHub*。
+ **数据来源密码加密**：不再支持未加密的密码。

  **所需操作：**使用 `secureJsonData.password` 和 `secureJsonData.basicAuthPassword`。之前在 v8.1.0 中已停用。参见[第 \$149987](https://github.com/grafana/grafana/issues/49987) 期*GitHub*。
+ **默认数据来源行为**：默认数据来源选择不再影响现有面板。

  默认数据来源仅适用于新面板。更改默认值不会更新现有控制面板。先前保存的面板会保留其数据来源配置。参见[第 \$145132](https://github.com/grafana/grafana/issues/45132) 期*GitHub*。
+ **Elasticsearch 间隔属性已更改**：已更新 Elasticsearch 7.x 的查询间隔规范。

  从 `interval` 更改为 `fixed_interval` 属性。与 Elasticsearch 8.x 保持一致。大多数查询不会显示可见的更改。参见[第 \$150297](https://github.com/grafana/grafana/issues/50297) 期*GitHub*。
+ **Elasticsearch 原始文档模式已停用**：Elasticsearch 数据来源的显示模式发生了变化。

  **所需操作：**改用**原始数据**模式。参见[第 \$162236](https://github.com/grafana/grafana/issues/62236) 期*GitHub*。
+ **Elasticsearch 版本支持**：不再支持较早的 Elasticsearch 版本。

  **所需操作：**将 Elasticsearch 升级到 7.10.0 或更高版本。7.10.0 以下的版本已过去。 end-of-life参见[第 \$148715](https://github.com/grafana/grafana/issues/48715) 期*GitHub*。
+ **浏览网址格式已停用** — Compact Explore URLs 将在未来的版本中移除。

  **所需操作：**更新硬编码链接以使用标准 URL 格式。紧凑 URLs：`&left=["now-1h","now"...]`。标准 URLs：`&left={"datasource":"test"...}`。参见[第 \$150873](https://github.com/grafana/grafana/issues/50873) 期*GitHub*。
+ **GitHub OAuth 显示更改**- GitHub 名称和登录显示已更新。

  GitHub 名字显示为 Grafana 的名字。 GitHub 登录名显示为 Grafana 登录名。提高了用户标识的清晰度。参见[第 \$145438](https://github.com/grafana/grafana/issues/45438) 期*GitHub*。
+ **热图面板实现已更新**：热图面板使用从 9.1.0 开始的新实现。

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

  **所需操作：**升级后测试您的热图面板。如果需要，可通过将 `useLegacyHeatmapPanel` 功能标志设置为 true 来禁用新的实现。`?__feature.useLegacyHeatmapPanel=true`添加到仪表板 URLs 进行测试。参见[第 \$150229](https://github.com/grafana/grafana/issues/50229) 期*GitHub*。
+ **InfluxDB 后端迁移**：InfluxDB 数据解析行为已更改。

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

  **所需操作：**移除受影响的面板并重新创建，或者按照 `panel.json` 或 `dashboard.json` 中的 `Time` 编辑 `time` 字段。参见[第 \$164842](https://github.com/grafana/grafana/issues/64842) 期*GitHub*。
+ **日志消息格式已更新**：日志消息结构已更改。

  `lvl` 现在为 `level`。`eror` 和 `dbug` 现在为 `error` 和 `debug`。提高时间戳的精度。可通过 `oldlog` 功能切换（临时）选择退出。参见[第 \$147584](https://github.com/grafana/grafana/issues/47584) 期*GitHub*。
+ **Loki 数据格式优化**：Loki 日志数据使用更高效的数据帧格式。

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

  **所需操作：**使用**提取字段**转换替换**标签到字段**转换。参见[第 \$147153](https://github.com/grafana/grafana/issues/47153) 期*GitHub*。
+ **NaN 值处理**：Prometheus 和 Loki 数据来源之间一致的 `NaN` 表示。

  `NaN` 值仍然为 `NaN`，而不是转换为 `null`。大多数情况下，更改应该对用户不可见。同时影响控制面板和警报路径。请参阅有关的问题 [\$149475](https://github.com/grafana/grafana/issues/49475) 和 [\$145389 *GitHub*](https://github.com/grafana/grafana/issues/45389)。
+ **密码重置链接失效**：升级后，现有的密码重置链接将无法使用。

  升级前发送的密码重置链接无效。用户必须请求新的密码重置链接。链接将在 2 小时后过期。参见[第 \$142334](https://github.com/grafana/grafana/issues/42334) 期*GitHub*。
+ **预留的标签前缀**：以 `grafana_` 开头的标签被预留。

  手动配置的以 `grafana_` 开头的标签可能会被覆盖。当前预留标签：`grafana_folder`（包含警报的文件夹标题）。参见[第 \$150262](https://github.com/grafana/grafana/issues/50262) 期*GitHub*。
+ **转换改进**：**通过正则表达式重命名**转换现在支持全局模式。

  全局模式使用格式 `/<stringToReplace>/g`。有些转换的行为可能有所不同。用正斜杠将匹配字符串换成先前的行为：`(.*)` 变成 `/(.*)/`。参见[第 \$148179](https://github.com/grafana/grafana/issues/48179) 期*GitHub*。