文档 Grafana 文档 新特性 Grafana v10.2 的新特性

Grafana v10.2 的新特性

欢迎来到 Grafana 10.2！请继续阅读，了解仪表盘和可视化、数据源、安全和认证等方面的变化。我们特别高兴地宣布，仪表盘增加了生成式 AI 功能，新增了一种基本角色，并且可视化转换功能得到了改进。

有关此版本中所有更改的更多详细信息，请参阅更新日志。有关升级到 v10.2 的具体推荐步骤，请查看我们的升级指南。

与世界分享您的仪表盘：公共仪表盘正式发布

在所有 Grafana 版本中正式可用

公共仪表盘允许您无需登录即可与更广泛的受众分享您的可视化和洞察。您可以轻松使用我们当前的共享模型，创建公共仪表盘 URL，并通过生成的公共 URL 链接与任何人分享。要了解更多信息，请参阅公共仪表盘文档，以及以下视频演示

使用内容大纲在探索中导航冗长、混合的数据

在所有 Grafana 版本中正式可用

介绍 Grafana Explore 中的内容大纲。当您运行复杂的混合查询或在日志和追踪之间切换时，很容易迷失方向。内容大纲是我们实现从日志行到追踪再回到查询无缝导航的第一步，在保留上下文的同时确保更快地搜索。通过 Grafana Explore 中的此更新，体验高效且上下文相关的调查。要了解更多信息，请参阅内容大纲文档，以及以下视频演示。

关联

Grafana 关联 (Correlations) 是一项新的公开预览功能，您可以使用它来建立从任何数据源查询到其他数据源的链接，并携带命名空间、主机或标签值等数据。这对于使用多种数据源进行根因分析非常强大。有关更多信息，请参阅文档。

在 Grafana Explore 中轻松创建关联

在所有 Grafana 版本中公开预览可用

创建关联变得更加容易。通过从顶部栏或命令面板中选择 + 添加 > 添加关联 选项，尝试在 Explore 中使用我们新的关联编辑器。编辑器会显示所有可以放置数据链接的位置，并指导您构建和测试目标查询。有关更多信息，请参阅文档。

要试用关联，请启用 correlations 功能开关。

为已预配的数据源创建关联

在所有 Grafana 版本中公开预览可用

在 Grafana 的早期版本中，如果数据源已被预配，唯一向其添加关联的方法也是通过预配。现在，情况不再如此，您可以轻松地结合两种方法创建新关联——使用管理页面或预配。有关更多信息，请参阅文档。

要试用关联，请启用 correlations 功能开关。

仪表盘和可视化

使用 AI 生成标题、描述和变更摘要

在所有 Grafana 版本中公开预览可用

您现在可以使用生成式 AI 协助您处理 Grafana 仪表盘。目前生成式 AI 可以帮助您完成以下任务

• 生成面板和仪表盘标题及描述 - 您现在可以根据添加到面板或仪表盘的数据生成其标题和描述。这在您想快速可视化数据而不想花费时间构思标题或描述时非常有用。
• 生成仪表盘保存更改摘要 - 您现在可以在保存仪表盘时生成您所做更改的摘要。这对于轻松跟踪仪表盘的历史记录非常有用。

要启用这些功能，您必须首先启用 dashgpt 实验性功能开关。然后安装和配置 Grafana 的 LLM 应用插件。有关更多信息，请参阅Grafana LLM 应用插件文档。

启用后，在面板和仪表盘的标题和描述字段旁边，或在您按下保存按钮时，查找 ✨ 自动生成 选项。

使用新的仪表盘浏览屏幕更快地找到您的仪表盘

在所有 Grafana 版本中正式可用

新的仪表盘浏览屏幕采用了更紧凑的设计，使导航、搜索和管理您的文件夹和仪表盘变得更加容易。新界面还带来了许多性能改进，特别是对于包含大量文件夹和仪表盘的实例。

为了使文件夹的使用更简单、更一致，不再有特殊的通用文件夹。没有文件夹的仪表盘，或以前在通用文件夹中的仪表盘，现在显示在根级别。

要试用此功能，请转到您的 Grafana 实例中的仪表盘部分。

在 Canvas 可视化中创建交互式按钮

在所有 Grafana 版本中公开预览可用

您现在可以向 Canvas 可视化添加按钮。按钮可以配置为调用 API 端点。这将 Grafana 的能力提升到新的高度，允许您创建可用于控制外部系统的交互式仪表盘。

要了解更多信息，请参阅我们的Canvas 按钮元素文档，以及以下视频演示。

