Merge branch '2025.9' of https://github.com/CortexIntelligentAutomation/docs into 2025.9

Author: Donna-Marie Smith

content/en/blog/releases/2025.X/2025.7.md

@@ -39,7 +39,13 @@ The [Performance][] of the {{% ctx %}} Platform has been improved by:
 * [optimising stopping multiple running executions][Performance - Improved performance of stopping multiple running executions].
 * [optimising the monitoring execution updates][Performance - Improved performance of monitoring execution updates].
 
-[Observability][] has been updated to use [Grafana Alloy instead of Promtail for ingesting logs to Grafana Loki][Observability - Migrated from Promtail to Grafana Alloy].
+[Observability][] has been updated to:
+
+* use [Grafana Alloy instead of Promtail for ingesting logs to Grafana Loki][Observability - Migrated from Promtail to Grafana Alloy].
+* update the following [components within the Observability platform][Observability Upgrades] to the latest versions:
+
+  * Grafana - 12.1.1
+  * Grafana Loki - 3.5.5
 
 Finally, the [Documentation][] includes updates related to:
 
@@ -229,17 +235,29 @@ Affected Components:
 
 ##### Migrated from Promtail to Grafana Alloy
 
-`{{% ctx %}} Observability` has been updated to use [Grafana Alloy][] instead of [Promtail][] for ingesting logs to [Grafana Loki][]. This is due to [Promtail][] having been deprecated and marked as end-of-life on the 2nd of March 2026.
+{{% ctx %}} Observability has been updated to use [Grafana Alloy][] instead of [Promtail][] for ingesting logs to [Grafana Loki][]. This is due to [Promtail][] having been deprecated and marked as end-of-life on the 2nd of March 2026.
 
 {{% alert title="Note" %}}
-There is currently not documentation on how to migrate from `Promptail` to `Grafana Alloy`. This will be added in `2025.9`.
+There is currently no documentation on how to migrate from `Promtail` to `Grafana Alloy`. This will be added in `2025.9`.
 In the meantime, for further assistance, please raise a case in the {{< ahref path="Cortex.ServicePortal.MainDoc" version="2025.7" title="{{% ctx %}} Service Portal" >}}.
 {{% /alert %}}
 
 Affected Components:
 
 * {{% ctx %}} Observability
 
+##### Observability Upgrades
+
+Grafana and Grafana Loki have been updated to the latest versions, all related documentation and screenshots have been updated to reflect these changes.
+
+* Grafana - 12.1.1
+* Grafana Loki - 3.5.5
+
+Affected Components:
+
+* Grafana
+* Grafana Loki
+
 #### Documentation
 
 ##### Added new User Guide
@@ -337,7 +355,7 @@ Known limitations have been added within the 2025.7 release of the {{% ctx %}} P
 
 | Release | Grafana Version          | Grafana Loki Version | {{% ctx %}} Observability Version         |
 |---------|--------------------------|----------------------|-------------------------------------------|
-| 2025.7  | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0]  | [4.0.0][Observability 4.0.0]              |
+| 2025.7  | [12.1.1][Grafana 12.1.1] | [3.5.5][Loki 3.5.5]  | [4.0.0][Observability 4.0.0]              |
 | 2025.3  | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0]  | [3.0.0][Observability 3.0.0] (deprecated) |
 | 2025.1  | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0]  | [3.0.0][Observability 3.0.0] (deprecated) |
 | 2024.11 | [10.4.1][Grafana 10.4.1] | [3.0.0][Loki 3.0.0]  | [3.0.0][Observability 3.0.0] (deprecated) |
@@ -419,7 +437,7 @@ Releases are currently forecast to be made available on:
 
 [Observability]: {{< ref "#observability" >}}
 [Observability - Migrated from Promtail to Grafana Alloy]: {{< ref "#migrated-from-promtail-to-grafana-alloy" >}}
