Grafana v9.5 新特性
欢迎使用 Grafana 9.5！我们很高兴分享 Grafana 导航的一些重大更新、告警功能的众多可用性改进以及一些有前景的实验性功能，这些功能将帮助您查询 Prometheus 指标。此外，请继续阅读，了解我们从 API 密钥持续迁移到服务账户的情况，以及弃用使用 Angular 的插件和 InfluxDB 数据源中的一个字段的情况。
有关此版本中所有变更的更多详细信息，请参阅变更日志。对于升级到 v9.5 时我们推荐的具体步骤，请查看我们的升级指南。
Grafana 的新导航功能正式发布
适用于所有版本的 Grafana，功能正式发布。
Grafana 的导航已更新，采用新的设计和改进的结构，使您可以更轻松地访问所需数据。通过此次更新，您可以快速在页面之间导航，全面了解系统的健康状况。
随着 Grafana 从一个可视化平台发展成为全面的可观测性解决方案，我们添加了众多工具来支持用户在整个软件开发生命周期中的工作。这些工具侧重于预防事件、监控应用程序或基础设施以及协助事件响应。然而，新增的功能必须易于发现和导航才能真正起到帮助作用。Grafana 导航体验的这些关键更新有助于解决这个问题。
- 重新设计的导航菜单，将相关工具分组在一起，方便快速访问。
- 一个命令面板，可用于在 Grafana 中执行操作，例如创建仪表盘或导航到应用或页面。
- 更新的布局包含面包屑和侧边栏，使您可以快速在页面之间跳转。
- Grafana 所有页面上新增的页头，包含搜索功能。
加入在 GitHub 上的讨论并分享您的反馈。
仪表盘和可视化
重新设计的空仪表盘状态
适用于所有版本的 Grafana，功能正式发布。
仪表盘已更新，使您可以更轻松地从头开始构建。添加新仪表盘时显示的选项——添加可视化、添加行或导入面板——都包含这些步骤作用的简要说明，以便您自信地开始构建。
此外，仪表盘顶部的“+”图标已被一个带有这些选项的文本 添加 下拉菜单取代。这使得这个元素的功能更加清晰，它不仅允许您添加新面板，还可以执行与构建新仪表盘相关的所有操作。
重新设计的仪表盘面板正式发布
适用于所有版本的 Grafana，功能正式发布。
仪表盘面板包含很多信息，其中一些难以从仪表盘中发现或访问。通过我们重新设计的面板，我们提高了可访问性，并通过添加和移动关键元素，使了解面板状态变得更容易。
我们改进了无标题面板，使面板描述和错误信息更简洁，并从面板头部链接了关键操作。所有这些元素都按行从左到右排列，避免了组件重叠或不可用的情况。
Grafana 的新面板设计仅适用于基于 React 的面板。基于 Angular 的面板，例如旧版 Graph 和 Worldmap 面板，没有进行重新设计。请注意，Angular 已在 Grafana 中被弃用，并将在未来的版本中移除。有关更多信息，请参阅我们的弃用文档。
Prometheus 性能和可用性改进
Prometheus 指标百科全书
所有版本的 Grafana 中的实验性功能。
当您拥有数千（或数百万）个 Prometheus 指标时，找到您正在寻找的那个可能很困难。启用功能开关 prometheusMetricEncyclopedia 将替换 Prometheus 查询构建器中的基本指标选择下拉菜单，代之以可分页且可搜索的指标百科全书。
您可以使用指标百科全书执行以下操作：
- 按名称、类型和描述模糊搜索指标
- 按 Prometheus 类型（gauge、counter、histogram、summary）过滤指标
- 以分页列表显示指标，对结果进行排序，并选择每页显示的结果数量，这样您就不会因为等待搜索结果而花费很长时间
- 查看指标详情，例如类型和描述
- [专家功能] 仅使用后端通过正则表达式搜索指标名称
Prometheus 浏览器缓存
所有版本的 Grafana 中的实验性功能。
新的功能开关 prometheusResourceBrowserCache 提供了在 Prometheus 数据源配置中缓存 Prometheus 编辑器 API 调用 的能力。这提高了 Prometheus 查询编辑器的性能，对于高基数 Prometheus 实例的用户来说，性能提升最为显著。
从 UI 中移除 API 密钥创建功能
通过此次更新，我们在弃用 API 密钥，转而支持服务账户方面又迈进了一步。我们已经从 Grafana 用户界面中移除了创建新 API 密钥的按钮，现在仅允许使用我们的 HTTP API 创建 API 密钥。我们建议您将现有 API 密钥迁移到服务账户，并选择新的服务账户而非新的 API 密钥。此变更是我们淘汰 API 密钥长期策略的一部分。
在我们的 GitHub issue Sunsetting API keys 中了解更多关于 API 密钥弃用策略及其管理方法的信息。
使用支持包更快地解决 Grafana 问题
适用于所有版本的 Grafana，功能正式发布。
支持包提供了一种简单的方式，通过 Grafana 用户界面收集关于您的 Grafana 实例的信息。只需点击几下，您就可以创建一个包含迁移、插件、设置等数据的支持包。创建支持包后，您可以自行检查，或者与同事或 Grafana 工程师分享，以帮助排查 Grafana 实例的问题。
在我们的支持包文档中了解更多关于支持包及其配置方法的信息。
告警
所有告警改进功能在所有版本的 Grafana 中均已正式发布。
从多个数据源搜索告警规则
同时搜索和显示多个数据源的告警规则。
在告警规则列表视图上进行模糊搜索
在告警规则列表视图上搜索命名空间或文件夹、评估组和告警规则名称，结果即时显示，不受拼写错误影响。
从仪表盘或面板访问告警规则
直接从仪表盘或面板导航到告警规则，轻松访问告警规则详情。
从告警规则访问仪表盘或面板
从告警规则直接导航到与该告警规则相关的仪表盘或面板，以可视化您的告警数据。
预览记录规则的查询
在创建或编辑记录规则时可视化查询，以便您在保存记录规则之前查看查询结果。
评估返回无数据时告警行为更新
配置为在评估返回无数据时触发的告警规则，现在仅在整个评估周期持续时间结束后才会触发。这意味着告警规则不再在条件违反时立即触发，而是等待For字段设置的时间结束，然后才触发，从而减少告警噪音并允许临时数据可用性问题。
改进的通知策略视图
通知策略视图的更新使其更易于使用和管理，具体如下：
- 一目了然地查看默认策略和嵌套策略
- 新增静默时间选项卡
- 查看每个策略的告警实例
- 查看联系点以及为每个策略配置了哪些集成
- 查看嵌套策略上继承的属性
- 搜索标签匹配器和联系点，查看通知将发送到哪里
配置 Alertmanager 的指导
配置 Alertmanager 时获取额外帮助。如果您输入了无效的 Alertmanager 配置，将显示错误消息，您可以选择之前正常工作的配置来重新开始。
InfluxDB 插件数据库字段弃用
配置 (provisioning) 文件中的 database 字段已被弃用。此信息将使用 dbName 属性存储在 jsonData 字段中。database 字段将在未来版本中移除，以使 InfluxDB 与其他数据源保持一致。有关更多信息和示例，请参阅InfluxDB 配置文档。
身份验证：锁定从认证提供商同步的组织角色
适用于所有版本的 Grafana，功能正式发布。
Grafana v9.4 提供了为每个 OAuth 提供商配置组织角色同步的功能。启用同步后，用户登录时会应用来自 OAuth 提供商的组织角色。然而，用户登录后，您仍然可以在会话期间更改用户的组织角色。
在此版本中，我们通过引入一个名为 onlyExternalOrgRoleSync 的新功能开关来增强组织角色同步行为。启用此功能后，登录到 Grafana 的用户无法更改已从外部认证提供商（例如 Active Directory 或 Google OAuth）同步的组织角色。这有助于确保合适的用户始终拥有合适的访问级别。
如果您想强制执行从认证提供商到组织角色的严格同步，应使用此功能。
要使用此功能，请启用 onlyExternalOrgRoleSync 功能开关。如果您正在使用 Grafana Cloud 并希望启用此功能，请联系客户支持。在接下来的几周内，我们也将自动为 Grafana Cloud 实例启用此功能。
您也可以阻止从给定认证提供商同步组织角色。在我们的跳过组织角色同步文档中了解更多！
报告 UI 已调整以匹配新导航样式
在 Grafana Enterprise、Cloud Pro 和 Cloud Advanced 中正式发布。
我们更新了报告 UI，使其更好地适应新的导航样式，增加了水平滑块，并将预览和发送按钮移动到页面中的操作部分。我们还修复了不同部分的对齐问题。
使用 JWT 作为认证方法的实验性支持
在 Grafana 开源版和 Enterprise 版中为实验性功能。
此功能增加了使用 JWT 令牌存储渲染密钥的支持，而不是依赖“远程缓存”。它涵盖了大多数渲染用例，尽管有些仍然依赖远程缓存作为存储。您可以通过在 custom.ini 配置文件中启用功能标志 renderAuthJWT 来启用此功能。
给插件开发者的注意事项
Grafana 10 中即将到来的一项重大变更将是我们将升级到 React 18 并使用新的 React 客户端渲染 API。由此我们将获得许多重要的好处：访问新的 React 功能，例如过渡和并发渲染，以及其他通用的性能和安全改进。这些变更现已通过 PR 64428 提交到核心 grafana 仓库。
与任何重大升级一样，这可能会影响您的插件工作方式。特别是，围绕改进 useEffect 时间一致性和状态更新自动批处理的变更可能会导致意外的副作用。
建议采取的行动
- 查阅 React 18 升级文档
- 使用最新的 grafana-dev docker 镜像之一（例如，这个）测试您的插件
- 如果您的插件受到任何影响，请在论坛讨论中添加评论。无论是分享您的插件所需进行的更改，还是寻求帮助，都请在此处留言。
