Just a second...

Logging back-end

The work of formatting and writing out messages logged by the Diffusion™ server and publishers running on the Diffusion server is done by the logging back-end. The logging back-end is a logging framework that is independent of the Diffusion server. Diffusion provides a default logging framework, but you can configure the Diffusion server to use other SLF4J implementations.

Default logging framework

The default logging framework provided by Diffusion is configured to log messages out to the console and write them to a file. You can configure the behavior of the default logging framework using the Logs.xml configuration file.

For more information, see Configuring default logging.

Log4j2 logging framework

Diffusion supports log4j2 as an alternative logging implementation. Log4j2 is a third-party SLF4J implementation provided by the Apache Software Foundation. For more information, see http://logging.apache.org/log4j/2.x/.

You can replace the Diffusion default logging with the log4j2 implementation of SLF4J. The log4j2 implementation of SLF4J supports a wide range of appenders and allows fine-grained tuning of logged events.

By default, log4j2 is configured to behave in the same way as the default logging. Change this configuration by editing the provided log4j2.xml configuration file.

For more information, see Configuring log4j2.

Note: Messages logged using the deprecated LogWriter publisher API are passed directly to the default logging framework, not to log4j2. To use log4j2, you must update your publisher to use SLF4J.

Other logging frameworks

Your Diffusion server can be configured to use any logging framework that implements SLF4J. However, only the default and log4j2 frameworks are supported for production use.

For more information, see Logging using another SLF4J implementation.

Note: Messages logged using the deprecated LogWriter publisher API are passed directly to the default logging framework, not to log4j2. To use log4j2, you must update your publisher to use SLF4J.