Grafana v12.0 的新特性

通过与 GitHub 直接连接来升级您的 Grafana 体验。

将您的实例连接到 GitHub 仓库，直接从 Grafana UI 管理您的面板代码。通过启用 Git Sync，您可以像管理代码一样管理面板。面板将在 Git 中进行版本控制，并通过 PR 工作流进行编辑，以便始终能够跟踪更改。

Grafana 的面板 Schema 多年来基本保持不变，最初围绕单个网格布局构建。随着时间推移，它变得越来越复杂，难以使用，混合了不同的关注点并增加了不必要的复杂性。在 Grafana v12 中，我们引入了新的面板 Schema。

借助基于 Scenes 的新架构，我们正在简化 Schema，使其更易于理解并支持强大的新功能，例如动态面板、标签页和画布式布局。新 Schema 还旨在简化面板管理，支持 Git Provisioning 的“即代码”方法。

在此版本中，我们正在重新思考我们的面板 API，并引入一个一致、版本化、面向资源的新模型。我们将其作为实验性功能发布，旨在收集反馈，并在后续版本中向用户提供稳定版本。

新 API 使得 Git Sync 成为可能，并且是支持我们新的 Terraform provider 和创建 GrafanaCTL CLI 工具的关键变更。目前，只有面板、文件夹以及公告横幅和播放列表等少数元素使用了这个新模型，我们计划将其扩展到所有 Grafana 资源。

去年 10 月的 ObsCon 大会上，我们宣布了 Metrics Drilldown 的 GA 版本，并且我们一直在努力扩展其功能，通过几次点击即可帮助您减少需要管理的指标数量。

更快的过滤

• 前缀和后缀过滤器：使用新的前缀和后缀过滤选项优化您的指标探索，从而更精确地定位您要查找的数据。
• 按标签分组：通过按标签对指标进行分组，更有效地组织和理解您的指标。这提供了有价值的上下文并简化了分析。
• 排序选项：根据最近的历史记录、关联的面板和相关告警对指标进行排序，从而自定义您的视图。这使您可以有效地确定优先级和进行调查。

改进的 UI

• 可折叠侧边栏：我们引入了可折叠侧边栏，通过为过滤提供更多屏幕空间，使您可以专注于最重要的数据。
• 更好的指标计数：现在，我们在每次过滤操作后实时提供显示的指标数量，从而立即反馈您选择的影响。

通过对 Metrics Drilldown 的这些增强，我们继续致力于提供强大的工具来简化您的可观测性工作流程并深入了解您的系统。

去年 10 月的 ObsCon 大会上，我们宣布了 Logs Drilldown 的 GA 版本，并且我们一直在努力扩展其功能，帮助您更灵活、更多选项地可视化您的日志数据。

增强的可视化和过滤功能

• 多个包含过滤器：您可以在 Drilldown 查询中指定多个包含过滤器，从而实现更细致、更有针对性的日志检索。
• Regex 支持：我们在标签和字段查询中添加了正则表达式支持，为深入日志分析提供了强大而灵活的模式匹配。
• JSON 可视化：使用我们新的专用 JSON 可视化探索和理解您的 JSON 格式日志条目，使复杂的数据结构更易于阅读和解释。
• 服务选择分页：服务选择现在已分页，使用户更容易查看和发现与服务相关的数据。
• 排序顺序改变查询方向：排序顺序和查询方向现在已链接，使用 Loki 的新查询方向“Forward”。设置“Oldest first”将按照从最旧日志到最新日志的顺序查询您的日志数据。设置“Newest first”将从“Backwards”方向查询您的日志（即从最新日志行到最旧日志行）。

借助 Logs Drilldown 中的这些新功能，我们通过支持更广泛的格式并提供更强大的过滤和可视化选项，使您能够从日志数据中获得更清晰的 Insights。

我们很高兴地宣布 Grafana Traces Drilldown 正式发布 (GA)，为分布式追踪分析带来了简化的无查询体验。基于数月的公共预览反馈和从 Drilldown 套件中学到的经验，此 GA 版本提供了经过优化的集成解决方案，用于深度追踪分析。

