Breaking changes in Grafana v10.3

Following are breaking changes that you should be aware of when upgrading to Grafana v10.3. Breaking changes that were introduced in release 10.2.3 are also included here and are marked with an asterisk.

For our purposes, a breaking change is any change that requires users or operators to do something. This includes:

  • Changes in one part of the system that could cause other components to fail

  • Deprecations or removal of a feature

  • Changes to an API that could break automation

  • Changes that affect some plugins or functions of Grafana

  • Migrations that can’t be rolled back

For each change, the provided information:

  • Helps you determine if you’re affected

  • Describes the change or relevant background information

  • Guides you in how to mitigate for the change or migrate

  • Provides more learning resources

For release highlights and deprecations, refer to our v10.3 What’s new. For the specific steps we recommend when you upgrade to v10.3, check out our Upgrade guide.

General breaking changes

Transformations*

In panels using the extract fields transformation, where one of the extracted names collides with one of the already existing fields, the extracted field will be renamed. Issue #77569.

If you use the Table visualization, you might see some inconsistencies in your panels. We have updated the table column naming. This will potentially affect field transformations and/or field overrides. To resolve this, either:

  • Update the transformation you are using

  • Update field override. Issue #76899.

Users who have transformations with the Time field might see their transformations are not working. Those panels that have broken transformations will fail to render. This is because we changed the field key. See related PR: #69865. To resolve this, either:

  • Remove the affected panel and re-create it

  • Select the Time field again

  • Edit the time field as Time for transformation in panel.json or dashboard.json. Issue #76641.

Data source permissions*

The following data source permission endpoints have been removed:

  • GET /datasources/:datasourceId/permissions

  • POST /api/datasources/:datasourceId/permissions

  • DELETE /datasources/:datasourceId/permissions

  • POST /datasources/:datasourceId/enable-permissions

  • POST /datasources/:datasourceId/disable-permissions

Please use the following endpoints instead:

  • GET /api/access-control/datasources/:uid for listing data source permissions

  • POST /api/access-control/datasources/:uid/users/:id, POST /api/access-control/datasources/:uid/teams/:id, and POST /api/access-control/datasources/:uid/buildInRoles/:id for adding or removing data source permissions

If you are using the Grafana provider for Terraform to manage data source permissions, you will need to upgrade your provider to version 2.6.0 or newer to ensure that data source permission provisioning keeps working. Issue #5880.