Skip to content
Merged
Show file tree
Hide file tree
Changes from all 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
Original file line number Diff line number Diff line change
Expand Up @@ -202,6 +202,8 @@ None
[Exception]: {{< url path="Cortex.Reference.DataTypes.Exceptions.Exception.MainDoc" >}}
[String]: {{< url path="Cortex.Reference.DataTypes.Text.String.MainDoc" >}}

[Variable Editor]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.BlockProperties.PropertyEditors.VariableEditor.MainDoc" >}}

[Variables Grid]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Dev.FlowEditor.BottomPanel.VariablesGrid.MainDoc" >}}

[Properties]: {{< url path="Cortex.Reference.Glossary.P-T.PropertyCSharp" >}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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.
Expand Down Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -202,6 +202,7 @@ None
[Exception]: {{< url path="Cortex.Reference.DataTypes.Exceptions.Exception.MainDoc" >}}
[String]: {{< url path="Cortex.Reference.DataTypes.Text.String.MainDoc" >}}

[Variable Editor]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.BlockProperties.PropertyEditors.VariableEditor.MainDoc" >}}
[Variables Grid]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Dev.FlowEditor.BottomPanel.VariablesGrid.MainDoc" >}}

[Properties]: {{< url path="Cortex.Reference.Glossary.P-T.PropertyCSharp" >}}
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,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.
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" >}}
Loading