Skip to content
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 25 additions & 5 deletions content/en/blog/releases/2025.X/2025.7.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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) |
Expand Down Expand Up @@ -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" >}}
Expand Down Expand Up @@ -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" >}}
Expand Down
7 changes: 6 additions & 1 deletion content/en/docs/2025.7/Whats New/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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" >}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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" >}}
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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" >}}
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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" >}}
Original file line number Diff line number Diff line change
Expand Up @@ -11,14 +11,14 @@ 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?

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" >}}
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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" >}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,8 @@ The application servers (as described in {{< ahref path="Cortex.GettingStarted.O

| Server&nbsp;Role | Windows&nbsp;Server[^1] | IIS[^2] | Other&nbsp;Software |
|------------------|-------------------------|---------|----------|
| Web Application Server | [2022 (x64)][] *Recommended*<br>[2019 (x64)][] | 10.0.20348[^3]<br>10.0.17763[^4]<br>[URL Rewrite module 2.1][] | [Grafana 10.4.1][] *Enterprise Edition*<br>[Grafana Loki 3.0.0][]|
| Application Server | [2022 (x64)][] *Recommended*<br>[2019 (x64)][] | | [Grafana Alloy 1.10.0][]|
| Web Application Server | [2022 (x64)][] *Recommended*<br>[2019 (x64)][] | 10.0.20348[^3]<br>10.0.17763[^4]<br>[URL Rewrite module 2.1][] | [Grafana 12.1.1][] *Enterprise Edition*<br>[Grafana Loki 3.5.5][]|
| 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.
[^2]: IIS is supported; other web servers, including IIS Express are not supported.
Expand Down Expand Up @@ -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" >}}
Expand Down
8 changes: 7 additions & 1 deletion data/urls.toml
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand Down Expand Up @@ -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]
Expand Down