Upgrade to Grafana 11

Azure Managed Grafana will stop offering Grafana 10 as a supported software version on July 31, 2025. This guide provides information about the retirement of Grafana 10 and guides you through updating your Azure Managed Grafana workspace to Grafana 11.

Important

We recommend that you familiarize yourself with the breaking changes introduced in Grafana 11 and upgrade your workspace to Grafana 11 before August 2025. If your workspace is still running Grafana version 10 in August 2025, it will be automatically upgraded to Grafana 11.

Prerequisites

Retirement timeline

The following table outlines the retirement timeline.

Key dates Status
March 2025 Users can start to upgrade existing workspaces to Grafana 11.
June 2025
  • All new workspaces use Grafana 11. Creating new workspaces on Grafana 10 is disabled.
  • Users can still upgrade existing workspaces to Grafana 11.
  • August 2025 All workspaces are forcibly upgraded to Grafana 11.

    Check the version of your Grafana workspace

    To find out if your Azure Managed Grafana workspace needs to be upgraded, check the version of Grafana your workspace is running.

    In the Azure portal:

    1. Open your Azure Managed Grafana workspace.

    2. In the left menu, under Settings select Configuration.

    3. Review the Grafana version listed under Grafana Version. If version 10 is selected in the dropdown menu, your workspace is on the Grafana version that is reaching end of life and is scheduled for retirement. We recommend that you upgrade your workspace to Grafana 11 by following the steps below. If your Grafana version is Grafana 11, no further action is necessary.

      Screenshot of the Azure platform showing Grafana Version 9.

    Upgrade to Grafana 11

    Upgrade from Grafana 10 to Grafana 11 by following the steps below.

    Important

    Grafana 11 includes significant breaking changes. Make sure to review the Grafana Breaking changes in Grafana v11.0 article thoroughly before upgrading your workspace.

    Caution

    Upgrading to Grafana 11 is irreversible.

    In the Azure portal:

    1. Once you have reviewed the breaking changes in Grafana 11 and are ready to proceed with the upgrade, open your workspace and select Settings > Configuration from the left menu.

    2. Under Grafana Version, select 11.

    3. Select Save on top to save the new settings and trigger the upgrade to Grafana version 11.

      Screenshot of the Azure portal showing Grafana version 11 selected in the dropdown menu and the Save button highlighted.

    4. A notification appears, indicating that the upgrade is in progress. In the Overview page, Grafana’s Provisioning State is Provisioning until the upgrade is complete. After a few minutes, a notification appears, and the provisioning state becomes Succeeded.