主要亮点

• 无需查询的探索变得简单：Traces Drilldown 消除了编写复杂查询的需求。用户可以直接从面板即时访问粒度追踪级别的 Insights。这种“无查询”设计使您能够轻松地将 RED（速率、错误、持续时间）黄金信号与精确的追踪详细信息相关联。
• 无缝导航：享受从高级追踪概览到深度 span 视图的平滑过渡。这种统一的导航体验确保您在从摘要视图切换到详细分析时保持上下文。这种高级的 Drilldown 能力通过提供更快识别根本原因所需的上下文 Insights 来改进事件分析。
• 内置调查工具：Traces Drilldown 界面集成了过滤、突出显示、分解、比较和根本原因关联。这些内置工具可以在无需外部分析工具的情况下快速评估追踪，快速突出异常。
• 详细追踪可视化：一旦您缩小了感兴趣的追踪范围，追踪视图高保真 span 时间线将显示关键元数据、持续时间和状态指示符，帮助您快速识别性能瓶颈和错误的来源。
• 统一的可观测性体验：Traces Drilldown 将追踪与日志、指标和 profiles 连接起来，实现一致的可观测性工作流程。可以轻松地从日志或指标中的异常过渡到详细的追踪视图，使您能够检查 span 和持续时间分解，快速发现底层问题。

GA 版本新增内容

Exemplars

这项全新的功能将在 Grafana v12 中公共预览中推出，旨在通过在一个统一视图中汇集所有相关信号来简化您解决问题的方法。

集中式信号分析以提高 Investigations 效率

• 从任何信号添加面板：Investigations 打破了 Drilldown 应用程序之间的壁垒。您现在可以将 Metrics、Logs 和 Traces Drilldown 中的面板无缝添加到同一个 Investigations 视图中。
• 并排比较不同时间段：在同一视图中比较不同时间段的信号行为，从而获得更深入的 Insights。这有助于快速识别关联和异常。
• 轻松协作：Investigations 使您可以轻松地与参与同一任务的其他团队成员分享您的发现和分析上下文，从而促进更好的协作和更快的解决。

Investigations 提供了一个中心枢纽，用于关联和分析跨不同（原本孤立的）Drilldown 应用程序的各种信号，从而实现更高效和有效的故障排除。

Logs Drilldown 现在包含用于结构化日志行的 JSON 查看器。通过这项新功能，用户可以更轻松地查看、交互以及当然进行 *Drill down* 到其 JSON 数据。此表格允许用户过滤其 JSON 日志行，以便他们可以在日志量可视化等位置仅查看所需的数据。

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

我们很高兴地宣布 Grafana 云迁移助手现已向所有用户正式发布！经过成功的公共预览期后，这个强大的工具已准备好改变自托管 Enterprise 客户和 OSS 用户迁移到 Grafana Cloud 的方式。

简化您的迁移之旅

去年，我们将面板架构迁移到 Scenes 库，为 Grafana 面板的未来解锁了一个更稳定、动态和灵活的基础。今天，我们很高兴展示团队在此基础上构建的功能，重点在于改进核心用户工作流程：导航、使用和编辑面板。

更高效的导航和使用

• 标签页以便更好地组织：使用带标签页的布局构建结构良好的面板，用于不同的上下文和用户组。
• 条件渲染：根据变量选择或数据可用性显示或隐藏可视化，确保相关性。 
• 面板内容大纲：使用此树状结构快速导航面板，使您可以更轻松地跳转到不同部分。

强大的面板编辑

• 新的灵活面板布局选项：使用自定义或自动网格面板布局，并调整列数等设置，以实现自适应面板行为。
• 标签页和行分组：根据需要将面板分组到行或标签页中。还支持嵌套分组以满足复杂的视觉需求。
• 上下文感知编辑：无需进入完全编辑模式即可快速修改标签页、行、面板和变量。
• 智能侧边栏：侧边栏用户界面会根据您的选择进行调整，从而实现快速操作，例如复制元素或设置布局选项。

