Package org.apache.logging.log4j.core.layout

Class Rfc5424Layout

java.lang.Object

org.apache.logging.log4j.core.layout.AbstractLayout<String>

org.apache.logging.log4j.core.layout.AbstractStringLayout

org.apache.logging.log4j.core.layout.Rfc5424Layout

All Implemented Interfaces:

LocationAware, Layout<String>, Encoder<LogEvent>, StringLayout

@Plugin(name="Rfc5424Layout",
        category="Core",
        elementType="layout",
        printObject=true)
public final class Rfc5424Layout
extends AbstractStringLayout

Formats a log event in accordance with RFC 5424.

See Also:

RFC 5424

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Rfc5424Layout.Rfc5424LayoutBuilder

Nested classes/interfaces inherited from class org.apache.logging.log4j.core.layout.AbstractStringLayout

AbstractStringLayout.Builder<B extends AbstractStringLayout.Builder<B>>, AbstractStringLayout.Serializer, AbstractStringLayout.Serializer2

Field Summary

Fields

Modifier and Type	Field	Description
static int	DEFAULT_ENTERPRISE_NUMBER	The default example enterprise number from RFC5424.
static String	DEFAULT_ID	The default event id.
static String	DEFAULT_MDCID	Default MDC ID: "mdc" .
static Pattern	ENTERPRISE_ID_PATTERN	For now, avoid too restrictive OID checks to allow for easier transition
static Pattern	NEWLINE_PATTERN	Match newlines in a platform-independent manner.
static Pattern	PARAM_VALUE_ESCAPE_PATTERN	Deprecated.

Fields inherited from class org.apache.logging.log4j.core.layout.AbstractStringLayout

DEFAULT_STRING_BUILDER_SIZE, MAX_STRING_BUILDER_SIZE

Fields inherited from class org.apache.logging.log4j.core.layout.AbstractLayout

configuration, eventCount, footer, header, LOGGER

Fields inherited from interface org.apache.logging.log4j.core.Layout

ELEMENT_TYPE

Method Summary

Modifier and Type	Method	Description
static Rfc5424Layout	createLayout(Facility facility, String id, int enterpriseNumber, boolean includeMDC, String mdcId, String mdcPrefix, String eventPrefix, boolean newLine, String escapeNL, String appName, String msgId, String excludes, String includes, String required, String exceptionPattern, boolean useTlsMessageFormat, LoggerFields[] loggerFields, Configuration config)	Deprecated. Since 2.21.0 use instead
Map<String,String>	getContentFormat()	Gets this Rfc5424Layout's content format.
String	getDefaultId()
String	getEnterpriseNumber()
Facility	getFacility()
protected List<String>	getMdcExcludes()
String	getMdcId()
protected List<String>	getMdcIncludes()
protected String	getProcId()
boolean	isIncludeMdc()
static Rfc5424Layout.Rfc5424LayoutBuilder	newBuilder()
String	toSerializable(LogEvent event)	Formats a LogEvent in conformance with the RFC 5424 Syslog specification.
String	toString()

Methods inherited from class org.apache.logging.log4j.core.layout.AbstractStringLayout

getBytes, getCharset, getContentType, getFooter, getFooterSerializer, getHeader, getHeaderSerializer, getStringBuilder, getStringBuilderEncoder, requiresLocation, serializeToBytes, serializeToString, toByteArray, trimToMaxSize

Methods inherited from class org.apache.logging.log4j.core.layout.AbstractLayout

encode, getConfiguration, markEvent

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.logging.log4j.core.layout.Encoder

encode

Field Detail

DEFAULT_ENTERPRISE_NUMBER

public static final int DEFAULT_ENTERPRISE_NUMBER

The default example enterprise number from RFC5424.

See Also:

Constant Field Values

DEFAULT_ID

public static final String DEFAULT_ID

The default event id.

See Also:

Constant Field Values

NEWLINE_PATTERN

public static final Pattern NEWLINE_PATTERN

Match newlines in a platform-independent manner.

PARAM_VALUE_ESCAPE_PATTERN

@Deprecated
public static final Pattern PARAM_VALUE_ESCAPE_PATTERN

Deprecated.

Match characters which require escaping.

ENTERPRISE_ID_PATTERN

public static final Pattern ENTERPRISE_ID_PATTERN

For now, avoid too restrictive OID checks to allow for easier transition

DEFAULT_MDCID

public static final String DEFAULT_MDCID

Default MDC ID: "mdc" .

See Also:

Constant Field Values

Method Detail

getContentFormat

public Map<String,String> getContentFormat()

Gets this Rfc5424Layout's content format. Specified by:

• Key: "structured" Value: "true"
• Key: "format" Value: "RFC5424"

Specified by:

getContentFormat in interface Layout<String>

Overrides:

getContentFormat in class AbstractLayout<String>

Returns:

Map of content format keys supporting Rfc5424Layout

toSerializable

public String toSerializable(LogEvent event)

Formats a LogEvent in conformance with the RFC 5424 Syslog specification.

Parameters:

event - The LogEvent.

Returns:

The RFC 5424 String representation of the LogEvent.

getProcId

protected String getProcId()

getMdcExcludes

protected List<String> getMdcExcludes()

getMdcIncludes

protected List<String> getMdcIncludes()

toString

public String toString()

Overrides:

toString in class Object

createLayout

@Deprecated
public static Rfc5424Layout createLayout(Facility facility,
                                         String id,
                                         int enterpriseNumber,
                                         boolean includeMDC,
                                         String mdcId,
                                         String mdcPrefix,
                                         String eventPrefix,
                                         boolean newLine,
                                         String escapeNL,
                                         String appName,
                                         String msgId,
                                         String excludes,
                                         String includes,
                                         String required,
                                         String exceptionPattern,
                                         boolean useTlsMessageFormat,
                                         LoggerFields[] loggerFields,
                                         Configuration config)

Deprecated.

Since 2.21.0 use instead

Create the RFC 5424 Layout.

Parameters:

facility - The Facility is used to try to classify the message.

id - The default structured data id to use when formatting according to RFC 5424.

enterpriseNumber - The IANA enterprise number.

includeMDC - Indicates whether data from the ThreadContextMap will be included in the RFC 5424 Syslog record. Defaults to "true:.

mdcId - The id to use for the MDC Structured Data Element.

mdcPrefix - The prefix to add to MDC key names.

eventPrefix - The prefix to add to event key names.

newLine - If true, a newline will be appended to the end of the syslog record. The default is false.

escapeNL - String that should be used to replace newlines within the message text.

appName - The value to use as the APP-NAME in the RFC 5424 syslog record.

msgId - The default value to be used in the MSGID field of RFC 5424 syslog records.

excludes - A comma separated list of MDC keys that should be excluded from the LogEvent.

includes - A comma separated list of MDC keys that should be included in the FlumeEvent.

required - A comma separated list of MDC keys that must be present in the MDC.

exceptionPattern - The pattern for formatting exceptions.

useTlsMessageFormat - If true the message will be formatted according to RFC 5425.

loggerFields - Container for the KeyValuePairs containing the patterns

config - The Configuration. Some Converters require access to the Interpolator.

Returns:

An Rfc5424Layout.

newBuilder

@PluginBuilderFactory
public static Rfc5424Layout.Rfc5424LayoutBuilder newBuilder()

Since:

2.21.0

getFacility

public Facility getFacility()

getDefaultId

public String getDefaultId()

getEnterpriseNumber

public String getEnterpriseNumber()

isIncludeMdc

public boolean isIncludeMdc()

getMdcId

public String getMdcId()