added FAQ for changing Logging Levels and linked to it from Upgrade Guide

Author: Donna-Marie Smith

content/en/docs/2025.3/FAQs/change-logging-levels/_index.md

@@ -0,0 +1,20 @@
+---
+title: "How do I change the logging level?"
+linkTitle: "How do I change the logging level?"
+description: "Instructions on how to change the {{% ctx %}} logging level."
+weight: 1000
+---
+
+{{% ctx %}} Logging Levels are set to `Error` by default for most services. However, levels can be changed whilst {{% ctx %}} is running by sending REST calls to the {{% ctx %}} API Gateway service.
+
+{{% alert title="Note" %}}
+Although the logging level for the {{% ctx %}} API Gateway service can be increased, it will still always log all API calls received regardless of logging level.
+{{% / alert %}}
+
+If increasing the logging level, particularly if increasing for everything or for Block Logging, we recommend that this is done only when required. Increasing log levels will lead to an increase in disk usage and disk writes, which can impact the performance of the {{% ctx %}} platform if not monitored.
+
+Whilst increased logging levels are in place, we would recommend closely monitoring system performance and disk space usage.
+
+All REST calls to update logging levels use Basic Auth and can be made using REST clients such as [Postman][] or using scripts such as PowerShell. For each of the below solutions, an example PowerShell script will be provided with instructions on how to use.
+
+[Postman]: {{< url path="Postman.Downloads.MainDoc" >}}

content/en/docs/2025.3/FAQs/change-logging-levels/change-all-logging.md

@@ -0,0 +1,50 @@
+---
+title: "Change All Logging Levels"
+linkTitle: "Change All Logging Levels"
+description: "Instructions on how to change the Logging Level for All Logging."
+weight: 10
+---
+
+# {{% param title %}}
+
+To change logging levels for everything, the below PowerShell script can be used to make a REST call against your {{% ctx %}} platform.
+
+1. Run Windows PowerShell ISE as Administrator.
+1. Copy the following script into the PowerShell window:
+
+    ``` powershell
+    $serverFQDN = "server.domain.com"
+    $APIGatewayPort = 8722
+    $loglevel = 4
+
+    $user = "UserName"
+    $pass = Read-Host -Prompt "Enter Password for Basic Auth User"
+    $base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f $user,$pass)))
+    
+    $headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
+    $headers.Add("Content-Type", "application/json")
+    $headers.Add("Accept", "application/json")
+    $headers.Add("Authorization", "Basic $base64AuthInfo")
+    $path = "applications/logging" 
+    $body = @"
+    $loglevel
+    "@
+    
+    $response = Invoke-RestMethod "https://${serverFQDN}:$APIGatewayPort/api/v1/default/default/$path" -Method 'PUT' -Headers $headers -Body $body
+    $response | ConvertTo-Json
+    ```
+
+1. Configure the following variables:
+    * `$serverFQDN` – The fully qualified domain name for the Application Server Or Load Balancer
+    * `$APIGatewayPort` – {{% ctx %}} API Gateway Service Port (8722) or Load Balancer port (typically 443 or 8722)
+    * `$loglevel` – Desired log level as an integer, `1` is enabled and `4` is the default error level
+    * `$user` – {{% ctx %}} API Gateway Basic Auth Username
+
+1. Execute the script, entering the Basic Auth User's password when prompted.
+1. Confirm success response:
+
+    If the call was successful, the following response should be received
+
+    ``` powershell
+    LogLevel was successfully configured.
+    ```

content/en/docs/2025.3/FAQs/change-logging-levels/change-block-logging.md