放大时间序列和 K 线图可视化中的 y 轴

在所有 Grafana 版本中正式可用

您现在可以放大时间序列和 K 线图可视化中的 y 轴。这在您想关注特定值范围时非常有用。要在受支持的可视化中放大 y 轴，请按住 Shift 键并点击拖动；双击可重置缩放。

按字段单独计算可视化最小值/最大值

在所有 Grafana 版本中正式可用

当可视化值范围广泛的多个字段时，基于所有字段计算可视化的最小值或最大值可能会隐藏有用的细节。

在这个统计可视化示例中，很难了解每个系列的值与其历史值之间的关系。A 系列超出了 10% 的阈值，尽管 A 系列低于其历史最大值的 10%。

现在，您可以根据单个字段的最低值和最高值自动计算每个可视化字段的最小值或最大值。此设置在大多数可视化的标准选项中可用。

在这个示例中，使用相同的数据，并为每个单独的字段计算最小值和最大值，我们可以更好地了解当前值与历史值之间的关系。A 系列不再超出 10% 的阈值；实际上，现在清楚地表明它正处于历史低点。

这不仅在统计可视化中有用——仪表、条形仪表和状态历史可视化、按阈值格式化的表格单元格以及仪表表格单元格都受益于此新增功能。

数据可视化体验改进

在所有 Grafana 版本中正式可用

我们对 Grafana 中的数据可视化体验进行了一系列较小的改进。

地理地图标记符号对齐选项

您现在可以将地理地图标记符号偏移基础数据点。

仪表可视化溢出支持

您现在可以垂直和水平方向可视化带溢出功能的仪表。这解决了当仪表数量超出可用空间时设计会中断的问题。

柱状图轴改进

您现在可以将柱状图轴中心设置为零，并配置轴边框和颜色设置。

数据源和查询

Tempo 数据源

在过去几个月里，我们特别关注了 Tempo 数据源，新增了功能、改进了查询性能，并提供了更好的查询体验。

使用“聚合依据”搜索选项计算按属性聚合的 spans 的 RED 指标

在所有 Grafana 版本中实验性可用

需要 Tempo 或 Grafana Enterprise Traces (GET) v2.2 或更高版本。

我们在 TraceQL 查询编辑器中添加了“聚合依据”选项，以利用 Tempo 的 metrics summary API。您可以计算过去一小时内接收到的符合过滤条件的 kind=server spans 的 RED 指标（总 span 数、错误 spans 百分比和延迟信息），并按您指定的任何属性进行分组。

此功能默认禁用。要启用它，请使用 metricsSummary 实验性功能开关。

有关更多信息，请参阅文档，以及以下视频演示。

使用改进的 TraceQL 编辑器更轻松地查询追踪

在所有 Grafana 版本中正式可用

TraceQL 查询编辑器已得到改进，以方便创建 TraceQL 查询。特别是，它现在具有改进的自动补全、语法高亮和错误报告功能。

按追踪分组多个 span 集

在所有 Grafana 版本中正式可用

TraceQL 查询编辑器已得到改进，以方便在 TraceQL 查询中按追踪分组多个 spans。例如，当 by(resource.service.name) 添加到您的 TraceQL 查询时，它将按 resource.service.name 对每个追踪中的 spans 进行分组。

为 Tempo 数据源创建查询类型模板变量

在所有 Grafana 版本中正式可用

Tempo 数据源现在支持查询类型模板变量。通过此更新，您可以创建变量，其值是 Tempo 接收到的 spans 上看到的属性名称列表或属性值列表。

要了解更多信息，请参阅以下视频演示，以及Grafana 变量文档。

SAP HANA®：使用租户数据库实例名称和编号配置您的数据源

在 Grafana 企业版和 Grafana Cloud 中正式可用

SAP HANA® 数据源现在支持使用数据库名称和/或实例编号进行租户数据库连接。这很有帮助，因为这些信息不像数据库端口那样容易更改。有关更多信息，请参阅我们的SAP HANA® 配置文档。

Datadog：聚合日志以计算指标和时间序列

在 Grafana 企业版和 Grafana Cloud 中正式可用

Datadog 数据源现在支持日志聚合。此功能有助于将日志/事件聚合成桶，并计算指标和时间序列。有关更多信息，请参阅Datadog 日志聚合。

Datadog：限制来自 Datadog 数据源的请求速率

在 Grafana 企业版和 Grafana Cloud 中正式可用

