Configuration properties

If false, Log4j will make sure the message is formatted in the caller thread, otherwise the formatting will occur on the asynchronous thread.

Remark: messages annotated with AsynchronouslyFormattable will be formatted on the async thread regardless of this setting.

Determines the AsyncQueueFullPolicy to use when the underlying async component cannot keep up with the logging rate and the queue is filling up.

Its value should be the fully qualified class name of an AsyncQueueFullPolicy implementation or one of these predefined constants:

Determines the threshold level used by a Discard queue full policy. Log events whose level is not more severe than the threshold level will be discarded during a queue full event. See also log4j.async.queueFullPolicy.type.

Specifies the fully qualified class name of the ContextSelector implementation to use.

A ContextSelector decides:

The implementations available by default are:

If true a shutdown hook will be installed to stop the logger context when the system stops.

The fully qualified class name of a ShutdownCallbackRegistry implementation. Integrators can use this to customize the shutdown order of the JVM.

The default implementation executes all shutdown actions in a separate Thread registered through Runtime#addShutdownHook().

Prints a stacktrace to the status logger at DEBUG level when the LoggerContext is started.

For debug purposes only.

Specifies the fully qualified class name of the preferred ConfigurationFactory to use.

Log4j will attempt to use the provided configuration factory before any other factory implementation.

Specifies a comma-separated list of URIs or file paths to Log4j 2 configuration files.

If a relative URL is provided, it is interpreted as:

Usage of absolute URLs is restricted by the Transport Security configuration options.

See also Automatic Configuration.

Specifies the level of the root logger if:

Specifies the fully qualified class name of the MergeStrategy implementation used to merge multiple configuration files into one.

Fully qualified class name of a MessageFactory implementation that will be used by loggers if no explicit factory was specified.

Fully qualified class name of a StringMap implementation to use to store context data in log events. The implementation must have:

Fully qualified class name of a ContextDataInjector implementation.

The default implementation uses all implementations of ContextDataProvider registered with ServiceLoader.

Specifies the LogEventFactory implementation to use to create log events.

If true, garbage-aware layouts will directly encode log events into ByteBuffers provided by appenders.

This prevents allocating temporary String and char[] instances.

The size in bytes of the ByteBuffers stored in ThreadLocal fields by layouts and StringBuilderEncoders.

This setting is only used if log4j.gc.enableDirectEncoders is set to true.

The size in chars of the ByteBuffers stored in ThreadLocal fields StringBuilderEncoders.

This setting is only used if log4j.gc.enableDirectEncoders is set to true.

In GC-free mode, this property determines the initial size of the reusable StringBuilders used by ReusableMessages for formatting purposes.

In GC-free mode, this property determines the maximum size of the reusable StringBuilders used by ReusableMessages for formatting purposes.

The default value allows is equal to 2 × (2 × log4j.initialReusableMsgSize + 2) + 2 and allows the StringBuilder to be resized twice by the current JVM resize algorithm.

This property determines the maximum size of the reusable StringBuilders used to format LogEvents.

The Unbox utility class can be used by users to format primitive values without incurring in the boxing allocation cost.

This property specifies the maximum number of primitive arguments to a log message that will be cached and usually does not need to be changed.

Denotes the buffer capacity for a recycler. For a queueing recycler, it corresponds to the queue size. For a thread local recycler, it corresponds to the per-thread buffer size.

If an invalid capacity is provided (i.e., if the capacity is zero or negative), the default value will be used.

If provided, available recycler factory providers will be sorted in order, and the first one whose name matching with this property value will be used.

If missing or the selection fails, the default will be used.

Denotes the strategy adopted by the Conversant Disruptor, when the queue is fully used. This configuration property is only used if the conversant-disrutor recycler is used.

See Conversant Disruptor Javadoc for details.

If false, the ThreadContext stack and map are disabled.

If false, the ThreadContext stack is disabled.

If false, the ThreadContext map is disabled.

Fully specified class name of a custom ThreadContextMap implementation class or one of the predefined constants:

If set to true selects a garbage-free thread context map implementation.

The fully qualified class name of the AuthorizationProvider implementation to use with http and https URL protocols.

The password to use in HTTP Basic authentication.

If used in conjunction with log4j.auth.basic.passwordDecryptor the contents of this variable are interpreted by the decryptor.

Fully qualified class name of an implementation of PasswordDecryptor to use for the value of the log4j.auth.basic.password property.

