Skip to content

Commit cd1e450

Browse files
author
Donna-Marie Smith
committed
Updated Try It Out for Upgrade of Observability
1 parent 88aca62 commit cd1e450

3 files changed

Lines changed: 36 additions & 30 deletions

File tree

‎content/en/docs/2025.9/Guides/upgrade-guides/upgrade-observability/3.0.0-to-4.0.0/cloud/grafana/prerequisites.md‎

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,6 @@ weight: 1
77

88
# {{% param title %}}
99

10-
## Verify Old Version
11-
12-
1. Navigate to your Grafana website e.g. `https://{Team URL}.grafana.net`
13-
1. Login to Grafana.
14-
1. Open the *Dashboards* page via the menu on the left sidebar.
15-
1. Select the folder that hosts the Cortex Dashboards, e.g. *Cortex*
16-
1. Click the *Flow Execution Requests* dashboard to open it.
17-
1. Change the time period to be *Last 90 days* and confirm data is present.
18-
1. Make a note of values returned in the Overview tiles, or alternatively take a screenshot of the dashboard, to use later to verify the upgrade.
19-
2010
## Make Artefacts Available
2111

2212
1. Download the required artefacts to a folder on your machine:

‎content/en/docs/2025.9/Guides/upgrade-guides/upgrade-observability/3.0.0-to-4.0.0/cloud/grafana/try-it-out.md‎

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -7,27 +7,27 @@ weight: 3
77

88
# {{% param title %}}
99

10-
This guide describes how to verify that the upgrade has been successful. Please ensure that [Upgrade Promtail][] has been completed before taking these steps.
11-
12-
## Confirm Dashboards Load
13-
14-
1. Navigate to your Grafana website e.g. `https://{Team URL}.grafana.net`
15-
1. Login to Grafana.
16-
1. Open the *Dashboards* page via the menu on the left sidebar.
17-
1. Select the folder that hosts the Cortex Dashboards, e.g. *Cortex*
18-
1. Click the *Flow Execution Requests* dashboard to open it.
19-
1. Change the time period to be *Last 90 days* and confirm data is present.
20-
1. Confirm the data from the previous step is similar to the data captured when [verifying the old version][].
10+
This guide describes how to verify that the upgrade has been successful. Please ensure that [Migration to Grafana Alloy][Migrate To Alloy] has been completed before taking these steps.
2111

2212
## Confirm New Data is Processed
2313

2414
{{% alert title="Note" %}}
25-
Any flow can be used that exists on the system and can be executed.
15+
This test uses the test flow published as part of testing the {{% ctx %}} installation. See {{< ahref path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.MultipleServerWithHA.TryItOutPublishedFlowNew" title="Testing HA installation" >}} or {{< ahref path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.SingleServerWithoutHA.TryItOutPublishedFlowNew" title="Testing non-HA installation" >}}. An alternative flow can be used that exists on the system and can be executed.
2616
{{% / alert %}}
2717

28-
1. Open a web browser and navigate to your installed {{% ctx %}} Gateway URL, e.g. `https://server.domain.com/gateway`, and log in when prompted.
29-
1. Open a flow that you are able to execute on an ad hoc basis.
30-
1. Start the flow.
18+
1. Open an HTTP client, such as [Postman][]. Make a request with the following format:
19+
| Property | Value |
20+
|---------------|-------------------------------------------------------------------------------------|
21+
| Action | POST |
22+
| URL | For HA installation use: <br />`https://{FQDN of Load Balancer Server}/api/default/default/flows/{Flow Name}/executions?packageName={Package Name}`<br />e.g. `https://load-balancer&#46;domain&#46;com/api/default/default/flows/NewFlow/executions?packageName=NewPackage` <br /><br /> For non-HA installation use: <br />`https://{FQDN of server}:8722/api/default/default/flows/{Flow Name}/executions?packageName={Package Name}`<br />e.g. `https://server&#46;domain&#46;com:8722/api/default/default/flows/NewFlow/executions?packageName=NewPackage`|
23+
| Content Type | application/json |
24+
| Body | {} |
25+
| Authentication| Basic |
26+
| Username | The value used for `ApiGatewayBasicAuthUsername` when installing Application Services. See [HA Installation script configuration][] or [Non-HA Installation script configuration][] for the value specified.|
27+
| Password | The value used for `ApiGatewayBasicAuthPassword` when installing Application Services (Unencrypted). See [HA Installation script configuration][] or [Non-HA Installation script configuration][] for the value specified.|
28+
29+
{{% alert title="Note" %}} If you used self-signed certificates when installing the Application Servers you may need to disable SSL certificate validation in your HTTP client. {{% /alert %}}
30+
3131
1. Once the request has completed, in your web browser, navigate to and log in to your configured Grafana.
3232
1. Open the *Dashboards* page via the menu on the left sidebar.
3333
1. Click the folder name that the dashboards were imported to.
@@ -44,5 +44,8 @@ If other requests have been made then there may be more than one request visible
4444
If other requests have been made then there may be more than one request visible on the dashboard.
4545
{{% / alert %}}
4646