在 Datadog 数据源中，您现在可以根据上游速率限制阻止指标查询的 API 请求。通过此更新，您可以设置一个速率限制百分比，当达到该百分比时，插件将停止发送查询。

要了解更多信息，请参阅Datadog 数据源设置，以及以下视频演示。

Microsoft SQL Server：支持 Azure 认证（服务主体/MSI）

在所有 Grafana 版本中正式可用

我们已在 MS SQL 插件中增加了对 Azure 认证（服务主体/MSI）的支持，以认证并允许查询存储在 SQL Managed Instance 数据库中的内容。

通过在您的配置文件 (/conf/<您的配置文件>.ini) 中的 Azure 部分下将 managed_identity_enabled 属性设置为 true 来启用此功能。然后，在 Microsoft SQL Server 数据源配置 UI 中执行以下步骤

1. 在认证下，在下拉菜单中选择Azure AD 认证以显示Azure 认证设置部分。
2. 在此部分中，选择托管标识或应用注册。
3. 相应地输入凭据。

在Microsoft SQL Server 文档中了解更多信息。

转换

随着我们在改进数据转换用户体验方面的工作持续进行，我们还一直在为转换添加新功能。

在转换中使用仪表盘变量

在所有 Grafana 版本中实验性可用

此前，唯一支持仪表盘变量的转换是“从计算添加字段”转换。我们现在已将变量支持扩展到“按值过滤”、“创建热力图”、“直方图”、“排序依据”、“限制”、“按名称过滤”和“按字段连接”转换。

我们还通过在支持变量的字段中显示可用变量（可在下拉菜单中或在您输入 $ 或按下 Ctrl + Space 时作为建议显示），从而更容易找到正确的仪表盘变量。

“从计算添加字段”转换的新模式

在所有 Grafana 版本中正式可用

“从计算添加字段”转换已更新。

一元运算是一种新模式，允许您对字段应用数学运算。当前支持的操作有

• 绝对值 (abs) - 返回给定表达式的绝对值。它表示其与零的距离作为正数。
• 自然指数 (exp) - 返回 e 的给定表达式次幂。
• 自然对数 (ln) - 返回给定表达式的自然对数。
• 向下取整 (floor) - 返回小于或等于给定表达式的最大整数。
• 向上取整 (ceil) - 返回大于或等于给定表达式的最小整数。

此外，行索引现在可以以百分比显示索引。

在从计算添加字段文档中了解更多信息。

使用转换格式化字符串

在所有 Grafana 版本中实验性可用

使用新的格式化字符串转换，您可以操作字符串字段以改善其显示方式。当前支持的操作有

• 更改大小写 将您的字符串的大小写更改为大写、小写、句首大写、标题大写、Pascal case、camel case 或 snake case。
• 修剪 删除字符串开头和结尾的空白字符。
• 子字符串 选择您的字符串字段的一部分。

在格式化字符串文档中了解更多信息。

查看哪些转换适用于您的数据

在所有 Grafana 版本中公开预览可用

我们已添加初步支持，以检测基于当前数据各种转换无法正常工作的情况。以前，选择合适的转换并正确配置它需要反复试验或事先了解给定转换的工作原理。现在，我们检测到无法使用的转换会在界面中显示为灰色，并附有解释原因的提示信息。

如果您设置了 transformationsRedesign 功能标志，您将立即可以使用此功能。如果您想尝试，请在您的Grafana 配置中启用此功能标志。

在“格式化时间”和“转换字段类型”转换中选择时区

在所有 Grafana 版本中正式可用

我们已增加了在使用格式化时间和转换字段类型转换将时间格式化为字符串时手动设置时区的支持。这允许将时间相对于全球任何时区进行格式化。

告警

告警的 Grafana OnCall 集成

在所有 Grafana 版本中正式可用

使用 Grafana 告警 - Grafana OnCall 集成，轻松地将 Grafana 告警生成的告警与 Grafana OnCall 连接起来。然后，您可以根据定义的升级链和排班表进行路由。

要了解更多信息，请参阅告警的 Grafana OnCall 集成文档，以及以下视频演示。

将告警资源导出到 Terraform

在所有 Grafana 版本中正式可用

将您的告警资源（如告警规则、联系点和通知策略）导出为 Terraform 资源。告警规则新增了“修改导出”模式，使您能够编辑已预配的告警规则并导出修改后的版本。

外部 Alertmanager 的附加联系点

在 Grafana 开源版和企业版中正式可用

在使用外部 Alertmanager 时，我们已增加了对 Microsoft Teams 联系点的支持。