要试用动态面板，请启用 dashboardNewLayouts 功能开关。由于这仍是一个实验性功能，我们强烈建议不要在生产环境中使用。 

表格可视化面板刚刚获得了重大的性能提升。由于表格可视化已重构为使用 react-data-grid 库，加载、排序和过滤大型表格的速度比以前快了很多倍。

增强功能

性能： 在一个模拟的包含 41,400 行和 17 列的大型表格上，我们看到了以下改进：

充分利用 SQL 的强大功能，随心所欲地操作和组合来自数据源的结果。您可以使用它创建新的面板可视化以及强大的告警和记录规则。

您可以在运行时过滤、进行计算以及跨不同数据源类型进行连接。

我们很高兴地宣布 SCIM 用户和组 Provisioning。

以前，Provisioned 用户需要单独登录 Grafana 才能在平台中存在，并且管理员面临创建和管理团队的耗时任务——无论是手动还是通过 Provisioning。这个过程很复杂，通常会成为新团队成员快速启动和运行的瓶颈。

我们简化了数据源管理告警规则到 Grafana 管理告警规则的迁移。

使用这些工具和 API，您可以将 Prometheus 兼容系统（Prometheus、Mimir、Loki）中的数据源管理告警规则导入到 Grafana 中，作为 Grafana 管理的告警规则。这简化了从数据源告警迁移到 Grafana 管理告警的过程，同时保留了规则的行为。可以通过易于使用的 UI 工具或与 Mimirtool 兼容的 API 端点导入告警规则。

Flapping 告警会产生噪音并掩盖其他问题。现在您可以设置告警在违反阈值表达式不再返回任何结果后保持触发状态的最短时间。这会将告警在一段时间内设置为“恢复中”状态，以便在此期间重新触发的阈值不会触发新的告警。

阅读文档以获取有关如何设置“Keep firing for”持续时间的更多信息，以便您可以使用恢复中状态消除不必要的噪音。

您现在可以恢复或永久删除最近删除的 Grafana 管理的告警规则。转到 Alerts & IRM > Alerting > Recently deleted 查看此功能的实际效果。

为庆祝 Grafana 12 发布，我们向社区提供了几个新的实验性主题的早期访问权限！您可以使用 Sapphire dusk、Tron、Gilded grove、Gloom 或 Desert bloom 来装饰您的 Grafana 体验。要查看主题的颜色方案，请单击页面右上角的用户图标，然后选择 Change theme。

这将打开 Change theme 抽屉，您可以在其中查看所有主题

引入 Explore 中 Logs 的新控件

我们很高兴地引入 Explore 中 Logs 的新控件组件，旨在更好地利用日志周围的布局，并为用户处理日志数据提供更大的灵活性。

在 Grafana Cloud 中，使用追踪进行故障排除变得更快了。通过追踪关联，您可以配置自定义的、上下文感知的链接，直接跳转到追踪视图中的每个 span。只需单击一下，您现在可以从一个追踪跳转到：

• 根据相同追踪或服务字段过滤的日志
• 聚焦于精确服务、端点或错误条件的指标
• 与 span 绑定的 CPU、内存或 heap 快照的 Profiles
• 面板、Runbook、工单或任何能丰富您工作流程的外部 URL

只需在关联中快速创建规则即可。只需定义哪些 span 或追踪字段用作变量，指向您的目标，然后在 Explore 追踪视图中查看上下文链接的出现。

从 Grafana 12.0 开始，配置选项 editors_can_admin 被移除。 

Grafana 中的 editors_can_admin 设置允许具有 Editor 角色的用户创建和管理 Grafana Teams。具有此配置设置的实例中的编辑器不再拥有这些额外的权限。

如果动态面板的功能开关已启用，则现有面板一旦迁移到使用 schema v2 的动态面板，就无法再迁移回去了。此问题将在 Grafana 的未来版本中解决。

