Merge pull request #11112 from mendix/MvM-SetLogLevelsIssue-RUN-4782

Improve information about setting log levels

Author: MarkvanMents

content/en/docs/refguide/runtime/logging/log-levels.md

@@ -56,7 +56,7 @@ These are the log levels used by Mendix:
 | --- | --- | --- | --- |
 | Trace | | | More detailed information. These are only written to logs. |
 | Debug | | | Detailed information, typically of interest only when diagnosing problems. |
-| Info  | | | Confirmation that things are working as expected. |
+| Info | | | Confirmation that things are working as expected. |
 | Warning | {{< figure src="/attachments/refguide/runtime/log-levels/warning.png" class="no-border" >}} | Orange | Indicates that something unexpected happened or that there is some problem in the near future (for example, "disk space low"). The application is still working as expected. |
 | Error | {{< figure src="/attachments/refguide/runtime/log-levels/error.png" class="no-border" >}} | Red | Due to a more serious problem, the application has not been able to perform some function. |
 | Critical | {{< figure src="/attachments/refguide/runtime/log-levels/critical.png" class="no-border" >}} | White (text), red (background) | A serious error has occurred, indicating that the application itself may be unable to continue running. |
@@ -69,6 +69,8 @@ In this section you will learn how to specify which log messages are generated,
 
 Log levels can be configured through the runtime admin port before the actual log levels exist. You can therefore create a script that sets all the required log levels at once.
 
+The request is documented in the [Set Log Levels](/refguide/monitoring-mendix-runtime/#log-levels) section of *Monitoring Mendix Runtime*. When making requests to the Mendix runtime, you will need to authenticate by including the authorization headers as described in [Monitoring Mendix Runtime](/refguide/monitoring-mendix-runtime/#auth-headers).
+
 This is a Python script that sets `ConnectionBus` and `ActionManager` to the Trace and Debug levels, respectively:
 
 ```py

content/en/docs/refguide/runtime/monitoring-mendix-runtime.md

@@ -22,7 +22,11 @@ For deployments to Mendix Cloud, you can get the same information from various p
 
 You can change the admin port from Studio Pro by navigating to **App** > **Settings** > **Configurations** > *your configuration* > **Server** > **Admin port**.
 
-The request needs to be of the **POST** type with **No Authorization** and the following headers:
+The following sections explain which monitoring actions are supported.
+
+### Authorization Headers{#auth-headers}
+
+Requests need to be of the **POST** type with **No Authorization** and the following headers:
 
 * Content-Type: **application/json**
 * X-M2EE-Authentication: **yourM2EEPassword_Base64Encoded**
@@ -31,8 +35,6 @@ The request needs to be of the **POST** type with **No Authorization** and the f
 
     Remember to Base64 encode the password before passing it as the value for `X-M2EE-Authentication`
 
-The next sections explain which monitoring actions are supported.
-
 ## Current Executions
 
 ### Request
@@ -673,3 +675,36 @@ This will write logs to standard output in simple text format.
 ```
 
 This will send logs to the registered OpenTelemetry collector. See [Tracing](/refguide/tracing-in-runtime/) for a guide on how to enable OpenTelemetry.
+
+## Set Log Levels{#log-levels}
+
+This action allows you to programmatically set log levels for specific log nodes without restarting the runtime.
+
+### Request
+
+```json
+{
+  "action": "set_log_level",
+  "params": {
+    "subscriber": "*",
+    "nodes": [
+      {
+        "name": "<LogNode>",
+        "level": "<LogLevel>"
+      },
+      …
+    ],
+    "force": true
+  }
+}
+```
+
+{{% alert color="info" %}}
+`LogLevel` can be one of: `TRACE`, `DEBUG`, `INFO`, `WARNING`, `ERROR`, or `CRITICAL`.
+
+The `force` parameter allows you to set log levels for log nodes that do not yet exist in the runtime.
+{{% /alert %}}
+
+### Response
+
+The request will always return an empty JSON object (`{}`) with status code 200, if successful.