Grafana 版本之间的差异

深入分析应用程序

• Metrics Drilldown — 一种无需查询的点击式体验，用于探索 Prometheus 指标数据。请参阅指标深入分析。

• L@@ ogs Drilldown — 浏览带有音量和文本模式的 Loki 日志的无查询体验。请参阅日志 Drilldown。

• T@@ races Drilldown — 探索分布式 Tempo 轨迹的无查询体验。请参阅追踪向下钻取。

• Profil@@ es Drilldown — 浏览 Pyroscope 分析数据的无查询体验。请参阅个人资料深入分析。

仪表板和可视化

• Scenes-powered 仪表板 — 仪表板渲染引擎已使用场景框架进行了重建，提供了改进的性能、更好的模板变量支持和更灵活的布局。

• 新的表格可视化 — 表格面板经过全面重建，以提高性能和新功能，包括 CSS 单元格样式、从表格字段生成工具提示、改进的页脚、用于交互式按钮的新操作单元格类型以及 Cell Inspect 中的自动格式化单元格值。

• 画布可视化改进 — 画布面板现在支持一键式数据链接和操作、动态连接方向、禁用工具提示的功能以及平移和缩放方面的改进，使您可以更好地控制交互式数据驱动的布局。

• 可视化操作 — 您现在可以向可视化中添加触发 API 调用或导航到 URL 的交互式操作，同时支持自定义变量、一键式数据链接以及用于表格可视化的新 Actions 单元格类型。

• 带条件格式的彩色表格行-表格可视化现在支持行级条件格式，允许您根据数据值为整行着色。

• 统计数据可视化百分比变化 — 统计面板现在通过可配置的颜色模式选项显示变化百分比，从而更容易一目了然地查看趋势。

• 条形仪表支持图例 — 条形仪表可视化现在支持图例，从而提高了显示多个系列时的可读性。

• 州时间轴分页 — 州时间轴可视化现在支持分页，因此可以更轻松地浏览大型数据集。

• 重新设计的仪表板筛选器-重新设计了仪表板列表筛选器，以提供更直观的浏览体验。

• 切换变量类型-新的 Switch 变量类型允许您在查询中的值之间快速切换，从而简化仪表板交互。

• 查询变量的静态选项-查询变量现在支持静态选项，让您无需数据源查询即可更好地控制变量值。

• 增强的即席筛选器 — 即席筛选器现在可以改进跨数据源的支持，从而更轻松地动态筛选仪表板数据。

• 使用 Cron 语法更好地控制时间区域 — 标注现在支持时间区域的 Cron 语法，从而可以更精确地控制基于时间的注释。

• 提高了地理地图性能 — 通过改进性能优化，Geomap可视化现在可以显著加快渲染速度。

• 导航书签-您现在可以在导航菜单中为常用页面添加书签，以便快速访问。

• 通过查询@@ 设置阈值颜色 — 来自查询转换的 Config 现在支持根据查询结果动态设置阈值颜色。

• 增强的自定义货币格式-新的自定义货币格式选项允许您通过精确的十进制控制来显示精确的财务价值。

• Server-configurable 快速时间范围-管理员现在可以配置仪表板时间选择器中可用的快速时间范围选项。

• 公告横幅 — 管理员现在可以显示公告横幅，向工作空间用户传达重要信息。

代码转换

• 按值@@ 筛选中的子字符串匹配器-“按值筛选” 转换现在包括子字符串匹配器，可以更轻松地根据部分文本匹配来筛选数据。

• 趋势线转换 — 新的趋势线变换允许您通过在可视化中添加趋势线和移动平均线来发现数据中的模式。

• 所有数值字段的二进制变换-现在，您可以同时对表中的所有数值字段应用相同的二进制变换，从而减少重复配置。

• 提取字段@@ 的新正则表达式选项-提取字段转换现在支持正则表达式，可提供更强大的文本数据字段提取功能。

• 转换更新 — 添加了多项转换改进，包括整个转换管道的新模式和可用性增强。

• 所有转换中的仪表板变量 — 现在所有转换类型都支持仪表板变量，从而扩展了数据处理管道的灵活性。

警报

• 保留 Grafana 托管警报的最后状态 — 现在可以将警报规则配置为在查询未返回任何数据或错误时保持其最后状态，从而防止不必要的警报状态更改。

• 警报详细信息视图重新设计-警报规则详细信息视图已重新设计，布局更清晰，信息更具可操作性。

• 警报模板选择器 — 警报界面中的新模板选择器使选择和应用通知模板变得更加容易。

• 改善了暂停的警报可见性-用户界面中现在可以更清楚地显示暂停的警报规则，从而更容易识别哪些规则未进行主动评估。

• 仅适用于 Grafana-managed 警报：特定于规则的静音 — 您现在可以创建适用于具有精细权限的特定警报规则的静音，从而提供更有针对性的警报抑制。

