From 086bc076128134b4b30d5f236c03a9709a196113 Mon Sep 17 00:00:00 2001 From: Donna-Marie Smith Date: Mon, 15 Sep 2025 14:40:37 +0100 Subject: [PATCH 1/5] Modified supported component versions for 2024.7 release --- content/en/blog/releases/2025.X/2025.7.md | 18 ++++++++++++++++-- content/en/docs/2025.7/Whats New/_index.md | 7 ++++++- .../Grafana/install-alloy/install-alloy.md | 4 ++-- .../Grafana/prerequisites.md | 4 ++-- .../Grafana/install-alloy/install-alloy.md | 4 ++-- .../Grafana/install-grafana/install-grafana.md | 4 ++-- .../Grafana/install-loki/install-loki.md | 4 ++-- .../Grafana/prerequisites.md | 10 +++++----- data/urls.toml | 8 +++++++- 9 files changed, 44 insertions(+), 19 deletions(-) diff --git a/content/en/blog/releases/2025.X/2025.7.md b/content/en/blog/releases/2025.X/2025.7.md index 11a293545..45e97ac21 100644 --- a/content/en/blog/releases/2025.X/2025.7.md +++ b/content/en/blog/releases/2025.X/2025.7.md @@ -232,7 +232,7 @@ Affected Components: `{{% 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 not 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 %}} @@ -240,6 +240,18 @@ Affected Components: * {{% ctx %}} Observability +##### Observability Upgrades + +Grafana and Loki have been updated to the latest major versions, all related documentation and screenshots has been updated to reflect these changes. + +* Grafana - 12.1.1 +* Loki - 3.5.5 + +Affected Components: + +* Grafana +* Loki + #### Documentation ##### Added new User Guide @@ -337,7 +349,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) | @@ -456,7 +468,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" >}} diff --git a/content/en/docs/2025.7/Whats New/_index.md b/content/en/docs/2025.7/Whats New/_index.md index 3f8ea5876..0c716472d 100644 --- a/content/en/docs/2025.7/Whats New/_index.md +++ b/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 + * 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" >}} diff --git a/content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md b/content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md index edd3cfed4..84aa1b6ed 100644 --- a/content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md +++ b/content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md @@ -11,7 +11,7 @@ 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. Download the [Grafana Alloy 1.10.2][] 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.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. @@ -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" >}} diff --git a/content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/prerequisites.md b/content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/prerequisites.md index d6cc2bb0e..2641c225a 100644 --- a/content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/prerequisites.md +++ b/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*
[2019 (x64)][] | [Grafana Alloy 1.10.0][] | +| Application Server | [2022 (x64)][] *Recommended*
[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" >}} diff --git a/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md b/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md index d81d8bfe1..4d5e163a8 100644 --- a/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md +++ b/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md @@ -11,7 +11,7 @@ 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. Download the [Grafana Alloy 1.10.2][] 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.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. @@ -26,7 +26,7 @@ This archive contains the `config.alloy` configuration file and PowerShell scrip 1. [Configure Grafana Alloy][] [Configure Grafana Alloy]: {{< url path="Cortex.GettingStarted.OnPremise.AddObservabilityToInnovation.Grafana.InstallAlloy.ConfigureAlloy" >}} -[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" >}} [Reverse Proxy Authentication]: {{< url path="Cortex.GettingStarted.OnPremise.AddObservabilityToInnovation.Grafana.InstallLoki.ConfigureAuthentication" >}} diff --git a/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-grafana/install-grafana.md b/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-grafana/install-grafana.md index ab29b8dac..0a939bf44 100644 --- a/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-grafana/install-grafana.md +++ b/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-grafana/install-grafana.md @@ -11,7 +11,7 @@ This guide describes how to install Grafana on the Web Application Server. Pleas ## Install Grafana -1. Download the [Grafana 10.4.1][] Windows installer. +1. Download the [Grafana 12.1.1][] Windows installer. 1. Run the installer and install Grafana to a suitable location. ## Next Steps? @@ -19,6 +19,6 @@ This guide describes how to install Grafana on the Web Application Server. Pleas 1. [Configure Grafana][] [Configure Grafana]: {{< url path="Cortex.GettingStarted.OnPremise.AddObservabilityToInnovation.Grafana.InstallGrafana.ConfigureGrafana" >}} -[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" >}} [Prerequisites]: {{< url path="Cortex.GettingStarted.OnPremise.AddObservabilityToInnovation.Grafana.Prerequisites" >}} [Software Requirements]: {{< url path="Cortex.GettingStarted.OnPremise.AddObservabilityToInnovation.Grafana.SoftwareRequirements" >}} diff --git a/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-loki/install-loki.md b/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-loki/install-loki.md index 8fdc0ac57..65873f45a 100644 --- a/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-loki/install-loki.md +++ b/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-loki/install-loki.md @@ -11,7 +11,7 @@ This guide describes how to install Grafana Loki on the Web Application Server. ## Install Grafana Loki -1. Download [Grafana Loki 3.0.0][] archive. +1. Download [Grafana Loki 3.5.5][] archive. 1. Extract content of the downloaded archive to a suitable location, e.g. `C:\Program Data\Cortex\Observability\Loki`. 1. Download the [Grafana Loki Install.zip][] archive and extract its contents alongside the previously extracted Grafana Loki `loki-windows-amd64.exe`. This archive contains the `loki-local-config.yaml` configuration file, [NSSM][] (the Non-Sucking Service Manager program) and PowerShell scripts to help manage Grafana Loki as a Windows service. @@ -25,7 +25,7 @@ This archive contains the `loki-local-config.yaml` configuration file, [NSSM][] 1. [Configure Loki][] [Configure Loki]: {{< url path="Cortex.GettingStarted.OnPremise.AddObservabilityToInnovation.Grafana.InstallLoki.ConfigureLoki" >}} -[Grafana Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} +[Grafana Loki 3.5.5]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.5.5.GrafanaLokiInstallZip" >}} [Grafana Loki Install.zip]: {{< url path="GitHub.Cortex.Observability.4.0.0.GrafanaLokiInstallZip" >}} [NSSM]: {{< url path="NSSM.MainDoc" >}} [Prerequisites]: {{< url path="Cortex.GettingStarted.OnPremise.AddObservabilityToInnovation.Grafana.Prerequisites" >}} diff --git a/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/prerequisites.md b/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/prerequisites.md index b3b768492..b008a4de8 100644 --- a/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/prerequisites.md +++ b/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/prerequisites.md @@ -40,8 +40,8 @@ The application servers (as described in {{< ahref path="Cortex.GettingStarted.O | Server Role | Windows Server[^1] | IIS[^2] | Other Software | |------------------|-------------------------|---------|----------| -| Web Application Server | [2022 (x64)][] *Recommended*
[2019 (x64)][] | 10.0.20348[^3]
10.0.17763[^4]
[URL Rewrite module 2.1][] | [Grafana 10.4.1][] *Enterprise Edition*
[Grafana Loki 3.0.0][]| -| Application Server | [2022 (x64)][] *Recommended*
[2019 (x64)][] | | [Grafana Alloy 1.10.0][]| +| Web Application Server | [2022 (x64)][] *Recommended*
[2019 (x64)][] | 10.0.20348[^3]
10.0.17763[^4]
[URL Rewrite module 2.1][] | [Grafana 12.1.1][] *Enterprise Edition*
[Grafana Loki 3.5.5][]| +| Application Server | [2022 (x64)][] *Recommended*
[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. [^2]: IIS is supported; other web servers, including IIS Express are not supported. @@ -161,9 +161,9 @@ Grafana Alloy requires a domain user that is not a member of the Local Administr [configuring Grafana to use HTTPS]: {{< url path="Cortex.GettingStarted.OnPremise.AddObservabilityToInnovation.Grafana.InstallGrafana.ConfigureHTTPS" >}} [Create Self-Signed Certificates]: {{< url path="Cortex.GettingStarted.OnPremise.AddObservabilityToInnovation.Grafana.Advanced.CreateSelfSignedCertificates" >}} [Make Installation Artefacts Available]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.MultipleServerWithHA.MakeInstallationArtefactsAvailableNew" >}} -[Grafana 10.4.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1.Windows" >}} -[Grafana Alloy 1.10.0]: {{< url path="Grafana.Products.Loki.Alloy.1.10.0" >}} -[Grafana Loki 3.0.0]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0.GrafanaLokiInstallZip" >}} +[Grafana 12.1.1]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaWebApp.12.1.1.Windows" >}} +[Grafana Alloy 1.10.2]: {{< url path="Grafana.Products.Loki.Alloy.1.10.2" >}} +[Grafana Loki 3.5.5]: {{< url path="Grafana.SelfManaged.Downloads.GrafanaLoki.3.5.5.GrafanaLokiInstallZip" >}} [Install Grafana]: {{< url path="Cortex.GettingStarted.OnPremise.AddObservabilityToInnovation.Grafana.InstallGrafana.MainDoc" >}} [installation]: {{< url path="Cortex.GettingStarted.OnPremise.AddObservabilityToInnovation.Grafana.InstallLoki.InstallCertificate" >}} [Let’s Encrypt]: {{< url path="LetsEncrypt.MainDoc" >}} diff --git a/data/urls.toml b/data/urls.toml index 3461c5823..19d54d93a 100644 --- a/data/urls.toml +++ b/data/urls.toml @@ -62,6 +62,7 @@ ImprovedPerformanceOfStoppingMultipleRunningExecutions = "/blog/2025/08/26/2025.7/#improved-performance-of-stopping-multiple-running-executions" ImprovedPerformanceOfMonitoringExecutionUpdates = "/blog/2025/08/26/2025.7/#improved-performance-of-monitoring-execution-updates" MigratedFromPromtailToGrafanaAlloy = "/blog/2025/08/26/2025.7/#migrated-from-promtail-to-grafana-alloy" + ObservabilityUpgrades = "/blog/2025/08/26/2025.7/#observability-upgrades" AddedNewUserGuide = "/blog/2025/08/26/2025.7/#added-new-user-guide" AddedNewTutorial = "/blog/2025/08/26/2025.7/#added-new-tutorial" UpdatedDocumentationToPointToFlowEditorUserGuide = "/blog/2025/08/26/2025.7/#updated-documentation-to-point-to-flow-editor-user-guide" @@ -3151,19 +3152,24 @@ MainDoc = "https://grafana.com/docs/loki/latest/clients/promtail/" [Grafana.Products.Loki.Alloy] MainDoc = "https://grafana.com/docs/loki/latest/send-data/alloy/" - 1.10.0 = "https://github.com/grafana/alloy/releases/download/v1.10.0/alloy-installer-windows-amd64.exe.zip" + 1.10.2 = "https://github.com/grafana/alloy/releases/download/v1.10.2/alloy-installer-windows-amd64.exe.zip" [Grafana.Products.GrafanaAlloy] MainDoc = "https://grafana.com/oss/alloy-opentelemetry-collector/" [Grafana.SelfManaged.Downloads.GrafanaWebApp] Windows = "https://grafana.com/grafana/download/8.5.4?pg=get&plcmt=selfmanaged-box1-cta1&platform=windows" [Grafana.SelfManaged.Downloads.GrafanaWebApp.10.4.1] Windows = "https://grafana.com/grafana/download/10.4.1?pg=get&plcmt=selfmanaged-box1-cta1&platform=windows" + [Grafana.SelfManaged.Downloads.GrafanaWebApp.12.1.1] + Windows = "https://grafana.com/grafana/download/12.1.1?pg=get&plcmt=selfmanaged-box1-cta1&platform=windows" [Grafana.SelfManaged.Downloads.GrafanaLoki] Release = "https://github.com/grafana/loki/releases/tag/v2.5.0" GrafanaLokiInstallZip = "https://github.com/grafana/loki/releases/download/v2.5.0/loki-windows-amd64.exe.zip" [Grafana.SelfManaged.Downloads.GrafanaLoki.3.0.0] Release = "https://github.com/grafana/loki/releases/tag/v3.0.0" GrafanaLokiInstallZip = "https://github.com/grafana/loki/releases/download/v3.0.0/loki-windows-amd64.exe.zip" + [Grafana.SelfManaged.Downloads.GrafanaLoki.3.5.5] + Release = "https://github.com/grafana/loki/releases/tag/v3.5.5" + GrafanaLokiInstallZip = "https://github.com/grafana/loki/releases/download/v3.5.5/loki-windows-amd64.exe.zip" [Grafana.SelfManaged.Downloads.Promtail] PromtailInstallZip = "https://github.com/grafana/loki/releases/download/v2.5.0/promtail-windows-amd64.exe.zip" [Grafana.SelfManaged.Downloads.Promtail.3.0.0] From 4bb8ba087b832480fa845ae1572801157b217cd1 Mon Sep 17 00:00:00 2001 From: Donna-Marie Smith Date: Tue, 16 Sep 2025 10:16:56 +0100 Subject: [PATCH 2/5] Modified typos --- content/en/blog/releases/2025.X/2025.7.md | 10 +++++----- content/en/docs/2025.7/Whats New/_index.md | 2 +- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/content/en/blog/releases/2025.X/2025.7.md b/content/en/blog/releases/2025.X/2025.7.md index 45e97ac21..ff05c6ab9 100644 --- a/content/en/blog/releases/2025.X/2025.7.md +++ b/content/en/blog/releases/2025.X/2025.7.md @@ -229,10 +229,10 @@ 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 `Promtail` 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 %}} @@ -242,15 +242,15 @@ Affected Components: ##### Observability Upgrades -Grafana and Loki have been updated to the latest major versions, all related documentation and screenshots has been updated to reflect these changes. +Grafana and Grafana Loki have been updated to the latest major versions, all related documentation and screenshots has been updated to reflect these changes. * Grafana - 12.1.1 -* Loki - 3.5.5 +* Grafana Loki - 3.5.5 Affected Components: * Grafana -* Loki +* Grafana Loki #### Documentation diff --git a/content/en/docs/2025.7/Whats New/_index.md b/content/en/docs/2025.7/Whats New/_index.md index 0c716472d..d25eb4968 100644 --- a/content/en/docs/2025.7/Whats New/_index.md +++ b/content/en/docs/2025.7/Whats New/_index.md @@ -39,7 +39,7 @@ The performance of the {{% ctx %}} Platform has been improved by: * The following [components within the Observability platform have been updated][Observability Upgrades] to the latest major versions: * Grafana - 12.1.1 - * Loki - 3.5.5 + * Grafana Loki - 3.5.5 ## Improved Documentation From f5a1848f4c93455e9d48bdbc462081f73d2a552d Mon Sep 17 00:00:00 2001 From: Donna-Marie Smith Date: Tue, 16 Sep 2025 10:28:32 +0100 Subject: [PATCH 3/5] modified Release Notes Overview to include new version changes --- content/en/blog/releases/2025.X/2025.7.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/content/en/blog/releases/2025.X/2025.7.md b/content/en/blog/releases/2025.X/2025.7.md index ff05c6ab9..ca72f8242 100644 --- a/content/en/blog/releases/2025.X/2025.7.md +++ b/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: @@ -242,7 +248,7 @@ Affected Components: ##### Observability Upgrades -Grafana and Grafana Loki have been updated to the latest major versions, all related documentation and screenshots has been updated to reflect these changes. +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 @@ -431,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" >}} From e77d1d2f1c9fe24123eda2c94ce34bbe7a38e37c Mon Sep 17 00:00:00 2001 From: Donna-Marie Smith Date: Wed, 17 Sep 2025 11:28:05 +0100 Subject: [PATCH 4/5] Modified Program Data path to be ProgramData --- .../Grafana/install-alloy/install-alloy.md | 4 ++-- .../Grafana/install-loki/install-loki.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md b/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md index 4d5e163a8..239dadeed 100644 --- a/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md +++ b/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md @@ -12,11 +12,11 @@ This guide describes how to install Grafana Alloy on the Application Server(s). ## Install 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:\Program Data\Cortex\Observability\Grafana Alloy`. +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, enter the bearer token that was specified when [configuring authentication for the Reverse Proxy][Reverse Proxy Authentication] diff --git a/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-loki/install-loki.md b/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-loki/install-loki.md index 65873f45a..9af9a08e0 100644 --- a/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-loki/install-loki.md +++ b/content/en/docs/2025.7/getting-started/on-premise/add-observability-to-innovation/Grafana/install-loki/install-loki.md @@ -12,11 +12,11 @@ This guide describes how to install Grafana Loki on the Web Application Server. ## Install Grafana Loki 1. Download [Grafana Loki 3.5.5][] archive. -1. Extract content of the downloaded archive to a suitable location, e.g. `C:\Program Data\Cortex\Observability\Loki`. +1. Extract content of the downloaded archive to a suitable location, e.g. `C:\ProgramData\Cortex\Observability\Loki`. 1. Download the [Grafana Loki Install.zip][] archive and extract its contents alongside the previously extracted Grafana Loki `loki-windows-amd64.exe`. This archive contains the `loki-local-config.yaml` configuration file, [NSSM][] (the Non-Sucking Service Manager program) and PowerShell scripts to help manage Grafana Loki 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\Loki"`. +1. Change the location to where all the files were extracted to in step 2, e.g. `cd "C:\ProgramData\Cortex\Observability\Loki"`. 1. Execute the `.\Install-Loki.ps1` command to install the downloaded Grafana Loki `loki-windows-amd64.exe` as a service. 1. Execute the `.\Start-Loki.ps1` command to start the Grafana Loki service. From 4cbed3755f57f06ef714d8ad3d146315d3f0bb4c Mon Sep 17 00:00:00 2001 From: Donna-Marie Smith Date: Wed, 17 Sep 2025 11:39:08 +0100 Subject: [PATCH 5/5] Fixed up paths from Program Data to ProgramData --- .../cloud/grafana/upgrade-promtail.md | 10 +++++----- .../on-premise/grafana/upgrade-loki.md | 10 +++++----- .../on-premise/grafana/upgrade-promtail.md | 10 +++++----- .../Grafana/install-alloy/install-alloy.md | 4 ++-- 4 files changed, 17 insertions(+), 17 deletions(-) diff --git a/content/en/docs/2025.7/Guides/upgrade-guides/upgrade-observability/cloud/grafana/upgrade-promtail.md b/content/en/docs/2025.7/Guides/upgrade-guides/upgrade-observability/cloud/grafana/upgrade-promtail.md index 5134badd9..a62dfb057 100644 --- a/content/en/docs/2025.7/Guides/upgrade-guides/upgrade-observability/cloud/grafana/upgrade-promtail.md +++ b/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,9 +38,9 @@ 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. @@ -48,7 +48,7 @@ These steps will need to be performed on all application servers that host a Pro * 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 diff --git a/content/en/docs/2025.7/Guides/upgrade-guides/upgrade-observability/on-premise/grafana/upgrade-loki.md b/content/en/docs/2025.7/Guides/upgrade-guides/upgrade-observability/on-premise/grafana/upgrade-loki.md index 2596b9b69..42b6a7187 100644 --- a/content/en/docs/2025.7/Guides/upgrade-guides/upgrade-observability/on-premise/grafana/upgrade-loki.md +++ b/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 diff --git a/content/en/docs/2025.7/Guides/upgrade-guides/upgrade-observability/on-premise/grafana/upgrade-promtail.md b/content/en/docs/2025.7/Guides/upgrade-guides/upgrade-observability/on-premise/grafana/upgrade-promtail.md index 014a7b960..78f25e918 100644 --- a/content/en/docs/2025.7/Guides/upgrade-guides/upgrade-observability/on-premise/grafana/upgrade-promtail.md +++ b/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,9 +38,9 @@ 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. @@ -48,7 +48,7 @@ These steps will need to be performed on all application servers that host a Pro * 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 diff --git a/content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md b/content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md index 84aa1b6ed..d87578dd9 100644 --- a/content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md +++ b/content/en/docs/2025.7/getting-started/cloud/add-observability-to-innovation/Grafana/install-alloy/install-alloy.md @@ -12,11 +12,11 @@ This guide describes how to install Grafana Alloy on the Application Server(s). ## Install 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:\Program Data\Cortex\Observability\Grafana Alloy`. +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.