Skip to content

Commit a88a987

Browse files
committed
update docs for grafana 12
Signed-off-by: Hannah Hunter <[email protected]>
1 parent 160fe14 commit a88a987

4 files changed

Lines changed: 24 additions & 24 deletions

File tree

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
---
2-
title: Upgrade Azure Managed Grafana to Grafana 11
2+
title: Upgrade Azure Managed Grafana to Grafana 12
33
titleSuffix: Azure Managed Grafana
4-
description: "Learn how to upgrade an Azure Managed Grafana workspace from Grafana 10 to Grafana 11."
4+
description: "Learn how to upgrade an Azure Managed Grafana workspace from Grafana 11 to Grafana 12."
55
ms.service: azure-managed-grafana
66
author: maud-lv
77
ms.author: malev
8-
ms.date: 09/23/2025
8+
ms.date: 03/09/2026
99
ms.topic: how-to
10-
# customerIntent: As a user of Azure Managed Grafana, I want to upgrade my workspace from Grafana 10 to Grafana 11.
10+
# customerIntent: As a user of Azure Managed Grafana, I want to upgrade my workspace from Grafana 11 to Grafana 12.
1111
---
1212

13-
# Upgrade to Grafana 11
13+
# Upgrade to Grafana 12
1414

15-
Azure Managed Grafana stopped offering Grafana 10 for new resources as of 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.
15+
Azure Managed Grafana stopped offering Grafana 11 for new resources as of July 31, 2025. This guide provides information about the retirement of Grafana 11 and guides you through updating your Azure Managed Grafana workspace to Grafana 12.
1616

1717
> [!IMPORTANT]
18-
> We recommend that you familiarize yourself with the [breaking changes introduced in Grafana 11](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v11-0/) and upgrade your workspace to Grafana 11 by October 31, 2025. Workspaces still running Grafana version 10 after this date will be automatically upgraded to Grafana 11.
18+
> We recommend that you familiarize yourself with the [breaking changes introduced in Grafana 12](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-0/) and upgrade your workspace to Grafana 12 by June 15, 2026. Workspaces still running Grafana version 11 after this date will be automatically upgraded to Grafana 12.
1919
2020
## Prerequisites
2121

@@ -32,9 +32,9 @@ In the Azure portal:
3232

3333
1. Open your Azure Managed Grafana workspace.
3434
1. In the left menu, under **Settings** select **Configuration**.
35-
1. 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.
35+
1. Review the Grafana version listed under **Grafana Version**. If version 11 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 12 by following the steps below. If your Grafana version is Grafana 12, no further action is necessary.
3636

37-
:::image type="content" source="media/grafana-11-upgrade/check-grafana-version.jpg" alt-text="Screenshot of the Azure platform showing Grafana Version 9.":::
37+
:::image type="content" source="media/grafana-12-upgrade/check-grafana-version.jpg" alt-text="Screenshot of the Azure platform showing Grafana Version 9.":::
3838

3939
### [Azure CLI](#tab/azure-cli)
4040