@@ -0,0 +1,66 @@
+---
+title: "Change Block Logging Levels"
+linkTitle: "Change Block Logging Levels"
+description: "Instructions on how to change the Logging Level for Block Logging."
+weight: 5
+---
+
+# {{% param title %}}
+
+Block logging in {{% ctx %}} logs the following by default:
+
+* Command.CommandText
+* Command.Parameters
+* HTTPRequest
+* HTTPResponse
+* SOAPRequest
+* SOAPResponse
+* Script
+* Parameters
+* Outputs
+* Records
+* Command
+* Response
+* SSH Logs
+
+To change logging levels for block logging so that every block is logged when executed, the below PowerShell script can be used to make a REST call against your {{% ctx %}} platform.
+
+1. Run Windows PowerShell ISE as Administrator.
+1. Copy the following script into the PowerShell window:
+
+    ``` powershell
+    $serverFQDN = "server.domain.com"
+    $APIGatewayPort = 8722
+    $loglevel = 4
+
+    $user = "UserName"
+    $pass = Read-Host -Prompt "Enter Password for Basic Auth User"
+    $base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f $user,$pass)))
+    
+    $headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
+    $headers.Add("Content-Type", "application/json")
+    $headers.Add("Accept", "application/json")
+    $headers.Add("Authorization", "Basic $base64AuthInfo")
+    $path = "applications/ execution/services/engine/blocks/packages/versions/executions/flows/workspaces/blocks/logging" 
+    $body = @"
+    $loglevel
+    "@
+    
+    $response = Invoke-RestMethod "https://${serverFQDN}:$APIGatewayPort/api/v1/default/default/$path" -Method 'PUT' -Headers $headers -Body $body
+    $response | ConvertTo-Json
+    ```
+
+1. Configure the following variables:
+    * `$serverFQDN` – The fully qualified domain name for the Application Server Or Load Balancer
+    * `$APIGatewayPort` – {{% ctx %}} API Gateway Service Port (8722) or Load Balancer port (typically 443 or 8722)
+    * `$loglevel` – Desired log level as an integer, `1` is enabled and `4` is the default error level
+    * `$user` – {{% ctx %}} API Gateway Basic Auth Username
+
+1. Execute the script, entering the Basic Auth User's password when prompted.
+1. Confirm success response:
+
+    If the call was successful, the following response should be received
+
+    ``` powershell
+    LogLevel was successfully configured.
+    ```

content/en/docs/2025.3/FAQs/change-logging-levels/change-flow-logging.md

@@ -0,0 +1,50 @@
+---
+title: "Change Flow Logging Levels"
+linkTitle: "Change Flow Logging Levels"
+description: "Instructions on how to change the Logging Level for Flow Logging."
+weight: 1
+---
+
+# {{% param title %}}
+
+To change logging levels for Flow Logging, the below PowerShell script can be used to make a REST call against your {{% ctx %}} platform.
+
+1. Run Windows PowerShell ISE as Administrator.
+1. Copy the following script into the PowerShell window:
+
+    ``` powershell
+    $serverFQDN = "server.domain.com"
+    $APIGatewayPort = 8722
+    $loglevel = 4
+
+    $user = "UserName"
+    $pass = Read-Host -Prompt "Enter Password for Basic Auth User"
+    $base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f $user,$pass)))
+    
+    $headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
+    $headers.Add("Content-Type", "application/json")
+    $headers.Add("Accept", "application/json")
+    $headers.Add("Authorization", "Basic $base64AuthInfo")
+    $path = "applications/ execution/services/engine/blocks/packages/versions/executions/flows/logging" 
+    $body = @"
+    $loglevel
+    "@
+    
+    $response = Invoke-RestMethod "https://${serverFQDN}:$APIGatewayPort/api/v1/default/default/$path" -Method 'PUT' -Headers $headers -Body $body
+    $response | ConvertTo-Json
+    ```
+
+1. Configure the following variables:
+    * `$serverFQDN` – The fully qualified domain name for the Application Server Or Load Balancer
+    * `$APIGatewayPort` – {{% ctx %}} API Gateway Service Port (8722) or Load Balancer port (typically 443 or 8722)
+    * `$loglevel` – Desired log level as an integer, `1` is enabled and `4` is the default error level
+    * `$user` – {{% ctx %}} API Gateway Basic Auth Username
+
+1. Execute the script, entering the Basic Auth User's password when prompted.
+1. Confirm success response:
+
+    If the call was successful, the following response should be received
+
+    ``` powershell
+    LogLevel was successfully configured.
+    ```

content/en/docs/2025.3/getting-started/cloud/add-observability-to-innovation/Grafana/import-dashboards.md

@@ -32,11 +32,12 @@ Please ensure that the set up for [Grafana][] and [Loki][] have been completed b
 1. Click the Dashboards menu item.
 1. Click the *New* dropdown and select *Import*.
 1. Click on *Upload dashboard JSON file*.