-
+[Observability Upgrades]: {{< ref "#observability-upgrades" >}}
 [Documentation]: {{< ref "#documentation" >}}
 [Documentation - Added new User Guide]: {{< ref "#added-new-user-guide" >}}
 [Documentation - Added new Tutorial]: {{< ref "#added-new-tutorial" >}}
@@ -456,7 +474,9 @@ Releases are currently forecast to be made available on:
 [Grafana Loki]: {{< url path="Grafana.Products.Loki.MainDoc" >}}
 [Grafana 8.5.4]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.Windows" >}}
 [Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}}
+[Grafana 12.1.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.12.1.1.Windows" >}}
 [Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.Release" >}}
+[Loki 3.5.5]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.5.5.Release" >}}
 [Loki 2.5.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.Release" >}}
 [Observability 4.0.0]: {{< url path="GitHub.Cortex.Observability.4.0.0.Release" >}}
 [Observability 3.0.0]: {{< url path="GitHub.Cortex.Observability.3.0.0.Release" >}}

content/en/docs/2025.7/Guides/upgrade-guides/upgrade-observability/cloud/grafana/upgrade-promtail.md

@@ -17,7 +17,7 @@ These steps will need to be performed on all application servers that host a Pro
 
 1. Log in to the application server.
 1. Run Windows PowerShell as Administrator.
-1. Change the directory to the folder where Promtail is running from, e.g. `cd C:\Program Data\Cortex\Observability\Promtail`.
+1. Change the directory to the folder where Promtail is running from, e.g. `cd C:\ProgramData\Cortex\Observability\Promtail`.
 1. Remove the current Promtail installation by executing the following command:
 
     ``` powershell
@@ -26,7 +26,7 @@ These steps will need to be performed on all application servers that host a Pro
 
 1. Click *Yes* when prompted for confirmation that you wish to remove the service.
 1. Click *OK* when the successful removal of the Promtail service is confirmed.
-1. Open a File Explorer and navigate to the folder where Promtail was running from, e.g. `C:\Program Data\Cortex\Observability\Promtail`
+1. Open a File Explorer and navigate to the folder where Promtail was running from, e.g. `C:\ProgramData\Cortex\Observability\Promtail`
 1. Delete the following files from the directory:
 
     * Install-Promtail.ps1
@@ -38,17 +38,17 @@ These steps will need to be performed on all application servers that host a Pro
     * Stop-Promtail.ps1
 
 1. In File Explorer, navigate to the extracted `promtail-windows-amd64.exe` folder created as part of [Make Artefacts Available][].
-1. Copy the `promtail-windows-amd64.exe` file into the folder that Promtail was previously running from, e.g. `C:\Program Data\Cortex\Observability\Promtail`.
+1. Copy the `promtail-windows-amd64.exe` file into the folder that Promtail was previously running from, e.g. `C:\ProgramData\Cortex\Observability\Promtail`.
 1. In File Explorer, navigate to the extracted `Promtail.Install` folder created as part of [Make Artefacts Available][].
-1. Copy the contents of this location into the folder that Promtail was previously running from, e.g. `C:\Program Data\Cortex\Observability\Promtail`.
+1. Copy the contents of this location into the folder that Promtail was previously running from, e.g. `C:\ProgramData\Cortex\Observability\Promtail`.
 1. Open `promtail-local-config.yaml` in a text editor:
 
     * Update the *filename* property under *positions* to be the value found in the [backed up][] version.
     * Update the *url* property under *clients* to be the value found in the [backed up][] version.
     * Save the new `promtail-local-config.yaml` file.
 
 1. Run Windows PowerShell as Administrator.
-1. Change the directory to the folder where the Promtail files have been copied to, e.g. `cd C:\Program Data\Cortex\Observability\Promtail`.
+1. Change the directory to the folder where the Promtail files have been copied to, e.g. `cd C:\ProgramData\Cortex\Observability\Promtail`.
 1. Install Promtail by executing the following command:
 
     ``` powershell

content/en/docs/2025.7/Guides/upgrade-guides/upgrade-observability/on-premise/grafana/upgrade-loki.md

@@ -13,7 +13,7 @@ This guide describes how to upgrade the Loki installation. Please ensure that th
 
 1. Log in to the server hosting your Loki service.
 1. Run Windows PowerShell as Administrator.
-1. Change the directory to the folder where Loki is running from, e.g. `cd C:\Program Data\Cortex\Observability\Loki`.
+1. Change the directory to the folder where Loki is running from, e.g. `cd C:\ProgramData\Cortex\Observability\Loki`.
 1. Remove the current Loki installation by executing the following command:
 
     ``` powershell
@@ -22,7 +22,7 @@ This guide describes how to upgrade the Loki installation. Please ensure that th
 
 1. Click *Yes* when prompted for confirmation that you wish to remove the service.
 1. Click *OK* when the successful removal of the Loki service is confirmed.
-1. Open a File Explorer and navigate to the folder where Loki was running from, e.g. `C:\Program Data\Cortex\Observability\Loki`.
+1. Open a File Explorer and navigate to the folder where Loki was running from, e.g. `C:\ProgramData\Cortex\Observability\Loki`.
 1. Delete the following files from the directory:
 
     * Install-Loki.ps1
@@ -34,9 +34,9 @@ This guide describes how to upgrade the Loki installation. Please ensure that th
     * Stop-Loki.ps1
 
 1. In File Explorer, navigate to the extracted `loki-windows-amd64.exe` folder created as part of [Make Artefacts Available][].
-1. Copy the `loki-windows-amd64.exe` file into the folder that Loki was previously running from, e.g. `C:\Program Data\Cortex\Observability\Loki`.
+1. Copy the `loki-windows-amd64.exe` file into the folder that Loki was previously running from, e.g. `C:\ProgramData\Cortex\Observability\Loki`.
 1. In File Explorer, navigate to the extracted `Grafana.Loki.Install` folder created as part of [Make Artefacts Available][].
-1. Copy the contents of this location into the folder that Loki was previously running from, e.g. `C:\Program Data\Cortex\Observability\Loki`.
+1. Copy the contents of this location into the folder that Loki was previously running from, e.g. `C:\ProgramData\Cortex\Observability\Loki`.
 1. Open the new `loki-local-config.yaml` file in a text editor and compare against the [backed up][] version.  If there are differences between the two files in the *schema_config* > *configs* section:
 
     1. In the new file, change the date next to `- from` to be today's date.
@@ -66,7 +66,7 @@ This guide describes how to upgrade the Loki installation. Please ensure that th
     1. Save the new `loki-local-config.yaml` file.
 
 1. Run Windows PowerShell as Administrator.
-1. Change the directory to the folder where the Loki files have been copied to, e.g. `cd C:\Program Data\Cortex\Observability\Loki`.
+1. Change the directory to the folder where the Loki files have been copied to, e.g. `cd C:\ProgramData\Cortex\Observability\Loki`.
 1. Install Loki by executing the following command:
 
     ``` powershell

content/en/docs/2025.7/Guides/upgrade-guides/upgrade-observability/on-premise/grafana/upgrade-promtail.md

@@ -17,7 +17,7 @@ These steps will need to be performed on all application servers that host a Pro
 
 1. Log in to the application server.
 1. Run Windows PowerShell as Administrator.
-1. Change the directory to the folder where Promtail is running from, e.g. `cd C:\Program Data\Cortex\Observability\Promtail`.
+1. Change the directory to the folder where Promtail is running from, e.g. `cd C:\ProgramData\Cortex\Observability\Promtail`.
 1. Remove the current Promtail installation by executing the following command:
 
     ``` powershell
@@ -26,7 +26,7 @@ These steps will need to be performed on all application servers that host a Pro
 
 1. Click *Yes* when prompted for confirmation that you wish to remove the service.
 1. Click *OK* when the successful removal of the Promtail service is confirmed.
-1. Open a File Explorer and navigate to the folder where Promtail was running from, e.g. `C:\Program Data\Cortex\Observability\Promtail`
+1. Open a File Explorer and navigate to the folder where Promtail was running from, e.g. `C:\ProgramData\Cortex\Observability\Promtail`
 1. Delete the following files from the directory:
 
     * Install-Promtail.ps1
@@ -38,17 +38,17 @@ These steps will need to be performed on all application servers that host a Pro
     * Stop-Promtail.ps1
 
 1. In File Explorer, navigate to the extracted `promtail-windows-amd64.exe` folder created as part of [Make Artefacts Available][].
-1. Copy the `promtail-windows-amd64.exe` file into the folder that Promtail was previously running from, e.g. `C:\Program Data\Cortex\Observability\Promtail`.
+1. Copy the `promtail-windows-amd64.exe` file into the folder that Promtail was previously running from, e.g. `C:\ProgramData\Cortex\Observability\Promtail`.
 1. In File Explorer, navigate to the extracted `Promtail.Install` folder created as part of [Make Artefacts Available][].
-1. Copy the contents of this location into the folder that Promtail was previously running from, e.g. `C:\Program Data\Cortex\Observability\Promtail`.
+1. Copy the contents of this location into the folder that Promtail was previously running from, e.g. `C:\ProgramData\Cortex\Observability\Promtail`.
 1. Open the new `promtail-local-config.yaml` in a text editor:
 
     * Update the *filename* property under *positions* to be the value found in the [backed up][] version.
     * Update the *url* property under *clients* to be the value found in the [backed up][] version.
     * Save the new `promtail-local-config.yaml` file.
 
 1. Run Windows PowerShell as Administrator.
-1. Change the directory to the folder where the Promtail files have been copied to, e.g. `cd C:\Program Data\Cortex\Observability\Promtail`.
+1. Change the directory to the folder where the Promtail files have been copied to, e.g. `cd C:\ProgramData\Cortex\Observability\Promtail`.
 1. Install Promtail by executing the following command:
 
     ``` powershell

content/en/docs/2025.7/Whats New/_index.md

@@ -35,7 +35,11 @@ The performance of the {{% ctx %}} Platform has been improved by:
 
 ## Improved Observability
 
-Observability has been updated to use [Grafana Alloy instead of Promtail for ingesting logs to Grafana Loki][Observability - Migrated from Promtail to Grafana Alloy].
+* Observability has been updated to use [Grafana Alloy instead of Promtail for ingesting logs to Grafana Loki][Observability - Migrated from Promtail to Grafana Alloy].
+
+* The following [components within the Observability platform have been updated][Observability Upgrades] to the latest major versions:
+  * Grafana - 12.1.1
+  * Grafana Loki - 3.5.5
 
 ## Improved Documentation
 
@@ -66,6 +70,7 @@ For a full list of what has been introduced in this release, please see the [202
 [Performance - Improved performance of stopping multiple running executions]: {{< url path="Cortex.Blogs.Releases.2025.7.ImprovedPerformanceOfStoppingMultipleRunningExecutions" version="2025.7" >}}
 [Performance - Improved performance of monitoring execution updates]: {{< url path="Cortex.Blogs.Releases.2025.7.ImprovedPerformanceOfMonitoringExecutionUpdates" version="2025.7" >}}
 [Observability - Migrated from Promtail to Grafana Alloy]: {{< url path="Cortex.Blogs.Releases.2025.7.MigratedFromPromtailToGrafanaAlloy" version="2025.7" >}}
+[Observability Upgrades]: {{< url path="Cortex.Blogs.Releases.2025.7.ObservabilityUpgrades" version="2025.7" >}}
 [Documentation - Added new User Guide]: {{< url path="Cortex.Blogs.Releases.2025.7.AddedNewUserGuide" version="2025.7" >}}
 [Documentation - Added new Tutorial]: {{< url path="Cortex.Blogs.Releases.2025.7.AddedNewTutorial" version="2025.7" >}}
 [Documentation - Updated documentation to point to Flow Editor User Guide]: {{< url path="Cortex.Blogs.Releases.2025.7.UpdatedDocumentationToPointToFlowEditorUserGuide" version="2025.7" >}}

content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md

@@ -11,12 +11,12 @@ This guide describes how to install Grafana Alloy on the Application Server(s).
 
 ## Install Grafana Alloy
 
-1. Download the [Grafana Alloy 1.10.0][] archive.
-1. Extract content of the downloaded archive to a suitable location, e.g. `C:\Program Data\Cortex\Observability\Grafana Alloy`.
+1. Download the [Grafana Alloy 1.10.2][] archive.
+1. Extract content of the downloaded archive to a suitable location, e.g. `C:\ProgramData\Cortex\Observability\Grafana Alloy`.
 1. Download the [Grafana Alloy.zip][] archive and extract its contents alongside the previously extracted Grafana Alloy `alloy-installer-windows-amd64.exe`.
 This archive contains the `config.alloy` configuration file and PowerShell scripts to install Grafana Alloy as a Windows service.
 1. Run Windows PowerShell as Administrator
-1. Change the location to where all the files were extracted to in step 2, e.g. `cd "C:\Program Data\Cortex\Observability\Grafana Alloy"`.
+1. Change the location to where all the files were extracted to in step 2, e.g. `cd "C:\ProgramData\Cortex\Observability\Grafana Alloy"`.
 1. Execute the `.\Install-Alloy.ps1` command to install the downloaded `alloy-installer-windows-amd64.exe` as a service.
 1. When prompted, enter the credentials that the Grafana Alloy Service should run as.
 1. When prompted to enter the bearer token, leave it blank and press Enter.
@@ -26,6 +26,6 @@ This archive contains the `config.alloy` configuration file and PowerShell scrip
 1. [Configure Grafana Alloy][]
 
 [Configure Grafana Alloy]: {{< url path="Cortex.GettingStarted.Cloud.AddObservabilityToInnovation.Grafana.InstallAlloy.ConfigureAlloy.MainDoc" >}}
-[Grafana Alloy 1.10.0]:  {{< url path="Grafana.Products.Loki.Alloy.1.10.0" >}}
+[Grafana Alloy 1.10.2]:  {{< url path="Grafana.Products.Loki.Alloy.1.10.2" >}}
 [Grafana Alloy.zip]: {{< url path="GitHub.Cortex.Observability.4.0.0.GrafanaAlloyInstallZip" >}}
 [Prerequisites]: {{< url path="Cortex.GettingStarted.OnPremise.AddObservabilityToInnovation.Grafana.Prerequisites" >}}

content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/prerequisites.md

@@ -21,7 +21,7 @@ The application servers must have internet access in order to communicate with t
 
 | Server Role        | Windows Server[^1]                             | Other Software     |
 |--------------------|------------------------------------------------|--------------------|
-| Application Server | [2022 (x64)][] *Recommended*<br>[2019 (x64)][] | [Grafana Alloy 1.10.0][] |
+| Application Server | [2022 (x64)][] *Recommended*<br>[2019 (x64)][] | [Grafana Alloy 1.10.2][] |
 
 [^1]: Windows Server Standard and Datacenter editions are supported. Filesystem **must be NTFS** and networking **must use IPv4**. Linux is not supported, but may be in the future.
 
@@ -59,5 +59,5 @@ Grafana Alloy requires a domain user that is not a member of the Local Administr
 [2019 (x64)]: {{< url path="Microsoft.Downloads.Windows.Server2019" >}}
 [2022 (x64)]: {{< url path="Microsoft.Downloads.Windows.Server2022" >}}
 [Architecture]: {{< url path="Cortex.GettingStarted.Cloud.AddObservabilityToInnovation.Grafana.Architecture.MainDoc" >}}
-[Grafana Alloy 1.10.0]:  {{< url path="Grafana.Products.Loki.Alloy.1.10.0" >}}
+[Grafana Alloy 1.10.2]:  {{< url path="Grafana.Products.Loki.Alloy.1.10.2" >}}
 [Set up Grafana]: {{< url path="Cortex.GettingStarted.Cloud.AddObservabilityToInnovation.Grafana.SetupGrafana.MainDoc" >}}