This is an automated email from the ASF dual-hosted git repository.
jojochuang 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 f6e4f15c4b HDDS-16232. Document how to enable Jersey debug logs in S3
Gateway (#533)
f6e4f15c4b is described below
commit f6e4f15c4be4984940ceaf0d0a901d35249a958a
Author: Shuo Huang <[email protected]>
AuthorDate: Fri Aug 21 01:57:30 2026 +0800
HDDS-16232. Document how to enable Jersey debug logs in S3 Gateway (#533)
---
.../02-logging/01-application-logs.md | 31 ++++++++++++++++++++++
1 file changed, 31 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 bce9af711a..55e2332c40 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,37 @@ rootLogger.level = debug
After saving the file and restarting the service, the service will start
logging more detailed debug information.
+#### Enabling Jersey Debug Logs in S3 Gateway
+
+Jersey uses `java.util.logging` (JUL). S3 Gateway forwards JUL records to
SLF4J,
+but JUL checks the log level before forwarding a record. Therefore, both JUL
+and log4j must allow debug records.
+
+Create a JUL configuration file, for example
+`$OZONE_CONF_DIR/s3g-jul-logging.properties`, with the following content:
+
+```properties
+org.glassfish.jersey.level = FINE
+```
+
+`FINE` is the JUL level that maps to SLF4J `DEBUG`. This setting enables it
only
+for Jersey loggers.
+
+Add the following line to `$OZONE_CONF_DIR/log4j.properties`:
+
+```properties
+log4j.logger.org.glassfish.jersey=DEBUG
+```
+
+Configure S3 Gateway to use the JUL properties file by adding the following to
+`$OZONE_CONF_DIR/ozone-env.sh`:
+
+```bash
+export OZONE_S3G_OPTS="${OZONE_S3G_OPTS}
-Djava.util.logging.config.file=${OZONE_CONF_DIR}/s3g-jul-logging.properties"
+```
+
+Restart S3 Gateway for the changes to take effect.
+
### Changing Service Log Levels at Runtime
Use `ozone daemonlog` to inspect or change the log level of a running Ozone
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
