net.logstash.logback.layout

Class LogstashLayout

java.lang.Object

ch.qos.logback.core.spi.ContextAwareBase

ch.qos.logback.core.LayoutBase<Event>

net.logstash.logback.layout.CompositeJsonLayout<ILoggingEvent>

net.logstash.logback.layout.LoggingEventCompositeJsonLayout

net.logstash.logback.layout.LogstashLayout

All Implemented Interfaces:

Layout<ILoggingEvent>, ContextAware, LifeCycle

public class LogstashLayout
extends LoggingEventCompositeJsonLayout

Field Summary

Fields inherited from class ch.qos.logback.core.LayoutBase

started

Fields inherited from class ch.qos.logback.core.spi.ContextAwareBase

context

Constructor Summary

Constructors

Constructor and Description
LogstashLayout()

Method Summary

Modifier and Type	Method and Description
void	addExcludeMdcKeyName(String excludedMdcKeyName)
void	addIncludeMdcKeyName(String includedMdcKeyName)
void	addMdcKeyFieldName(String mdcKeyFieldName)
void	addProvider(JsonProvider<ILoggingEvent> provider)
protected AbstractCompositeJsonFormatter<ILoggingEvent>	createFormatter()
String	getCustomFields()
List<String>	getExcludeMdcKeyNames()
LogstashFieldNames	getFieldNames()
protected LogstashFormatter	getFormatter()
List<String>	getIncludeMdcKeyNames()
String	getMessageSplitRegex() Write the message as a JSON array by splitting the message text using the specified regex.
String	getNonStructuredArgumentsFieldPrefix()
int	getShortenedLoggerNameLength()
ThrowableHandlingConverter	getThrowableConverter()
String	getTimestampPattern()
String	getTimeZone()
String	getVersion()
boolean	isIncludeCallerData()
boolean	isIncludeContext()
boolean	isIncludeMdc()
boolean	isIncludeNonStructuredArguments()
boolean	isIncludeStructuredArguments()
boolean	isIncludeTags()
boolean	isWriteVersionAsInteger()
void	setCustomFields(String customFields)
void	setExcludeMdcKeyNames(List<String> excludeMdcKeyNames)
void	setFieldNames(LogstashFieldNames fieldNames)
void	setIncludeCallerData(boolean includeCallerData)
void	setIncludeContext(boolean includeContext)
void	setIncludeMdc(boolean includeMdc)
void	setIncludeMdcKeyNames(List<String> includeMdcKeyNames)
void	setIncludeNonStructuredArguments(boolean includeNonStructuredArguments)
void	setIncludeStructuredArguments(boolean includeStructuredArguments)
void	setIncludeTags(boolean includeTags)
void	setMessageSplitRegex(String messageSplitRegex) Write the message as a JSON array by splitting the message text using the specified regex.
void	setNonStructuredArgumentsFieldPrefix(String nonStructuredArgumentsFieldPrefix)
void	setShortenedLoggerNameLength(int length)
void	setThrowableConverter(ThrowableHandlingConverter throwableConverter)
void	setTimestampPattern(String pattern)
void	setTimeZone(String timeZoneId)
void	setVersion(String version)
void	setWriteVersionAsInteger(boolean writeVersionAsInteger)

Methods inherited from class net.logstash.logback.layout.LoggingEventCompositeJsonLayout

setProviders

Methods inherited from class net.logstash.logback.layout.CompositeJsonLayout

doLayout, getJsonFactoryDecorator, getJsonGeneratorDecorator, getLineSeparator, getMinBufferSize, getPrefix, getProviders, getSuffix, isImmediateFlush, setFindAndRegisterJacksonModules, setImmediateFlush, setJsonFactoryDecorator, setJsonGeneratorDecorator, setLineSeparator, setMinBufferSize, setPrefix, setSuffix, start, stop

Methods inherited from class ch.qos.logback.core.LayoutBase

getContentType, getContext, getFileFooter, getFileHeader, getPresentationFooter, getPresentationHeader, isStarted, setContext, setFileFooter, setFileHeader, setPresentationFooter, setPresentationHeader

Methods inherited from class ch.qos.logback.core.spi.ContextAwareBase

addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn, getDeclaredOrigin, getStatusManager

Methods inherited from class java.lang.Object

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

Methods inherited from interface ch.qos.logback.core.spi.ContextAware

addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn

Constructor Detail

LogstashLayout

public LogstashLayout()

Method Detail

createFormatter

protected AbstractCompositeJsonFormatter<ILoggingEvent> createFormatter()

Overrides:

createFormatter in class LoggingEventCompositeJsonLayout

getFormatter

protected LogstashFormatter getFormatter()

Overrides:

getFormatter in class CompositeJsonLayout<ILoggingEvent>

addProvider

public void addProvider(JsonProvider<ILoggingEvent> provider)

setCustomFields

public void setCustomFields(String customFields)

getCustomFields

public String getCustomFields()

isIncludeCallerData

public boolean isIncludeCallerData()

setIncludeCallerData

public void setIncludeCallerData(boolean includeCallerData)

getFieldNames

public LogstashFieldNames getFieldNames()

setFieldNames

public void setFieldNames(LogstashFieldNames fieldNames)

isIncludeMdc

public boolean isIncludeMdc()

setIncludeMdc

public void setIncludeMdc(boolean includeMdc)

getIncludeMdcKeyNames

public List<String> getIncludeMdcKeyNames()

addIncludeMdcKeyName

public void addIncludeMdcKeyName(String includedMdcKeyName)

setIncludeMdcKeyNames

public void setIncludeMdcKeyNames(List<String> includeMdcKeyNames)

getExcludeMdcKeyNames

public List<String> getExcludeMdcKeyNames()

addExcludeMdcKeyName

public void addExcludeMdcKeyName(String excludedMdcKeyName)

setExcludeMdcKeyNames

public void setExcludeMdcKeyNames(List<String> excludeMdcKeyNames)

addMdcKeyFieldName

public void addMdcKeyFieldName(String mdcKeyFieldName)

isIncludeTags

public boolean isIncludeTags()

setIncludeTags

public void setIncludeTags(boolean includeTags)

isIncludeContext

public boolean isIncludeContext()

setIncludeContext

public void setIncludeContext(boolean includeContext)

isIncludeStructuredArguments

public boolean isIncludeStructuredArguments()

setIncludeStructuredArguments

public void setIncludeStructuredArguments(boolean includeStructuredArguments)

isIncludeNonStructuredArguments

public boolean isIncludeNonStructuredArguments()

setIncludeNonStructuredArguments

public void setIncludeNonStructuredArguments(boolean includeNonStructuredArguments)

getNonStructuredArgumentsFieldPrefix

public String getNonStructuredArgumentsFieldPrefix()

setNonStructuredArgumentsFieldPrefix

public void setNonStructuredArgumentsFieldPrefix(String nonStructuredArgumentsFieldPrefix)

getShortenedLoggerNameLength

public int getShortenedLoggerNameLength()

setShortenedLoggerNameLength

public void setShortenedLoggerNameLength(int length)

getTimeZone

public String getTimeZone()

setTimeZone

public void setTimeZone(String timeZoneId)

getThrowableConverter

public ThrowableHandlingConverter getThrowableConverter()

getTimestampPattern

public String getTimestampPattern()

setTimestampPattern

public void setTimestampPattern(String pattern)

setThrowableConverter

public void setThrowableConverter(ThrowableHandlingConverter throwableConverter)

getVersion

public String getVersion()

setVersion

public void setVersion(String version)

isWriteVersionAsInteger

public boolean isWriteVersionAsInteger()

setWriteVersionAsInteger

public void setWriteVersionAsInteger(boolean writeVersionAsInteger)

getMessageSplitRegex

public String getMessageSplitRegex()

Write the message as a JSON array by splitting the message text using the specified regex.

Returns:

The regex used to split the message text

setMessageSplitRegex

public void setMessageSplitRegex(String messageSplitRegex)

Write the message as a JSON array by splitting the message text using the specified regex.

The allowed values are:

• Null/Empty : Disable message splitting. This is also the default behavior.
• Any valid regex : Use the specified regex.
• SYSTEM : Use the system-default line separator.
• UNIX : Use \n.
• WINDOWS : Use \r\n.

For example, if this parameter is set to the regex #+, then the logging statement:

 log.info("First line##Second line###Third line")
 

will produce:

 {
     ...
     "message": [
         "First line",
         "Second line",
         "Third line"
     ],
     ...
 }
 

Parameters:

messageSplitRegex - The regex used to split the message text