• 警@@ 报记录规则- Grafana-managed 警报现在可以使用记录规则，允许您预先计算常用的查询以提高性能。 Grafana-managed 这取代了已弃用的记录查询功能。请参阅配置记录规则。

• 警报规则版本历史记录-警报规则现在保留版本历史记录，允许您跟踪更改并恢复到以前的配置。

• Grafana-managed 警报规则 “正在恢复” 状态 — 警报规则现在支持 “正在恢复” 状态，该状态表示警报条件何时不再触发但尚未恢复正常。

• 警报规则改进 — Grafana-managed 警报规则包括多项可用性改进，包括更新的列表页面、活动时间间隔、从 Prometheus YAML 导入规则的功能以及重新设计的设置页面。

浏览和记录

• 新的日志可视化 — 新的日志可视化面板通过新的字段选择器组件改进了日志呈现，用于自定义显示哪些字段。

• JSON 日志行查看器 — Logs Drilldown 应用程序现在包括一个用于结构化日志行的 JSON 查看器，可以更轻松地检查 JSON-formatted 日志数据。

• 向前搜索 Loki — Explore 中的 Loki 查询现在支持向前搜索，允许您搜索从最旧到最新的日志。

• Expl@@ ore 中的关联 — 现在，您可以直接从 “浏览” 中向外部 URL 添加相关性，从而实现数据源和外部系统之间的无缝导航。请参阅Grafana 版本 12 中的相关性。

数据来源

• 适用于 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-powered 搜索体验。

• BigQuery 服务帐户模拟- BigQuery 数据源现在支持服务帐户模拟，以实现更灵活的身份验证。

• Google 表格模板变量 — Google 表格数据源现在支持用于动态数据查询的模板变量。

• 对 SQL 数据源的时间序列宏支持 — SQL 数据源的可视查询生成器现在支持时间序列宏，从而简化了基于时间的查询。

• Databricks 中支持 Unity Catalog — Grafana Databricks 插件现在支持 Unity Catalog 以实现统一的数据治理。

• Honeycomb 原始查询支持 — Honeycomb 数据源现在支持用于高级查询功能的原始查询。

• GitHub 应用程序身份验证- GitHub 数据源现在支持 GitHub 应用程序身份验证作为个人访问令牌的替代方案。

身份验证和安全

• API 密钥已迁移到服务帐号 — API 密钥已完全弃用并自动迁移到服务帐号，从而提高了安全性和管理功能。请参阅使用服务账号。

• OAuth 和 SAML 会话处理改进 — OAuth 和 SAML 身份验证提供商的会话处理已得到改进，以提高可靠性和安全性。

• Entra 工作负载身份支持 — Grafana 现在支持 Microsoft Entra 工作负载身份在 Azure 环境中进行身份验证。

• 适用于 Alertmanager 和 Mimir 的 OAuth2 — 你现在可以在普通的 Alertmanager 和 Mimir 数据源的 HTTP 设置中配置 OAuth2 身份验证。

可访问性

• GeoMap 键盘支持- GeoMap 可视化现在支持键盘导航，以提高可访问性。

• 面板快捷键盘支持-仪表板面板现在支持常用操作的键盘快捷键。

• 航向和减少动作改进 — 屏幕阅读器的标题结构已得到改进，并且为喜欢最少动画的用户增加了减少的动作支持。

• 输入数据源已移除-输入数据源插件已完全移除，因此升级前必须将受影响的仪表板迁移到 TestData 数据源。请参阅 Grafana 实验室TestData 文档中的文档。

• 查询筛选行为更改-“禁用查询” 按钮现在变为 “隐藏 response/Show 响应”，隐藏查询的响应将不再返回到面板，因此，如果升级后数据丢失，请查看您的查询配置并更新面板。请参阅 Grafana Labs 文档中的查询筛选更改。

• 数据源 UID 必须遵循更严格的格式 — 数据源 UID 现在必须仅使用字母数字字符、连字符和下划线，因此升级之前应更新任何不合规的 UID 及其仪表板引用。请参阅 Grafana Labs 文档中的更严格的数据源 UID 格式。

• 重复面板的面板视图 URL 已更改 — 用于查看单个重复面板的 URL 格式已更改，旧 URL 将返回 “找不到面板” 错误，因此请通过在视图模式下打开面板以获取新 URL 来更新所有书签或自动化。请参阅 Grafana Labs 文档中的面板视图网址更改。

• 带有正斜杠的文件夹需要转义匹配器 — 引入子文件夹可能会破坏与包含正斜杠的文件夹相关的警报规则，因此在升级之前，请使用转义的匹配器（例如grafana_folder=MyFolder\/sub-folder）更新通知策略，或者重命名文件夹以删除正斜杠。请参阅创建控制面板文件夹和配置通知策略。

• 警报模板 $value 变量行为更改 — 警报通知模板中的$value变量现在在查询单个数据源时会返回查询值，因此请查看使用$value和更新格式的警报模板（如果需要）。请参阅模板化标签和注释。