@@ -44,48 +44,48 @@ Run the command [az grafana show](/cli/azure/grafana#az-grafana-show) in the Azu
4444
az grafana show --name <azure-managed-grafana-workspace>
4545
```
4646

47-
The version number is listed in the output after `grafanaMajorVersion`. If version is `10`, 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 `11`, no further action is necessary.
47+
The version number is listed in the output after `grafanaMajorVersion`. If version is `11`, 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 12 by following the steps below. If your Grafana version is `12`, no further action is necessary.
4848

4949
---
5050

51-
## Upgrade to Grafana 11
51+
## Upgrade to Grafana 12
5252

53-
Upgrade from Grafana 10 to Grafana 11 by following the steps below.
53+
Upgrade from Grafana 11 to Grafana 12 by following the steps below.
5454

5555
> [!IMPORTANT]
56-
> Grafana 11 includes significant breaking changes. Make sure to review the [Grafana Breaking changes in Grafana v11.0](https://grafana.com/docs/grafana/latest/breaking-changes/breaking-changes-v11-0/) article thoroughly before upgrading your workspace.
56+
> Grafana 12 includes significant breaking changes. Make sure to review the [What's new in Grafana v12.0](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-0/) article thoroughly before upgrading your workspace.
5757
5858
> [!CAUTION]
59-
> Upgrading to Grafana 11 is irreversible.
59+
> Upgrading to Grafana 12 is irreversible.
6060
6161
### [Portal](#tab/azure-portal)
6262

6363
In the Azure portal:
6464

65-
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.
66-
1. Under **Grafana Version**, select **11**.
67-
1. Select **Save** on top to save the new settings and trigger the upgrade to Grafana version 11.
65+
1. Once you have reviewed the breaking changes in Grafana 12 and are ready to proceed with the upgrade, open your workspace and select **Settings** > **Configuration** from the left menu.
66+
1. Under **Grafana Version**, select **12**.
67+
1. Select **Save** on top to save the new settings and trigger the upgrade to Grafana version 12.
6868

69-
:::image type="content" source="media/grafana-11-upgrade/save-upgrade.jpg" alt-text="Screenshot of the Azure portal showing Grafana version 11 selected in the dropdown menu and the Save button highlighted.":::
69+
:::image type="content" source="media/grafana-12-upgrade/save-upgrade.jpg" alt-text="Screenshot of the Azure portal showing Grafana version 12 selected in the dropdown menu and the Save button highlighted.":::
7070

7171
1. 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**.
7272

7373
### [Azure CLI](#tab/azure-cli)
7474

7575
In the Azure CLI:
7676

77-
1. Once you have reviewed the breaking changes in Grafana 11 and are ready to proceed with the upgrade, run the [az grafana update](/cli/azure/grafana#az-grafana-update) command and replace `<azure-managed-grafana-workspace>` with the name of your Azure Managed Grafana workspace.
77+
1. Once you have reviewed the breaking changes in Grafana 12 and are ready to proceed with the upgrade, run the [az grafana update](/cli/azure/grafana#az-grafana-update) command and replace `<azure-managed-grafana-workspace>` with the name of your Azure Managed Grafana workspace.
7878

7979
```azurecli
80-
az grafana update --name <azure-managed-grafana-workspace> --resource-group <azure-managed-grafana-resource-group-name> --major-version 11
80+
az grafana update --name <azure-managed-grafana-workspace> --resource-group <azure-managed-grafana-resource-group-name> --major-version 12
8181
```
8282
83-
1. The CLI displays a warning indicating that upgrading to Grafana version 11 is a permanent an irreversible operation.
83+
1. The CLI displays a warning indicating that upgrading to Grafana version 12 is a permanent an irreversible operation.
8484
---
8585
8686
## Next step
8787
88-
In this article, you have been guided through upgrading your Azure Managed Grafana workspace from Grafana 10 to Grafana 11. If needed, go to the following guide for additional support.
88+
In this article, you have been guided through upgrading your Azure Managed Grafana workspace from Grafana 11 to Grafana 12. If needed, go to the following guide for additional support.
8989
9090
> [!div class="nextstepaction"]
9191
> [Find help or open a support ticket](./find-help-open-support-ticket.md)

articles/managed-grafana/media/grafana-11-upgrade/check-grafana-version.jpg renamed to articles/managed-grafana/media/grafana-12-upgrade/check-grafana-version.jpg

File renamed without changes.

articles/managed-grafana/media/grafana-11-upgrade/save-upgrade.jpg renamed to articles/managed-grafana/media/grafana-12-upgrade/save-upgrade.jpg

File renamed without changes.

articles/managed-grafana/toc.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -103,8 +103,8 @@ items:
103103
href: how-to-migrate.md
104104
- name: Configure Grafana settings
105105
href: grafana-settings.md
106-
- name: Upgrade to Grafana 11
107-
href: how-to-upgrade-grafana-11.md
106+
- name: Upgrade to Grafana 12
107+
href: how-to-upgrade-grafana-12.md
108108
- name: Migrate from Essential service tier
109109
href: how-to-migrate-essential-service-tier.md
110110
- name: Troubleshoot issues

0 commit comments

Comments
 (0)