If null, the literal value of the password is used.

The username used in HTTP Basic authentication.

A comma separated list of URL protocols that may be used to load any kind of configuration source.

To completely prevent accessing the configuration via the Java URL class specify a value of _none.

The location of the trust store.

The password for the trust store.

The name of a file that contains the password for the trust store.

The name of the environment variable that contains password for the trust store.

The type of trust store.

Name of the KeyManagerFactory implementation to use for the trust store.

If true enables verification of the name of the TLS server.

The location of the private key store.

The password for the private key store.

The name of a file that contains the password for the private key store.

The name of the environment variable that contains the password for the private key store.

The type of private key store. KeyStore.

Name of the KeyManagerFactory implementation to use for the private key store. See KeyManagerFactory types.

Specifies the Clock implementation used to timestamp log events.

This must be the fully qualified class name of the implementation or one of these predefined constants:

If set to true the SystemClock will use the best precision provided by the system. Otherwise, it will truncate the timestamp up to the milliseconds.

See also log4j.configuration.clock.

If true, classes are only loaded using the same classloader that loaded Log4j.

Otherwise, an attempt is made to load classes with the current thread’s context class loader before falling back to the default class loader.

Specifies the ReliabilityStrategy to adopt in order to prevent loss of log events during a reconfiguration.

The value must be the fully qualified class name of a ReliabilityStrategy implementation or one of these predefined constants:

Number of milliseconds to wait before stopping the old configuration if the AwaitUnconditionally reliability strategy is used. See log4j.configuration.reliabilityStrategy.

Provides a long see to the UUID generator used by the %uuid pattern converter.

Can be used to assure uniqueness of UUIDs generated by multiple JVMs on the same machine.

Fully qualified name of a class that implements the AsyncLoggerConfigExceptionHandler interface, which will be notified when an exception occurs while logging messages. The class needs to have a public zero-argument constructor.

The default exception handler will print a message and stack trace to the standard error output stream.

Fully qualified name of a class that implements the AsyncLoggerExceptionHandler interface, which will be notified when an exception occurs while logging messages. The class needs to have a public zero-argument constructor.

The default exception handler will print a message and stack trace to the standard error output stream.

Synchronizes access to the LMAX Disruptor ring buffer for blocking enqueue operations when the queue is full. Users encountered excessive CPU utilization with LMAX Disruptor v3.4.2 when the application was logging more than the underlying appender could keep up with and the ring buffer became full, especially when the number of application threads vastly outnumbered the number of cores. CPU utilization is significantly reduced by restricting access to the enqueue operation. Setting this value to false may lead to very high CPU utilization when the async logging queue is full.

Size (number of slots) in the RingBuffer used by the asynchronous logging subsystem. Make this value large enough to deal with bursts of activity. The minimum size is 128. The RingBuffer will be pre-allocated at first use and will never grow or shrink during the life of the system.

When the application is logging faster than the underlying appender can keep up with for a long enough time to fill up the queue, the behaviour is determined by the AsyncQueueFullPolicy.

Specifies the WaitStrategy used by the LMAX Disruptor.

The value needs to be one of the predefined constants:

Total number of spin cycles and Thread.yield() cycles of Sleep (see log4j.async.logger.waitStrategy.type).

Sleep time in nanoseconds of Sleep wait strategy (see log4j.async.logger.waitStrategy.type).

Timeout in milliseconds of Timeout wait strategy (see log4j.async.logger.waitStrategy.type).

When true the JndiContextSelector is enabled for the java: protocol. See Web application for more details.

When true, a Log4j JDBC Appender can use JNDI to retrieve a DataSource using the java: protocol.

When true, a Log4j JMS Appender can use JNDI to retrieve the necessary components using the java: protocol.

When true, the Log4j JNDI Lookup can use the java: protocol.

Fully qualified name of an alternative org.apache.logging.jul.tolog4j.spi.LevelConverter implementation.

Fully qualified class name of a custom org.apache.logging.jul.tolog4j.spi.AbstractLoggerAdapter implementation to use, which provides an implementation of the j.u.l.Logger mutator methods (e.g., Logger.setLevel()).

By default org.apache.logging.jul.tolog4j.internal.ApiLoggerAdapter is used and the mutator methods are disabled.

The list of script languages that are allowed to execute.

The names specified must correspond to those returned by ScriptEngineFactory.getNames().