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.