此问题仅存在于希望回滚到早期版本的自托管用户以及通过代码 Provisioning 面板的用户。Grafana v12 有一种机制可以解决这两种版本。 

我们对现有指标 cache_size 进行了重复注册。在 Grafana v12 中，我们废弃了该指标，并计划在 Grafana v13 中将其移除，并将其拆分为 2 个不同的指标：

• resource_cache_size
• query_cache_size

虽然可用的指标没有正式文档记录，但您仍可以使用它们来获取实例状态信息。

迁移/缓解

Actions 在 2024 年 10 月作为 DataLinksContextMenu 的可选属性引入，以支持表格可视化上下文菜单中的 Actions。Actions 在功能开关下，因此影响很小。使用 DataLinksContextMenu 组件的其他地方没有其他方式使用该属性，所以我们预计影响很小。

如果确实有影响，那就是 Actions 不会显示在表格可视化的上下文菜单中。

迁移/缓解

我们已经有一套定义 Grafana 对象 UID 的标准方式好几年了。虽然我们所有的内部代码都符合这种格式，但我们尚未在允许创建和更新数据源的 REST API 和 Provisioning 路径中严格强制执行此格式。

在 Grafana v11.2 中，我们添加了一个新的 failWrongDSUID 功能开关，默认关闭。启用后，REST API 和 Provisioning 将拒绝任何创建或更新数据源实例的请求，如果其 UID 不正确。

Angular 插件支持已在 Grafana 11 中废弃并默认关闭，现在将在 Grafana v12 中移除。这意味着，从 Grafana v12 开始，将无法再在 Grafana 中使用任何 Angular 插件，并且仍然使用“核心”Angular 面板的面板将被强制迁移到使用 React 的最新版本。

欲了解更多信息，请参阅我们的博客文章和文档。

我们将移除 UI 扩展 API 的废弃版本，转而采用 Grafana v11.4 中引入的新的响应式 API。新的 API 使 Grafana 可以在需要时按需延迟加载带 UI 扩展的插件，而无需在启动 Grafana 之前加载它们。它们还使 UI 具有响应性，因此当 UI 扩展注册表发生变化时，会反映在 UI 中。

这会影响那些使用 UI 扩展但尚未迁移到新 API 的插件开发者。在 Grafana v12 中尝试使用废弃 API 的插件会抛出错误。

迁移/缓解

自 Grafana v10.2 起，使用 grafana cli plugins install 安装插件时用于检查兼容版本的端点发生了变化，导致不再考虑 Grafana 依赖版本。这可能导致 CLI 安装了根据 plugin.json 文件中 grafanaDependency 属性定义的兼容性而言不完全兼容的插件。

在 Grafana v12 中，安装插件时会重新启用 Grafana 版本检查。

引入“按聚合”是为了在 Tempo 数据源中查看追踪的 RED 指标。自 Grafana v11.3 起，此功能已被废弃，转而使用追踪钻取和 TraceQL 指标 API，后者提供了更多功能和复杂特性。此外，TraceQL 指标查询比指标摘要 API 提供的功能强大得多。

迁移/缓解

RED 指标通过追踪钻取得到支持，并且可以比旧的指标摘要 API 查看更高级的上下文。对于所有用户，“按聚合”部分将不再出现在 Tempo 数据源的搜索选项卡中。此外，任何曾在仪表盘中 Tempo 数据源中使用“按聚合”功能的用户都可以手动更改 Tempo 查询。

Grafana Cloud 在“管理员”部分有一个页面显示特性开关。特性开关是一种在某些功能正式发布之前启用或禁用它们的方式。特性开关 UI 显示哪些开关是开启或关闭的，并提供启用或禁用其中一些开关的选项。此 UI 是实验性的。

我们将从 Grafana Cloud 中移除此实验性页面，因为我们将用一个更健壮的新特性开关系统取代现有系统，而新系统与此 UI 不兼容。