-1. Locate the `Flow Execution Requests.json` file extracted from the downloaded `Grafana.Dashboards.zip`.
+1. Locate the `Flow Execution Details.json` file extracted from the downloaded `Grafana.Dashboards.zip`.
 1. Select the file and click *Open*.
 1. Select the folder in Grafana you wish the dashboard to be saved in, e.g. *Cortex*.
 1. Select your [configured Loki data source][] from the dropdown menu, e.g. *grafanacloud-cortex-logs*.
 1. Click *Import*.
+1. Repeat steps 2 - 10 for the `Flow Execution Requests.json` file.
 1. Repeat steps 2 - 10 for the `Platform Health.json` file.
 
 ## Configure Data Sources

content/en/docs/2025.3/getting-started/on-premise/add-observability-to-innovation/Grafana/setup-grafana.md

@@ -47,11 +47,12 @@ Please ensure that the Installations for [Grafana][] and [Loki][] have been comp
 1. Go to *Dashboards* via the menu on the left sidebar.
 1. Click the *New* button and select *Import* from the drop-down menu.
 1. Click the *Upload JSON file* button.
-1. Locate the `Flow Execution Requests.json` file extracted from the downloaded `Grafana.Dashboards.zip`.
+1. Locate the `Flow Execution Details.json` file extracted from the downloaded `Grafana.Dashboards.zip`.
 1. Select the file and click *Open*.
 1. Select the folder in Grafana you wish the dashboard to be saved in, e.g. *Cortex*.
 1. Select your configured Loki data source from the dropdown menu.
 1. Click *Import*.
+1. Repeat steps 2 - 8 for the `Flow Execution Requests.json` file.
 1. Repeat steps 2 - 8 for the `Platform Health.json` file.
 
 ## Configure Data Sources
@@ -64,14 +65,15 @@ To do this, follow these steps for all default {{% ctx %}} dashboards imported:
 1. To open a dashboard:
     1. Go to *Dashboards* via the menu on the left sidebar.
     1. Click the folder name that the dashboards were imported to.
-    1. Click the *Flow Execution Requests* dashboard to open it.
+    1. Click the *Flow Execution Details* dashboard to open it.
 1. Open the *Dashboard settings* menu via the cog icon in the top right-hand side of the dashboard.
 1. Click *Variables* from the top menu of the *Settings* page.
 1. Click *CustomFilter* at the bottom of the *Variables* list.
 1. Select your configured Loki data source in the *Ad-hoc options* > *Data source* drop-down menu.
 1. Click *Apply*.
 1. Click the dashboard name in the breadcrumb at the top left corner of the page to go back to the dashboard.
 1. Click the + icon next to the Custom Filter to confirm that a list of available filter options is visible.
+1. Repeat steps 2 - 9 for the *Flow Execution Requests* dashboard.
 1. Repeat steps 2 - 9 for the *Platform Health* dashboard.
 
 ## Next Steps?

content/en/docs/2025.9/FAQs/change-logging-levels/_index.md

@@ -0,0 +1,20 @@
+---
+title: "How do I change the logging level?"
+linkTitle: "How do I change the logging level?"
+description: "Instructions on how to change the {{% ctx %}} logging level."
+weight: 1000
+---
+
+{{% ctx %}} Logging Levels are set to `Error` by default for most services. However, levels can be changed whilst {{% ctx %}} is running by sending REST calls to the {{% ctx %}} API Gateway service.
+
+{{% alert title="Note" %}}
+Although the logging level for the {{% ctx %}} API Gateway service can be increased, it will still always log all API calls received regardless of logging level.
+{{% / alert %}}
+
+If increasing the logging level, particularly if increasing for everything or for Block Logging, we recommend that this is done only when required. Increasing log levels will lead to an increase in disk usage and disk writes, which can impact the performance of the {{% ctx %}} platform if not monitored.
+
+Whilst increased logging levels are in place, we would recommend closely monitoring system performance and disk space usage.
+
+All REST calls to update logging levels use Basic Auth and can be made using REST clients such as [Postman][] or using scripts such as PowerShell. For each of the below solutions, an example PowerShell script will be provided with instructions on how to use.
+
+[Postman]: {{< url path="Postman.Downloads.MainDoc" >}}

content/en/docs/2025.9/FAQs/change-logging-levels/change-all-logging.md

