org.apache.logging.log4j.core.async

Class AsyncLogger

java.lang.Object

org.apache.logging.log4j.spi.AbstractLogger

org.apache.logging.log4j.core.Logger

org.apache.logging.log4j.core.async.AsyncLogger

All Implemented Interfaces:

com.lmax.disruptor.EventTranslatorVararg<RingBufferLogEvent>, Serializable, Logger, ExtendedLogger, LocationAwareLogger, Supplier<LoggerConfig>

public class AsyncLogger
extends Logger
implements com.lmax.disruptor.EventTranslatorVararg<RingBufferLogEvent>

AsyncLogger is a logger designed for high throughput and low latency logging. It does not perform any I/O in the calling (application) thread, but instead hands off the work to another thread as soon as possible. The actual logging is performed in the background thread. It uses LMAX Disruptor for inter-thread communication.

To use AsyncLogger, specify the System property -DLog4jContextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector before you obtain a Logger, and all Loggers returned by LogManager.getLogger will be AsyncLoggers.

Note that for performance reasons, this logger does not include source location by default. You need to specify includeLocation="true" in the configuration or any %class, %location or %line conversion patterns in your log4j.xml configuration will produce either a "?" character or no output at all.

For best performance, use AsyncLogger with the RandomAccessFileAppender or RollingRandomAccessFileAppender, with immediateFlush=false. These appenders have built-in support for the batching mechanism used by the Disruptor library, and they will flush to disk at the end of each batch. This means that even with immediateFlush=false, there will never be any items left in the buffer; all log events will all be written to disk in a very efficient manner.

See Also:

Serialized Form

Nested Class Summary

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

Logger.LoggerProxy, Logger.PrivateConfig

Field Summary

Fields inherited from class org.apache.logging.log4j.core.Logger

privateConfig

Fields inherited from class org.apache.logging.log4j.spi.AbstractLogger

CATCHING_MARKER, DEFAULT_FLOW_MESSAGE_FACTORY_CLASS, DEFAULT_MESSAGE_FACTORY_CLASS, ENTRY_MARKER, EXCEPTION_MARKER, EXIT_MARKER, FLOW_MARKER, name, THROWING_MARKER

Constructor Summary

Constructors

Constructor and Description
AsyncLogger(LoggerContext context, String name, MessageFactory messageFactory, org.apache.logging.log4j.core.async.AsyncLoggerDisruptor loggerDisruptor) Constructs an AsyncLogger with the specified context, name and message factory.

Method Summary

Modifier and Type	Method and Description
void	actualAsyncLog(RingBufferLogEvent event) This method is called by the EventHandler that processes the RingBufferLogEvent in a separate thread.
void	log(Level level, Marker marker, String fqcn, StackTraceElement location, Message message, Throwable throwable)
void	logMessage(String fqcn, Level level, Marker marker, Message message, Throwable thrown)
void	translateTo(RingBufferLogEvent event, long sequence, Object... args)
protected void	updateConfiguration(Configuration newConfig) Associates this Logger with a new Configuration.

Methods inherited from class org.apache.logging.log4j.core.Logger

addAppender, addFilter, atLevel, equals, filterCount, get, getAppenders, getContext, getFilters, getLevel, getParent, hashCode, isAdditive, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, removeAppender, requiresLocation, setAdditive, setLevel, toString, writeReplace

Methods inherited from class org.apache.logging.log4j.spi.AbstractLogger

always, atDebug, atError, atFatal, atInfo, atTrace, atWarn, catching, catching, catching, catchingMsg, checkMessageFactory, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, enter, enter, enter, enter, enter, entry, entry, entry, entryMsg, entryMsg, entryMsg, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, error, exit, exit, exit, exit, exitMsg, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, fatal, getFlowMessageFactory, getLogBuilder, getMessageFactory, getName, getRecursionDepth, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, info, isDebugEnabled, isDebugEnabled, isEnabled, isEnabled, isErrorEnabled, isErrorEnabled, isFatalEnabled, isFatalEnabled, isInfoEnabled, isInfoEnabled, isTraceEnabled, isTraceEnabled, isWarnEnabled, isWarnEnabled, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, log, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logIfEnabled, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, logMessage, printf, printf, throwing, throwing, throwing, throwingMsg, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, trace, traceEntry, traceEntry, traceEntry, traceEntry, traceEntry, traceExit, traceExit, traceExit, traceExit, traceExit, traceExit, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn, warn

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

AsyncLogger

public AsyncLogger(LoggerContext context,
                   String name,
                   MessageFactory messageFactory,
                   org.apache.logging.log4j.core.async.AsyncLoggerDisruptor loggerDisruptor)

Constructs an AsyncLogger with the specified context, name and message factory.

Parameters:

context - context of this logger

name - name of this logger

messageFactory - message factory of this logger

loggerDisruptor - helper class that logging can be delegated to. This object owns the Disruptor.

Method Detail

updateConfiguration

protected void updateConfiguration(Configuration newConfig)

Description copied from class: Logger

Associates this Logger with a new Configuration. This method is not exposed through the public API.

There are two ways this could be used to guarantee all threads are aware of changes to config.

1. Synchronize this method. Accessors don't need to be synchronized as Java will treat all variables within a synchronized block as volatile.
2. Declare the variable volatile. Option 2 is used here as the performance cost is very low and it does a better job at documenting how it is used.

Overrides:

updateConfiguration in class Logger

Parameters:

newConfig - The new Configuration.

logMessage

public void logMessage(String fqcn,
                       Level level,
                       Marker marker,
                       Message message,
                       Throwable thrown)

Specified by:

logMessage in interface ExtendedLogger

Overrides:

logMessage in class Logger

log

public void log(Level level,
                Marker marker,
                String fqcn,
                StackTraceElement location,
                Message message,
                Throwable throwable)

Overrides:

log in class Logger

translateTo

public void translateTo(RingBufferLogEvent event,
                        long sequence,
                        Object... args)

Specified by:

translateTo in interface com.lmax.disruptor.EventTranslatorVararg<RingBufferLogEvent>

actualAsyncLog

public void actualAsyncLog(RingBufferLogEvent event)

This method is called by the EventHandler that processes the RingBufferLogEvent in a separate thread. Merges the contents of the configuration map into the contextData, after replacing any variables in the property values with the StrSubstitutor-supplied actual values.

Parameters:

event - the event to log