认证和授权

无基本角色

在 Grafana 企业版和 Grafana Cloud 中正式可用

我们很高兴引入“无基本角色”，这是一个没有任何权限的新基本角色。Grafana 中的基本角色规定了用户或实体可以执行的操作集合，称为权限。如果您希望为服务账号或用户定制个性化的 RBAC 权限，此新角色特别有用。您可以通过 API 或 UI 将其设置为基本角色。

以前，权限是基于预定义的权限集授予的。现在，有了“无基本角色”，您可以更加精细地控制权限。

有关基本角色和权限的更多详细信息，请参阅文档。

新的服务账号权限

服务账号允许您创建令牌来访问 Grafana 的 API 和仪表盘。服务账号是用于向 Grafana API 进行认证和访问数据源的强大工具。但是，如果没有适当的访问控制，服务账号可能会对您的 Grafana 实例构成安全风险。在 Grafana 10.2 中，我们增加了新的工具来限制服务账号仅访问其所需的资源。

为服务账号添加仪表盘和文件夹权限

在所有 Grafana 版本中正式可用

在此版本中，我们增加了为服务账号分配仪表盘和文件夹权限的功能。这意味着您现在可以创建一个服务账号，该账号只能用于访问特定仪表盘，而不能访问其他内容。

如果您想限制服务账号对 Grafana 实例的访问，这非常有用。

在我们的仪表盘和文件夹权限文档中了解更多信息。

为服务账号添加数据源权限

在 Grafana Cloud 和 Grafana 企业版中正式可用

Grafana 10.2 还引入了为服务账号分配数据源权限的功能，适用于 Grafana Cloud 和企业版用户。借助此功能，您可以创建一个服务账号，该账号只能访问特定数据源，而不能访问其他内容。这在您想限制服务账号对 Grafana 实例的访问的场景中非常有用。

例如，假设您有一个开发团队需要访问特定数据源以开发新功能。与其授予他们对 Grafana 实例的完全访问权限，您可以创建一个服务账号，该账号仅能访问该数据源。这样，您可以限制服务账号被泄露可能造成的潜在损害。

在我们的数据源权限文档中了解更多信息。

对 Google OIDC 的角色映射支持

在所有 Grafana 版本中正式可用

现在，在使用 Google OIDC 时，您可以将 Google 群组映射到 Grafana 组织角色。如果您想限制用户对 Grafana 实例的访问，这非常有用。

我们还增加了在使用 Google OIDC 时控制允许的群组的支持。

请参阅Google 认证文档，了解如何使用这些新选项。

为 OAuth 提供商单独配置刷新令牌处理

在所有 Grafana 版本中公开预览可用

在 Grafana v9.3 中，我们引入了一个名为 accessTokenExpirationCheck 的功能开关。通过检查访问令牌的过期状态并在用户使用其中一个 OAuth 提供商登录时自动刷新已过期的访问令牌，它提高了 Grafana 的安全性。

在此当前版本中，我们为每个 OAuth 提供商引入了一个新的配置选项 use_refresh_token，它允许您配置特定 OAuth 集成是否应使用刷新令牌在访问令牌过期时自动刷新。此外，为了进一步提高安全性并提供安全的默认设置，对于支持自动刷新令牌或客户端控制获取刷新令牌的提供商，use_refresh_token 默认是启用的。以下 OAuth 提供商默认启用此选项：AzureAD、GitLab、Google。

有关如何设置刷新令牌处理的更多信息，请参阅特定 OAuth 提供商的文档。。

在创建和更新自定义角色时进行权限验证

在 Grafana 企业版和 Grafana Cloud 中正式可用

在此当前版本中，我们默认启用了 RBAC 权限验证（rbac.permission_validation_enabled 设置）。这意味着在创建或更新自定义角色时，请求中提供的权限将对照可用权限及其范围列表进行验证。如果请求包含不可用的权限或权限范围无效，则请求将被拒绝并返回错误消息。

记录的查询：从单个查询记录多个指标

在 Grafana 企业版和 Grafana Cloud 中正式可用

记录的查询提供了一种方法，可以将静态数值（例如，特定时间开放的 GitHub 问题数量，或数据库表中的行数）定期记录为 Prometheus 指标。这对于跟踪一段时间内的数值以便后续快速查询非常有用。以前，记录的查询仅限于单个系列，因此您需要将查询缩小到单个数值才能进行记录。现在，您可以通过单个记录的查询记录多个指标，这使得它们功能更强大且更易于创建和管理。