You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/managed-grafana/how-to-upgrade-grafana-10.md
+10-25Lines changed: 10 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,28 +10,18 @@ ms.topic: how-to
10
10
# customerIntent: As a user of Azure Managed Grafana, I want to upgrade my workspce from Grafana 9 to Grafana 10. I also want to learn about the upgrade of the legacy alerting feature.
11
11
---
12
12
13
-
# Upgrade to Grafana 10
14
-
13
+
# Upgrade to Grafana 10
14
+
15
15
Azure Managed Grafana will stop offering Grafana 9 as a supported software version on 31 August 2024. This guide provides information about the retirement of Grafana 9 and shows you how to update your Azure Managed Grafana workspace to Grafana 10.
16
-
We recommend that you upgrade your workspace to Grafana 10 before the end of August 2024.
16
+
We recommend that you upgrade your workspace to Grafana 10 before the end of August 2024.
17
17
18
-
In September 2024, if your workspace is still on Grafana version 9, it will be automatically upgraded to Grafana 10.
18
+
In September 2024, if your workspace is still on Grafana version 9, it will be automatically upgraded to Grafana 10.
19
19
20
20
## Prerequisites
21
21
22
22
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free).
23
23
- An existing Azure Managed Grafana instance. [Create one if you haven't already](quickstart-managed-grafana-portal.md).
24
24
25
-
## Retirement timeline
26
-
27
-
The following table outlines the retirement timeline.
| March 2024 | Users can start to upgrade existing workspaces to Grafana 10. |
32
-
| July 1-31, 2024 | <li>All new workspaces use Grafana 10. Creating new workspaces on Grafana 9 is disabled. <li> Users can still upgrade existing workspaces to Grafana 10. |
33
-
| September 1-30, 2024 | <li>All workspaces are forcibly upgraded to Grafana 10. <li> Grafana 9 no longer receives updates from Microsoft. |
34
-
35
25
## Check the version of your Grafana workspace
36
26
37
27
To find out if your Azure Managed Grafana workspace needs to be upgraded, start by checking which version of Grafana your workspace is on.
@@ -50,35 +40,30 @@ Some Grafana 9 workspaces have legacy alerting enabled. Legacy alerting is an ou
50
40
Check if your workspace uses legacy alerting or unified alerting by going to the left-hand menu in the Grafana user interface:
51
41
52
42
- If the menu shows **Alerting (legacy)**, the older version of the alerting feature is enabled. It will be updated to unified alerting when the workspace is upgraded to Grafana 10.
53
-
- If the menu shows **Alerting**, unified alerting is enabled. Alerting will remain unchanged by the upgrade.
43
+
- If the menu shows **Alerting**, unified alerting is enabled. Alerting will remain unchanged by the upgrade.
44
+
45
+
:::image type="content" source="media/grafana-10-upgrade/unified-alerting.png" alt-text="Screenshot of the Grafana interface showing the unified alerting menu.":::
54
46
55
47
## Upgrade to Grafana 10
56
48
57
-
Now let’s upgrade an Azure Managed Grafana instance running Grafana 9.
49
+
Now let’s upgrade an Azure Managed Grafana instance running Grafana 9.
58
50
59
51
> [!CAUTION]
60
-
> Upgrading to Grafana 10 is irreversible.
61
-
62
-
> [!CAUTION]
63
-
> Updating to Grafana 10 will generate a few minutes of downtime.
52
+
> Upgrading to Grafana 10 is irreversible.
64
53
65
54
1. In the Azure portal, open your Azure Managed Grafana workspace and in the left menu, under **Settings**, select **Configuration**.
66
55
1. Under **Grafana Version (Preview)**, select **10** to indicate that you want to upgrade your workspace to Grafana 10.
67
56
1. The Azure portal displays a warning message. Read the message carefully and check the box to acknowledge that you're aware of the risks.
68
57
1. Select **Save** on top to save the new settings and trigger the upgrade to Grafana version 10.
69
58
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**.
70
-
59
+
71
60
## Check Grafana alerts
72
61
73
62
If your workspace previously had legacy alerting enabled, check that your alerts are still working propertly within your upgraded instance of Grafana.
74
63
75
64
1. Open the Grafana portal.
76
65
1. Open the left menu. The alerting feature is now called **Alerting**. Open this menu and check the state of your alerts to make sure that they're set up the way you want.
77
66
78
-
:::image type="content" source="media/grafana-10-upgrade/unified-alerting.png" alt-text="Screenshot of the Grafana interface showing the unified alerting menu.":::
79
-
80
-
81
-
82
67
## Next step
83
68
84
69
In this how-to guide, you learned how to upgrade your Azure Managed Grafana workspace from Grafana 9 to Grafana 10. If needed, go to the following guide for support.
0 commit comments