Configure logs at a system level

Contrast collects multiple log files that log events and messages.

You can configure the log4j2.xml file used to host the Log4j configuration that is packaged in the Contrast application (and optionally apply Log4j custom levels).


Contact Support before making any changes to this file to ensure the formatting is syntactically correct. A server restart is not required if the changes are entered correctly.

  1. Find the file under $CONTRAST_HOME/data/conf.

  2. The first parameter of the file below is a monitor interval that refreshes the settings based on the variable defined. By default, Contrast checks every 60 seconds and refreshes the logging configuration.

    <Configuration monitorInterval="60">
  3. Edit the file as needed.


    Read more about appenders and delivering LogEvents in the Log4j documentation. Contrast predominantly makes use of the Rolling File Appender, which is an OutputStreamAppender that writes to the file named in the fileName parameter, and rolls the file over according to the TriggeringPolicy and the RolloverPolicy.

    Here is a sample file of the appenders for contrast.log. It shows a daily appender with a 1GB max file size policy and no more than 15 files of rollover. This appender also compresses the file and renames it daily.

    <RollingFile name="DAILY" fileName="${contrast.logs.dir}/logs/contrast.log"
                filePattern="${contrast.logs.dir}/logs/contrast.%d.%i.log.gz" immediateFlush="true">
            <Pattern>%d{ddMMyy,SSS} {%X{}} {%X{}} {%X{remote.addr}} %-5p (%F:%L) %m%n
            <SizeBasedTriggeringPolicy size="1 GB"/>
        <DefaultRolloverStrategy max="15"/>

    The logger section of the file defines which Java packages should log to a specific Appender and at a given log level.