文档 Grafana 文档 重大变更 Grafana v10.3 中的重大变更

Grafana v10.3 中的重大变更

以下是升级到 Grafana v10.3 时应注意的重大变更。v10.2.3 版本中引入的重大变更也包含在此，并标记有星号（*）。

在此文档中，“重大变更”指任何需要用户或操作员采取行动的变更。这包括：

• 系统一部分的更改可能导致其他组件失败
• 功能的弃用或移除
• API 的更改可能导致自动化脚本失效
• 影响部分插件或 Grafana 功能的更改
• 无法回滚的迁移

针对每个变更，提供以下信息：

• 帮助您确定是否受到影响
• 描述变更或相关背景信息
• 指导您如何缓解变更或进行迁移
• 提供更多学习资源

有关版本亮点和弃用项，请参阅我们的v10.3 新特性。有关升级到 v10.3 时推荐的具体步骤，请查看我们的升级指南。

一般重大变更

转换（Transformations）*

在使用提取字段（extract fields）转换的面板中，如果提取的某个名称与现有字段名称冲突，提取的字段将被重命名。Issue #77569。

如果您使用 Table 可视化，您的面板可能会出现一些不一致。我们更新了表格列命名。这可能会影响字段转换和/或字段覆盖。要解决此问题，您可以：

• 更新您正在使用的转换
• 更新字段覆盖。Issue #76899。

使用带有 Time 字段转换的用户可能会发现其转换不再工作。那些转换损坏的面板将无法渲染。这是因为我们更改了字段键。请参阅相关 PR：#69865。要解决此问题，您可以：

• 移除受影响的面板并重新创建
• 再次选择 Time 字段
• 在 panel.json 或 dashboard.json 中将 Time 字段编辑为 Time 进行转换。Issue #76641。

数据源权限*

以下数据源权限端点已被移除：

• GET /datasources/:datasourceId/permissions
• POST /api/datasources/:datasourceId/permissions
• DELETE /datasources/:datasourceId/permissions
• POST /datasources/:datasourceId/enable-permissions
• POST /datasources/:datasourceId/disable-permissions

请改用以下端点：

• GET /api/access-control/datasources/:uid 用于列出数据源权限
• POST /api/access-control/datasources/:uid/users/:id, POST /api/access-control/datasources/:uid/teams/:id, 和 POST /api/access-control/datasources/:uid/buildInRoles/:id 用于添加或移除数据源权限

如果您使用 Terraform 的 Grafana Provider 来管理数据源权限，您需要将 Provider 升级到版本 2.6.0 或更新版本，以确保数据源权限配置继续工作。Issue #5880。