Expand Collapse
Just a second...

Configuring log4j2

To use log4j2, replace the default logging JAR file with the log4j2 JAR file. Use the log4j2.xml configuration file to configure the behavior of log4j2.

To use log4j2 instead of the standard Diffusion logging implementation, copy lib/thirdparty/log4j-slf4j-impl-*.jar to lib/slf4j-binding.jar. This file controls the log4j2 logging. The Diffusion logging configuration in etc/Logs.xml will be ignored.

To revert to the standard Diffusion logging implementation, copy lib/diffusion-slf4j-binding.jar to lib/slf4j-binding.jar.

When the Diffusion™ server is configured to use the log4j2 logging framework, the Diffusion server ignores the configuration in the Logs.xml file. Instead, it uses the log4j2.xml configuration file.

The log4j2.xml configuration file is located in the etc directory of your Diffusion installation. For more information about how to use this file to configure log4j2, see the log4j2 documentation: http://logging.apache.org/log4j/2.x/manual/configuration.html

By default, the provided log4j2.xml file is configured to output log messages in the same format as used by the default logging framework. In your configuration file, create a property that defines the format to output log messages in: 
<Property name="pattern">%date{yyyy-MM-dd HH:mm:ss.SSS}|%level|%thread|%marker|%replace{%msg}{\|}{}|%logger%n%xEx</Property>
You can use this property to specify the format used by your appenders. The property %marker indicates the message code. For more information, see Logging reference.
By default, the provided log4j2.xml file is configured to append log output to the console and to a file. This is the same behavior as the default logging framework. 
<Loggers>
        <AsyncRoot level="info" includeLocation="false">
            <AppenderRef ref="console" />
            <AppenderRef ref="file" />
        </AsyncRoot>
    </Loggers>
You can configure other appenders to output to the log messages to different destinations. For more information about using appenders, see https://logging.apache.org/log4j/2.x/manual/appenders.html.

This page last modified: 2015/10/16