Please describe the problem you are having with the documentation. Is information missing, inaccurate, or unclear? Tell us about the context where you encountered the problem so we can understand how to address it.
Problem
The logFormat option table on this page does not list %I and %O as
supported tokens:
https://openliberty.io/docs/latest/access-logging.html
These tokens exist in Apache httpd's mod_log_config (bytes received / bytes
sent including headers), so customers commonly assume Liberty supports them
too. Configuring logFormat with %I or %O produces an FFDC:
java.lang.IllegalArgumentException: Config: invalid format segment: %I
This is expected behavior — %I/%O were never implemented in
AccessLogData — but the doc gap leads directly to support cases, since
customers can't tell if this is a bug or an unsupported feature.
Exact change requested
Add a row to the logFormat option table (or a note directly below it):
| Token |
Description |
| %I / %O |
Not supported. These Apache httpd tokens for bytes received/sent including headers are not implemented in Liberty. Using them causes a startup FFDC (IllegalArgumentException: Config: invalid format segment: %I/%O). Use %b (response body bytes, excluding headers) as the nearest alternative. |
Reference: TS022773695 / TS022451677
Please describe the problem you are having with the documentation. Is information missing, inaccurate, or unclear? Tell us about the context where you encountered the problem so we can understand how to address it.
Problem
The
logFormatoption table on this page does not list%Iand%Oassupported tokens:
https://openliberty.io/docs/latest/access-logging.html
These tokens exist in Apache httpd's mod_log_config (bytes received / bytes
sent including headers), so customers commonly assume Liberty supports them
too. Configuring
logFormatwith%Ior%Oproduces an FFDC:java.lang.IllegalArgumentException: Config: invalid format segment: %I
This is expected behavior —
%I/%Owere never implemented inAccessLogData— but the doc gap leads directly to support cases, sincecustomers can't tell if this is a bug or an unsupported feature.
Exact change requested
Add a row to the logFormat option table (or a note directly below it):
IllegalArgumentException: Config: invalid format segment: %I/%O). Use%b(response body bytes, excluding headers) as the nearest alternative.Reference: TS022773695 / TS022451677