wrapper.console.format

Compatibility :1.0.0
Editions :Professional EditionStandard EditionCommunity Edition
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

Format to use for output to the console. Logging has been intentionally kept simple.

The format consists of the following tokens:

  • 'L' for log level
  • 'P' for prefix
  • 'D' for thread (since ver. 3.1.0)
  • 'T' for time
  • 'Z' for millisecond time
  • 'R' quiet duration in milliseconds showing the time since the previous JVM output
  • 'U' for approximate uptime in seconds (based on internal tick counter and is valid up to one year from startup) (since ver. 3.5.0)
  • 'G' for time in milliseconds it took to log the previous log entry (see wrapper.log.warning.threshold for more information) (since ver. 3.5.8)
  • 'W' for the PID of the Wrapper process (since ver. 3.5.30)
  • 'J' for the PID of the Java process (if the JVM is up) (since ver. 3.5.30)
  • 'M' for message

If the format contains these tokens above, then it will be output with the specified formation. The order of the tokens does not affect the way the log appears, but the 'M' (for message) token should usually be placed last as it is the only column without a uniform width. If the property is missing tokens or commented out, then the default value 'PM' will be used.

Property Example:

Property Example:
wrapper.console.format=PM

Disable console output:

Setting the property to a blank value will cause console output to be disabled.

Property Example:
wrapper.console.format=

Output Example:

The following examples demonstrate the output with various settings. Note that the first two lines are output from the Wrapper, while the last is output from the JVM.

Output Example with the property "wrapper.console.format=LPZM"
STATUS | wrapper  | 2001/12/11 13:45:33.560 | --> Wrapper Started as Console
STATUS | wrapper  | 2001/12/11 13:45:33.560 | Launching a JVM...
INFO   | jvm 1    | 2001/12/11 13:45:35.575 | Initializing...
Output Example with the property "wrapper.console.format=LPTM"
STATUS | wrapper  | 2001/12/11 13:45:33 | --> Wrapper Started as Console
STATUS | wrapper  | 2001/12/11 13:45:33 | Launching a JVM...
INFO   | jvm 1    | 2001/12/11 13:45:35 | Initializing...
Output Example with the property "wrapper.console.format=PTM"
wrapper  | 2001/12/11 13:45:33 | --> Wrapper Started as Console
wrapper  | 2001/12/11 13:45:33 | Launching a JVM...
jvm 1    | 2001/12/11 13:45:35 | Initializing...
Output Example with the property "wrapper.console.format=PM"
wrapper  | --> Wrapper Started as Console
wrapper  | Launching a JVM...
jvm 1    | Initializing...
Output Example with the property "wrapper.console.format=M"
--> Wrapper Started as Console
Launching a JVM...
Initializing...
Output Example with the property "wrapper.console.format="
< No Output >

The format token 'D' for thread is mainly useful for debugging the Wrapper. It displays which internal Wrapper thread output a given log message. It does not show information about Java threads.

Output Example with the property "wrapper.console.format=LPDTM"
STATUS | wrapper  | main    | 2001/12/11 13:45:33 | --> Wrapper Started as Console
STATUS | wrapper  | main    | 2001/12/11 13:45:33 | Launching a JVM...
INFO   | jvm 1    | main    | 2001/12/11 13:45:35 | Initializing...

Reference: Console