renamed upgrade guide for correct version and also added initial instructions for adding new dashboard

Author: Donna-Marie Smith

content/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.0-to-5.0.0/_index.md

@@ -0,0 +1,6 @@
+---
+title: "4.2.1 to 5.0.0"
+linkTitle: "4.2.1 to 5.0.0"
+description: "Instructions to upgrade your observability platform for {{% ctx %}} from 4.2.1 to 5.0.0."
+weight: 960
+---

content/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.1-to-5.0.0/_index.md

@@ -12,8 +12,10 @@ weight: 1
 1. Download the required artefacts to a folder on your machine:
 
     * [Grafana Alloy 1.15.1][] archive.
+    * [Grafana.Dashboards.zip][] archive.
 
 1. Extract the downloaded `alloy-installer-windows-amd64.exe` archive to a folder with the same name.
+1. Extract the downloaded `Grafana.Dashboards` archive to a folder with the same name.
 
 ## Backup Old Files
 
@@ -28,4 +30,5 @@ On each Application Server that Grafana Alloy is installed on:
 1. [Upgrade Grafana Alloy][Upgrade Alloy]
 
 [Grafana Alloy 1.15.1]:  {{< url path="Grafana.SelfManaged.Downloads.GrafanaAlloy.1_15_1.Windows" >}}
-[Upgrade Alloy]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.4_2_0to5_0_0.Cloud.Grafana.UpgradeAlloy" >}}
+[Upgrade Alloy]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.4_2_1to5_0_0.Cloud.Grafana.UpgradeAlloy" >}}
+[Grafana.Dashboards.zip]: {{< url path="GitHub.Cortex.Observability.4_2_1.GrafanaDashboardsZip" >}}

…rvability/4.2.0-to-5.0.0/cloud/_index.md …rvability/4.2.1-to-5.0.0/cloud/_index.mdcontent/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.0-to-5.0.0/cloud/_index.md renamed to content/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.1-to-5.0.0/cloud/_index.md content/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.0-to-5.0.0/cloud/_index.md renamed to content/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.1-to-5.0.0/cloud/_index.md

@@ -2,7 +2,7 @@
 title: "Try it out"
 linkTitle: "Try it out"
 description: "Information about trying out the observability platform after upgrade."
-weight: 3
+weight: 4
 ---
 
 # {{% param title %}}

…y/4.2.0-to-5.0.0/cloud/grafana/_index.md …y/4.2.1-to-5.0.0/cloud/grafana/_index.mdcontent/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.0-to-5.0.0/cloud/grafana/_index.md renamed to content/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.1-to-5.0.0/cloud/grafana/_index.md content/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.0-to-5.0.0/cloud/grafana/_index.md renamed to content/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.1-to-5.0.0/cloud/grafana/_index.md

@@ -36,7 +36,7 @@ These steps will need to be performed on all application servers that host a Gra
 
 ## Next Steps?
 
-1. [Try it out][]
+1. [Upgrade Dashboards][]
 
-[Make Artefacts Available]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.4_2_0to5_0_0.Cloud.Grafana.MakeArtefactsAvailable" >}}
-[Try it out]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.4_2_0to5_0_0.Cloud.Grafana.TryItOut" >}}
+[Make Artefacts Available]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.4_2_1to5_0_0.Cloud.Grafana.MakeArtefactsAvailable" >}}
+[Upgrade Dashboards]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.4_2_1to5_0_0.Cloud.Grafana.UpgradeDashboards" >}}

…-to-5.0.0/cloud/grafana/prerequisites.md …-to-5.0.0/cloud/grafana/prerequisites.mdcontent/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.0-to-5.0.0/cloud/grafana/prerequisites.md renamed to content/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.1-to-5.0.0/cloud/grafana/prerequisites.md content/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.0-to-5.0.0/cloud/grafana/prerequisites.md renamed to content/en/docs/2026.3/Guides/upgrade-guides/upgrade-observability/4.2.1-to-5.0.0/cloud/grafana/prerequisites.md

@@ -0,0 +1,33 @@
+---
+title: "Upgrade Dashboards"
+linkTitle: "Upgrade Dashboards"
+description: "Information about upgrading your Grafana dashboards."
+weight: 3
+---
+
+# {{% param title %}}
+
+This guide describes how to upgrade the default dashboards that are provided for your observability platform.
+
+{{% alert title="Warning" color="warning" %}}
+This new dashboard will only work if `Flow Logging` is enabled on your platform.
+{{% / alert %}}
+
+## Import New Dashboard
+
+1. Log in to your configured Grafana with a user that has the *Admin* role.
+1. Go to *Dashboards* via the menu on the left sidebar.
+1. Click the *New* button and select *Import* from the drop-down menu.
+1. Click the *Upload JSON file* button.
+1. Locate the extracted `Flow Execution Details.json` file downloaded as part of [Make Artefacts Available][].
+1. Select the file and click *Open*.
+1. Select the folder in Grafana you wish the dashboard to be saved in, e.g. *Cortex*.
+1. Select your configured Loki data source from the dropdown menu.
+1. Click *Import*.
+
+## Next Steps?
+
+1. [Try it out][]
+
+[Make Artefacts Available]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.4_2_1to5_0_0.Cloud.Grafana.MakeArtefactsAvailable" >}}
+[Try it out]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.4_2_1to5_0_0.Cloud.Grafana.TryItOut" >}}