Apache Log4j (Ver 2)

%c{precision}
%logger{precision}

Outputs the name of the logger that published the logging event. The logger conversion specifier can be optionally followed byprecision specifier, which consists of a decimal integer, or a pattern starting with a decimal integer.

If a precision specifier is given and it is an integer value, then only the corresponding number of right most components of the logger name will be printed. If the precision contains other non-integer characters then the name will be abbreviated based on the pattern. If the precision integer is less than one the right-most token will still be printed in full. By default the logger name is printed in full.

{text:Logger,ftype=logger}

%C{precision}
%class{precision}

Outputs the fully qualified class name of the caller issuing the logging request. This conversion specifier can be optionally followed byprecision specifier, that follows the same rules as the logger name converter.

Generating the class name of the caller (location information) is an expensive operation and may impact performance. Use with caution.

{text:Class,ftype=class}

%d{pattern}
%date{pattern}

Outputs the date of the logging event. The date conversion specifier may be followed by a set of braces containing a date and time pattern string per SimpleDateFormat .

The predefined formats are DEFAULT, ABSOLUTE, COMPACT, DATE, ISO8601, and ISO8601_BASIC.

You can also use a set of braces containing a time zone id per java.util.TimeZone.getTimeZone. If no date format specifier is given then ISO8601 format is assumed

{date:Date,<DATE_PATTERN>}

{date:Date,locale=<?>,yyyy-MM-dd HH:mm:ss,SSS}

Note: (use default locale)

{date:Date,locale=<?>,<same pattern>}

{date:Date,locale=<?>,yyyy-MM-dd HH:mm:ss,SSS}

Note: (use default locale)

Create the relevant date pattern for each option or use the pattern

Outputs the date of the logging event. The date conversion specifier may be followed by a set of braces containing a date and time pattern string per SimpleDateFormat .

The predefined formats are DEFAULT, ABSOLUTE, COMPACT, DATE, ISO8601, and ISO8601_BASIC.

You can also use a set of braces containing a time zone id per java.util.TimeZone.getTimeZone. If no date format specifier is given then ISO8601 format is assumed.

%d{UNIX} outputs the UNIX time in seconds. %d{UNIX_MILLIS} outputs the UNIX time in milliseconds. The UNIX time is the difference, in seconds for UNIX and in milliseconds for UNIX_MILLIS, between the current time and midnight, January 1, 1970 UTC. While the time unit is milliseconds, the granularity depends on the operating system (Windows). This is an efficient way to output the event time because only a conversion from long to String takes place, there is no Date formatting involved.

%enc{pattern}
%encode{pattern}

Escape newlines and HTML special characters in the specified pattern.

Create pattern according to the relevant encoding:

%enc{%m} = {string:Message,ftype=message}

%enc{%mdc{key}} = (string:Key}

%ex|exception|throwable
  {["none"
  |"full"
  |depth
  |"short"
  |"short.className"
  |"short.fileName"
  |"short.lineNumber"
  |"short.methodName"
  |"short.message"
  |"short.localizedMessage"]}

Outputs the Throwable trace bound to the LoggingEvent, by default this will output the full trace as one would normally find with a call to Throwable.printStackTrace().

You can follow the throwable conversion word with an option in the form %throwable{option}.

%throwable{short} outputs the first line of the Throwable.

%throwable{short.className} outputs the name of the class where the exception occurred.

%throwable{short.methodName} outputs the method name where the exception occurred.

%throwable{short.fileName} outputs the name of the class where the exception occurred.

%throwable{short.lineNumber} outputs the line number where the exception occurred.

%throwable{short.message} outputs the message.

%throwable{short.localizedMessage} outputs the localized message.

%throwable{n} outputs the first n lines of the stack trace.

{string:Throwable,ftype=throwable}

Remark: XpoLog need to consider adding a dedicated parsing command to Throwable.

%F
%file

{text:Class,ftype=class}

%highlight{pattern}{style}

Adds ANSI colors to the result of the enclosed pattern based on the current event's logging level.

N/A

%K{key}
%map{key}
%MAP{key}

{text:Key}

%l
location

Outputs location information of the caller which generated the logging event.

{text:Method,ftype=method}({text:Class,ftype=class}:{number:LineNumber,ftype=linenumber})

%L
%line

Outputs the line number from where the logging request was issued.

{number:LineNumber,ftype=linenumber}

%m
%msg
%message

Outputs the application supplied message associated with the logging event.

{string:Message,ftype=message}

%M
%method

Outputs the method name where the logging request was issued.

{text:Method,ftype=method}

%marker

{text:Marker,ftype=marker}

%n

Outputs the platform dependent line separator character or characters.

{eol}

%p|level{level=label, level=label, ...}

%p|level{length=n}

%p|level{lowerCase=true|false}

Outputs the level of the logging event. You provide a level name map in the form "level=value, level=value" where level is the name of the Level and value is the value that should be displayed instead of the name of the Level.

{priority:Priority,ALL;TRACE;DEBUG;INFO;WARN;ERROR;FATAL,ftype=severity}

For the example below:

{priority:Priority, All; Trace; Debug; Info; Warning; Error; Fatal,ftype=severity}

Outputs the level of the logging event. You provide a level name map in the form "level=value, level=value" where level is the name of the Level and value is the value that should be displayed instead of the name of the Level.

For example:

%level{WARN=Warning, DEBUG=Debug, ERROR=Error, TRACE=Trace, INFO= Info }

Alternatively, for the compact-minded:

%level{WARN=W, DEBUG=D, ERROR=E, TRACE=T, INFO=I}

More succinctly, for the same result as above, you can define the length of the level label:

%level{length=1}

If the length is greater than a level name length, the layout uses the normal level name.

You can combine the two kinds of options:

%level{ERROR=Error, length=2}

This give you the Error level name and all other level names of length 2.

Finally, you can output lower-case level names (the default is upper-case):

%level{lowerCase=true}

%r
%relative

{number:LogSpeed,ftype=logprocesstimemilli}

%replace{pattern}{regex}{substitution}

Replaces occurrences of 'regex', a regular expression, with its replacement 'substitution' in the string resulting from evaluation of the pattern. For example, "%replace(%msg}{\s}{}" will remove all spaces contained in the event message.

{string:<PATTERN_NAME>}

%rEx["none"|"short"|"full"|depth],[filters(packages)}
%rException["none"|"short"|"full"|depth],[filters(packages)}
%rThrowable["none"|"short"|"full"|depth],[filters(packages)}

The same as the %throwable conversion word but the stack trace is printed starting with the first exception that was thrown followed by each subsequent wrapping exception.

{string:NestedException,ftype= nestedexception}

%sn
%sequenceNumber

{number:SequenceNumber,ftype=sequencenumber}

%style{pattern}{ANSI style}

Uses ANSI escape sequences to style the result of the enclosed pattern. The style can consist of a comma separated list of style names from the following table.

{string:<PATTERN_NAME>}

%t
%thread

{text:Thread,ftype=thread}

%x
%NDC

{string:NDC}

%X{key}
%mdc{key}
%MDC{key}

{string:NDC_<KEY>}

%u{"RANDOM" | "TIME"}
%uuid

{text:UUID,ftype=uniqueid}

%xEx{"none"|"short"|"full"|depth],[filters(packages)}
%xException["none"|"short"|"full"|depth],[filters(packages)}
%xThrowable["none"|"short"|"full"|depth],[filters(packages)}

The same as the %throwable conversion word but also includes class packaging information.

{string:NestedException,ftype=nestedexception}

Include package information.