@@ -0,0 +1,50 @@
+---
+title: "Change All Logging Levels"
+linkTitle: "Change All Logging Levels"
+description: "Instructions on how to change the Logging Level for All Logging."
+weight: 10
+---
+
+# {{% param title %}}
+
+To change logging levels for everything, the below PowerShell script can be used to make a REST call against your {{% ctx %}} platform.
+
+1. Run Windows PowerShell ISE as Administrator.
+1. Copy the following script into the PowerShell window:
+
+    ``` powershell
+    $serverFQDN = "server.domain.com"
+    $APIGatewayPort = 8722
+    $loglevel = 4
+
+    $user = "UserName"
+    $pass = Read-Host -Prompt "Enter Password for Basic Auth User"
+    $base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f $user,$pass)))
+    
+    $headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
+    $headers.Add("Content-Type", "application/json")
+    $headers.Add("Accept", "application/json")
+    $headers.Add("Authorization", "Basic $base64AuthInfo")
+    $path = "applications/logging" 
+    $body = @"
+    $loglevel
+    "@
+    
+    $response = Invoke-RestMethod "https://${serverFQDN}:$APIGatewayPort/api/v1/default/default/$path" -Method 'PUT' -Headers $headers -Body $body
+    $response | ConvertTo-Json
+    ```
+
+1. Configure the following variables:
+    * `$serverFQDN` – The fully qualified domain name for the Application Server Or Load Balancer
+    * `$APIGatewayPort` – {{% ctx %}} API Gateway Service Port (8722) or Load Balancer port (typically 443 or 8722)
+    * `$loglevel` – Desired log level as an integer, `1` is enabled and `4` is the default error level
+    * `$user` – {{% ctx %}} API Gateway Basic Auth Username
+
+1. Execute the script, entering the Basic Auth User's password when prompted.
+1. Confirm success response:
+
+    If the call was successful, the following response should be received
+
+    ``` powershell
+    LogLevel was successfully configured.
+    ```

content/en/docs/2025.9/FAQs/change-logging-levels/change-block-logging.md

@@ -0,0 +1,66 @@
+---
+title: "Change Block Logging Levels"
+linkTitle: "Change Block Logging Levels"
+description: "Instructions on how to change the Logging Level for Block Logging."
+weight: 5
+---
+
+# {{% param title %}}
+
+Block logging in {{% ctx %}} logs the following by default:
+
+* Command.CommandText
+* Command.Parameters
+* HTTPRequest
+* HTTPResponse
+* SOAPRequest
+* SOAPResponse
+* Script
+* Parameters
+* Outputs
+* Records
+* Command
+* Response
+* SSH Logs
+
+To change logging levels for block logging so that every block is logged when executed, the below PowerShell script can be used to make a REST call against your {{% ctx %}} platform.
+
+1. Run Windows PowerShell ISE as Administrator.
+1. Copy the following script into the PowerShell window:
+
+    ``` powershell
+    $serverFQDN = "server.domain.com"
+    $APIGatewayPort = 8722
+    $loglevel = 4
+
+    $user = "UserName"
+    $pass = Read-Host -Prompt "Enter Password for Basic Auth User"
+    $base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f $user,$pass)))
+    
+    $headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
+    $headers.Add("Content-Type", "application/json")
+    $headers.Add("Accept", "application/json")
+    $headers.Add("Authorization", "Basic $base64AuthInfo")
+    $path = "applications/ execution/services/engine/blocks/packages/versions/executions/flows/workspaces/blocks/logging" 
+    $body = @"
+    $loglevel
+    "@
+    
+    $response = Invoke-RestMethod "https://${serverFQDN}:$APIGatewayPort/api/v1/default/default/$path" -Method 'PUT' -Headers $headers -Body $body
+    $response | ConvertTo-Json
+    ```
+
+1. Configure the following variables:
+    * `$serverFQDN` – The fully qualified domain name for the Application Server Or Load Balancer
+    * `$APIGatewayPort` – {{% ctx %}} API Gateway Service Port (8722) or Load Balancer port (typically 443 or 8722)
+    * `$loglevel` – Desired log level as an integer, `1` is enabled and `4` is the default error level
+    * `$user` – {{% ctx %}} API Gateway Basic Auth Username
+
+1. Execute the script, entering the Basic Auth User's password when prompted.
+1. Confirm success response:
+
+    If the call was successful, the following response should be received
+
+    ``` powershell
+    LogLevel was successfully configured.
+    ```