Skip to content

Commit 8211492

Browse files
authored
Merge pull request #312851 from hhunter-ms/hh-558556
[AMG] Grafana 11 deprecation updates
2 parents d9eeef2 + 3fc9967 commit 8211492

7 files changed

Lines changed: 29 additions & 25 deletions

File tree

Lines changed: 22 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,20 @@
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+
Starting June 15th, 2026, Azure Managed Grafana support for Grafana 11 will be retired. This guide provides information about the upcoming retirement of Grafana 11 and guides you through upgrading your Azure Managed Grafana workspace to Grafana 12 by June 15, 2026.
1616

17-
> [!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.
17+
Workspaces still running Grafana version 11 after June 15, 2026, will be automatically upgraded to Grafana 12.
1918

2019
## Prerequisites
2120

@@ -32,9 +31,9 @@ In the Azure portal:
3231

3332
1. Open your Azure Managed Grafana workspace.
3433
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.
34+
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.
3635

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

3938
### [Azure CLI](#tab/azure-cli)
4039

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

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.
46+
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.
4847

4948
---
5049

51-
## Upgrade to Grafana 11
50+
## Upgrade to Grafana 12
5251

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

5554
> [!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.
55+
> 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.
5756
5857
> [!CAUTION]
59-
> Upgrading to Grafana 11 is irreversible.
58+
> Upgrading to Grafana 12 is irreversible.
6059
6160
### [Portal](#tab/azure-portal)
6261

6362
In the Azure portal:
6463

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.
64+
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.
65+
1. Under **Grafana Version**, select **12**.
66+
1. Select **Save** on top to save the new settings and trigger the upgrade to Grafana version 12.
6867

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.":::
68+
:::image type="content" source="media/grafana-12-upgrade/save-upgrade.png" alt-text="Screenshot of the Azure portal showing Grafana version 12 selected in the dropdown menu and the Save button highlighted.":::
7069

7170
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**.
7271

7372
### [Azure CLI](#tab/azure-cli)
7473

7574
In the Azure CLI:
7675

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.
76+
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.
7877

7978
```azurecli
80-
az grafana update --name <azure-managed-grafana-workspace> --resource-group <azure-managed-grafana-resource-group-name> --major-version 11
79+
az grafana update --name <azure-managed-grafana-workspace> --resource-group <azure-managed-grafana-resource-group-name> --major-version 12
8180
```
8281
83-
1. The CLI displays a warning indicating that upgrading to Grafana version 11 is a permanent an irreversible operation.
82+
1. The CLI displays a warning indicating that upgrading to Grafana version 12 is a permanent an irreversible operation.
8483
---
8584
8685
## Next step
8786
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.
87+
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.
8988
9089
> [!div class="nextstepaction"]
9190
> [Find help or open a support ticket](./find-help-open-support-ticket.md)
Binary file not shown.
Binary file not shown.
120 KB
Loading
130 KB
Loading

articles/managed-grafana/toc.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -107,8 +107,8 @@ items:
107107
href: how-to-migrate.md
108108
- name: Configure Grafana settings
109109
href: grafana-settings.md
110-
- name: Upgrade to Grafana 11
111-
href: how-to-upgrade-grafana-11.md
110+
- name: Upgrade to Grafana 12
111+
href: how-to-upgrade-grafana-12.md
112112
- name: Migrate from Essential service tier
113113
href: how-to-migrate-essential-service-tier.md
114114
- name: Troubleshoot issues

redirects/.openpublishing.redirection.managed-grafana.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,11 @@
99
"source_path_from_root": "/articles/managed-grafana/how-to-sync-teams-with-aad-groups.md",
1010
"redirect_url": "/azure/managed-grafana/how-to-sync-teams-with-azure-ad-groups",
1111
"redirect_document_id": false
12+
},
13+
{
14+
"source_path_from_root": "/articles/managed-grafana/how-to-upgrade-grafana-11.md",
15+
"redirect_url": "/azure/managed-grafana/how-to-upgrade-grafana-12",
16+
"redirect_document_id": false
1217
}
1318
]
1419
}

0 commit comments

Comments
 (0)