Log4j properties files

This is a list of properties that you can modify in the impactserver.log4j.properties and impactgui.log4j.properties properties files to change the default logging behavior.

Note:

To change the file permissions size of the Impact server and GUI log files, set these properties in the both the $IMPACT_HOME/etc/impactgui.log4j.properties and $IMPACT_HOME/etc/impactserver.log4j.properties files:

appender.rolling.filePermissions=
appender.rollingerror.filePermissions=

Where <file permission string> is a 9 character POSIX compatible string (for example: "rwxrw-r--") as per https://docs.oracle.com/javase/8/docs/api/java/nio/file/attribute/PosixFilePermissions.html.

The first 3 characters represent the read (r), write (w), and execute (x) permission for the file owner.

The next 3 characters represent the read (r), write (w), and execute (x) permission for the file owner's group.

The last 3 characters represent the read (r), write (w), and execute (x) permission for everyone.

For example, to set log file permissions, use:

appender.rolling.filePermissions=rw-rw-rw-
appender.rollingerror.filePermissions=rw-rw-rw-
Table 1. Log4j properties

Property

Description

property.filepath

Specifies the path to the log file. Default is $IMPACT_HOME/logs/

property.filename

Specifies the filename of the log file. Default is impactserver for Impact server, and impactgui for Impact GUI server (namely, the filename without the .log suffix).

filter.threshold.level

Specifies the log level filter. All messages up to this severity level will be filtered for logging. Default value is TRACE, meaning severity of all levels up to and including level TRACE.

appender.rolling.fileName

Specifies the path and filename of the log file, using the filepath and filename properties above. Default is $IMPACT_HOME/logs/impactserver.log for Impact server, and $IMPACT_HOME/logs/impactgui.log for Impact GUI serve

appender.rolling.layout.pattern

Specifies the pattern in the logging. Default is Date Time, log level, class name, followed by the log message.

appender.rolling.policies.size.size

Specifies the maximum size of log files. Default is 10MB.

appender.rolling.strategy.max

Specifies the maximum number of backup files. Default is 3.

appender.rollingerror.fileName

Specifies the path and filename of the error log file, using the filepath and filename properties above. Default is $IMPACT_HOME/logs/impactserver-errors.log for Impact server, and $IMPACT_HOME/logs/impactgui-errors.log for Impact GUI server.

appender.rollingerror.layout.pattern

Specifies the pattern in the logging. Default is Date Time, log level, class name, and follow by the log message.

appender.rollingerror.policies.size.size

Specifies the maximum size of error log files. Default is 10MB.

appender.rollingerror.strategy.max

Specifies the maximum number of backup files. Default is 3.

appender.rollingerror.filter.threshold.level

Specifies the log level. Default is ERROR. (This should not be modified as the error log file is dedicated for ERROR logs only.)

logger.rolling.level

Specifies the log level for the impactserver log. Default is INFO.

logger.rollingerror.level

Specifies the log level for the impactserver error log. Default is ERROR.

rootLogger.level

This is the default root logging level. Default is INFO.