47-
[Upgrade Promtail]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.2.2.0to3.0.0.Cloud.Grafana.UpgradePromtail" >}}
47+
[Postman]: {{< url path="Postman.Downloads.MainDoc" >}}
48+
[HA Installation script configuration]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.MultipleServerWithHA.ConfigureInstallationScriptNew" >}}
49+
[Migrate To Alloy]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.3.0.0to4.0.0.Cloud.Grafana.MigrateToAlloy" >}}
50+
[Non-HA Installation script configuration]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.SingleServerWithoutHA.ConfigureInstallationScriptNew" >}}
4851
[verifying the old version]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.2.2.0to3.0.0.Cloud.Grafana.VerifyOldVersion" >}}

‎content/en/docs/2025.9/Guides/upgrade-guides/upgrade-observability/3.0.0-to-4.0.0/on-premise/grafana/try-it-out.md‎

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -28,12 +28,22 @@ This guide describes how to verify that the upgrade has been successful. Please
2828
## Confirm New Data is Processed
2929

3030
{{% alert title="Note" %}}
31-
Any flow can be used that exists on the system and can be executed.
31+
This test uses the test flow published as part of testing the {{% ctx %}} installation. See {{< ahref path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.MultipleServerWithHA.TryItOutPublishedFlowNew" title="Testing HA installation" >}} or {{< ahref path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.SingleServerWithoutHA.TryItOutPublishedFlowNew" title="Testing non-HA installation" >}}. An alternative flow can be used that exists on the system and can be executed.
3232
{{% / alert %}}
3333

34-
1. Open a web browser and navigate to your installed {{% ctx %}} Gateway URL, e.g. `https://server.domain.com/gateway`, and log in when prompted.
35-
1. Open a flow that you are able to execute on an ad hoc basis.
36-
1. Start the flow.
34+
1. Open an HTTP client, such as [Postman][]. Make a request with the following format:
35+
| Property | Value |
36+
|---------------|-------------------------------------------------------------------------------------|
37+
| Action | POST |
38+
| URL | For HA installation use: <br />`https://{FQDN of Load Balancer Server}/api/default/default/flows/{Flow Name}/executions?packageName={Package Name}`<br />e.g. `https://load-balancer&#46;domain&#46;com/api/default/default/flows/NewFlow/executions?packageName=NewPackage` <br /><br /> For non-HA installation use: <br />`https://{FQDN of server}:8722/api/default/default/flows/{Flow Name}/executions?packageName={Package Name}`<br />e.g. `https://server&#46;domain&#46;com:8722/api/default/default/flows/NewFlow/executions?packageName=NewPackage`|
39+
| Content Type | application/json |
40+
| Body | {} |
41+
| Authentication| Basic |
42+
| Username | The value used for `ApiGatewayBasicAuthUsername` when installing Application Services. See [HA Installation script configuration][] or [Non-HA Installation script configuration][] for the value specified.|
43+
| Password | The value used for `ApiGatewayBasicAuthPassword` when installing Application Services (Unencrypted). See [HA Installation script configuration][] or [Non-HA Installation script configuration][] for the value specified.|
44+
45+
{{% alert title="Note" %}} If you used self-signed certificates when installing the Application Servers you may need to disable SSL certificate validation in your HTTP client. {{% /alert %}}
46+
3747
1. Once the request has completed, in your web browser, navigate to and log in to your configured Grafana.
3848
1. Open the *Dashboards* page via the menu on the left sidebar.
3949
1. Click the folder name that the dashboards were imported to.
@@ -50,5 +60,8 @@ If other requests have been made then there may be more than one request visible
5060
If other requests have been made then there may be more than one request visible on the dashboard.
5161
{{% / alert %}}
5262

63+
[HA Installation script configuration]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.MultipleServerWithHA.ConfigureInstallationScriptNew" >}}
5364
[Migrate To Alloy]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.3.0.0to4.0.0.OnPremise.Grafana.MigrateToAlloy" >}}
65+
[Non-HA Installation script configuration]: {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.SingleServerWithoutHA.ConfigureInstallationScriptNew" >}}
66+
[Postman]: {{< url path="Postman.Downloads.MainDoc" >}}
5467
[verifying the old version]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeObservability.3.0.0to4.0.0.OnPremise.Grafana.VerifyOldVersion" >}}

0 commit comments

Comments
 (0)