• 放宽警报规则访问权限-已放宽访问警报规则的权限要求。在 Grafana Labs 文档中查看 使用权限 Grafana v11.1 中的新增内容。

• 默认启用录制规则-Grafana Alerting 中现在默认启用录制规则。请参阅配置记录规则。

• 已移除内部 Alertmanager 配置 POST 端点 — 内部 Grafana Alertmanager 配置的 POST 端点已删除，因此在升级之前，您必须更新 API 集成以使用新的配置端点（例如）。POST /api/v1/provisioning/alert-rules

• 查看者和编辑者权限已扩展-查看者现在可以读取和写入批注，编辑者可以创建和删除批注。请参阅使用权限。

• 创建者权限已更改-授予资源（例如仪表板或文件夹）创建者的权限已更改，因此请在升级后查看您的访问控制设置。请参阅 Grafana Labs 文档中的对创作者权限的更改。

• 已移除 API 密钥相关权限-作为向服务帐号全面迁移的一部分，之前与 API 密钥关联的权限已被删除。请参阅 Gra fana Labs 文档中的 “移除 API 密钥相关权限”。

• SNS 联络点迁移 — SNS 联系人会自动迁移到较新的 SNS 通知器。此迁移不需要任何手动操作。但是，SNS 的联络点设置架构已更改。创建通知渠道有关更新的请求格式的示例，请参阅。

• 警报规则评估结果限制-每条警报规则的查询评估结果数量现在限制为 500。如果警报规则的条件查询产生的结果超过此限制，则评估会导致错误。要在发生此错误时接收警报，请在警报规则的设置Error下配置为Alert state if execution error or timeout。

• 从 Core Prometheus 插件中移除了 Sigv4 身份验证 — Core Prometheus 插件中的 Sigv4 身份验证支持已被删除。当你升级到 Grafana 版本 12 时，所有以前使用 Core Prometheus 插件的亚马逊 Prometheus 托管服务数据源都会自动迁移到适用于 Prometheus 的亚马逊托管服务插件。使用这些数据源的任何仪表板都会自动更新以反映这一变化。请参阅连接到 Prometheus 数据源的亚马逊托管服务。

• Grafana v12.4 中的新增功能

• Grafana v12.3 中的新增功能

• Grafana v12.2 中的新增功能

• Grafana v12.1 的新增功能

• Grafana v12.0 中的新增功能

• Grafana v11.6 中的新增功能

• Grafana v11.5 中的新增功能

• Grafana v11.4 的新增功能

• Grafana v11.3 的新增功能

• Grafana v11.2 的新增功能

• Grafana v11.1 的新增功能

• Grafana v11.0 中的新增功能

• 关联：关联定义了如何使用一个数据来源中的数据来查询另一个数据来源中的数据，并允许 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 密钥。您只能通过 API 创建 AP AWS I 密钥。

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

• 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 BigQuery Labs 数据源插件。

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

• 数据来源权限 API：用来访问数据来源权限的端点已更改。有关完整详细信息，请参阅 Grafana Labs 文档中的数据来源权限更改。

• Grafana v10.0 中的重大更改

• Grafana v10.3 中的重大更改

• 警报： Grafana-managed 警报规则现在支持群组名称。

• Explore：从 Explore 视图中创建控制面板。

• Prometheus 查询：Prometheus 查询的新查询生成器（使用 PromQL）使编写查询变得更加容易。

• Loki 查询：Loki 查询的新查询生成器（使用 LogQL）使编写查询变得更加容易。

• API 令牌/服务账户：服务账户简化了 Grafana 中的机器访问，以帮助您管理 API 令牌。

• 插件管理：您可以启用插件管理，以便在工作区中安装、删除或更新社区插件。这使您可以访问更多的数据来源和可视化，并控制您使用的每个插件的版本。

• 指标跟踪：配置跟踪数据来源，以添加指向带有查询和标签的指标链接。

• 画布面板：一种新的面板可视化效果，包含静态和动态元素，用于创建包含图像和叠加文本的数据驱动型自定义面板。

• 重新整理界面：更新了 UI，在 Grafana 控制台中导航更加方便。

• CloudWatch：Amazon CloudWatch 数据源现在可以跨界 AWS 账户 监控指标 AWS 区域。

• 日志：改进了日志详细信息的界面。

• 常规：整个过程中，修复了错误并进行了细微改进。

• 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 查询已移除：不再支持 Application Insights 和 Insight Analytics 查询。

  在 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 的版本已终止支持。参见第 #48715 期GitHub。

• Explore URL 格式已停用：简洁 Explore URL 将在未来版本中移除。

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

• GitHub OAuth 显示发生了变化 — GitHub 名称和登录显示已更新。

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

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

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

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

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

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

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

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

  lvl 现在为 level。eror 和 dbug 现在为 error 和 debug。提高了时间戳精度。 Opt-out 可使用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。