Skip to content

Commit 66f88d3

Browse files
wso2-engineering-botclaude
andcommitted
Fix: Add audit log timestamp precision documentation for all affected versions (product-is#26581)
- Add configuration section for next version with log_mgt.audit_log.truncate_to_microseconds config - Add note about nanosecond precision change for versions 7.1 and 7.2 - Document recordedAt field precision behavior with Java 21 support Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
1 parent 19b1e6d commit 66f88d3

File tree

3 files changed

+19
-0
lines changed

3 files changed

+19
-0
lines changed

en/identity-server/7.1.0/docs/deploy/monitor/monitor-logs.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,9 @@ appender.AUDIT_LOGFILE.filter.threshold.level = INFO
9595

9696
The log levels that can be configured are [listed below](#set-the-log4j-log-level).
9797

98+
!!! note "Audit log timestamp precision"
99+
With Java 21 support in WSO2 Identity Server 7.1, the timestamps in audit logs (v2 version) can have nanosecond precision due to the Java upgrade. This change affects the `recordedAt` field in the audit log.
100+
98101
### Configure HTTP access logs
99102

100103
See [HTTP Access Logging]({{base_path}}/deploy/monitor/http-access-logging) for instructions on how to configure and use HTTP access logs.

en/identity-server/7.2.0/docs/deploy/monitor/monitor-logs.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,9 @@ appender.AUDIT_LOGFILE.filter.threshold.level = INFO
9595

9696
The log levels that can be configured are [listed below](#set-the-log4j-log-level).
9797

98+
!!! note "Audit log timestamp precision"
99+
With Java 21 support in WSO2 Identity Server 7.2, the timestamps in audit logs (v2 version) can have nanosecond precision due to the Java upgrade. This change affects the `recordedAt` field in the audit log.
100+
98101
### Configure HTTP access logs
99102

100103
See [HTTP Access Logging]({{base_path}}/deploy/monitor/http-access-logging) for instructions on how to configure and use HTTP access logs.

en/identity-server/next/docs/deploy/monitor/monitor-logs.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,19 @@ appender.AUDIT_LOGFILE.filter.threshold.level = INFO
9595

9696
The log levels that can be configured are [listed below](#set-the-log4j-log-level).
9797

98+
#### Configure audit log timestamp precision
99+
100+
Starting from Java 21 support in WSO2 Identity Server, the timestamps in audit logs (v2 version) can have nanosecond precision due to the Java upgrade. This change affects the `recordedAt` field in the audit log.
101+
102+
To maintain microsecond precision and avoid this behavior change, add the following configuration to the `deployment.toml` file in `<IS_HOME>/repository/conf/`:
103+
104+
```toml
105+
[log_mgt]
106+
audit_log.truncate_to_microseconds = true
107+
```
108+
109+
When this configuration is set to `true`, the timestamp values in audit logs are forcefully truncated to microsecond precision instead of nanosecond precision.
110+
98111
### Configure HTTP access logs
99112

100113
See [HTTP Access Logging]({{base_path}}/deploy/monitor/http-access-logging) for instructions on how to configure and use HTTP access logs.

0 commit comments

Comments
 (0)