This is an automated email from the ASF dual-hosted git repository.
sarvekshayr pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/ozone-site.git
The following commit(s) were added to refs/heads/master by this push:
new 8b27425023 HDDS-15954. Document ozone daemonlog command (#518)
8b27425023 is described below
commit 8b27425023b6efcf275629921938e7ae9b292b6c
Author: Shuo Huang <[email protected]>
AuthorDate: Wed Jul 29 18:31:03 2026 +0800
HDDS-15954. Document ozone daemonlog command (#518)
Co-authored-by: Doroszlai, Attila <[email protected]>
---
.../02-logging/01-application-logs.md | 39 ++++++++++++++++++++++
.../03-operations/11-tools/README.mdx | 1 +
2 files changed, 40 insertions(+)
diff --git
a/docs/05-administrator-guide/02-configuration/02-logging/01-application-logs.md
b/docs/05-administrator-guide/02-configuration/02-logging/01-application-logs.md
index cd925888da..bce9af711a 100644
---
a/docs/05-administrator-guide/02-configuration/02-logging/01-application-logs.md
+++
b/docs/05-administrator-guide/02-configuration/02-logging/01-application-logs.md
@@ -52,6 +52,45 @@ rootLogger.level = debug
After saving the file and restarting the service, the service will start
logging more detailed debug information.
+### Changing Service Log Levels at Runtime
+
+Use `ozone daemonlog` to inspect or change the log level of a running Ozone
+daemon without restarting it. The command talks to the daemon's HTTP endpoint
+and is useful when you need temporary debug logging while troubleshooting a
live
+service.
+
+```bash
+ozone daemonlog -getlevel <host:port> <logger-name> [-protocol http|https]
+ozone daemonlog -setlevel <host:port> <logger-name> <level> [-protocol
http|https]
+```
+
+The `<host:port>` value is the daemon HTTP address. For example, the default
+HTTP ports are `9874` for Ozone Manager, `9876` for Storage Container Manager,
+`9882` for Datanode, `19878` for the S3 Gateway web admin server, and `9888`
+for Recon.
+
+The following example checks the effective log level for the SCM event queue
logger:
+
+```bash
+ozone daemonlog -getlevel scm.example.com:9876
org.apache.hadoop.hdds.server.events.EventQueue
+```
+
+To increase the same logger to `DEBUG`:
+
+```bash
+ozone daemonlog -setlevel scm.example.com:9876
org.apache.hadoop.hdds.server.events.EventQueue DEBUG
+```
+
+After collecting the required debug information, reset the logger to its
previous level:
+
+```bash
+ozone daemonlog -setlevel scm.example.com:9876
org.apache.hadoop.hdds.server.events.EventQueue INFO
+```
+
+The change applies to the running daemon process. To make a log level change
+persistent across restarts, update the service's `log4j.properties` file
+instead.
+
### Enabling Debug Logs for CLI Tools
To enable debug logging for Ozone CLI tools (e.g., `ozone sh volume create`),
you can set the `OZONE_ROOT_LOGGER` environment variable to `debug`:
diff --git a/docs/05-administrator-guide/03-operations/11-tools/README.mdx
b/docs/05-administrator-guide/03-operations/11-tools/README.mdx
index a4562f274f..de1ad4e48a 100644
--- a/docs/05-administrator-guide/03-operations/11-tools/README.mdx
+++ b/docs/05-administrator-guide/03-operations/11-tools/README.mdx
@@ -36,6 +36,7 @@ Commands used to start or stop Ozone services.
## Admin commands
- **`admin`** – Admin and developer commands for Ozone components
+- **`daemonlog`** – Get or set runtime log levels for Ozone daemon loggers
- **`insight`** – Display filtered logs, metrics, or configs for debugging
- **`classpath`** – Print Hadoop classpath
- **`dtutil`** – Delegation token operations
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
