Administering › Logging › Logging Properties File

Logging Properties File

DevTest uses the Apache log4j logging framework. The logging.properties file in the LISA_HOME directory lets you configure the logging behavior.

To get more logging information from DevTest Workstation, you can change the logging level in the log4j.rootCategory file.

log4j.rootCategory=INFO,A1

This file contains a set of loggers for third-party components that are included in DevTest. The default log levels for these loggers are intended to prevent the third-party components from flooding the log files with too many messages. You typically do not need to change the log levels.

log4j.logger.com.teamdev=WARN
log4j.logger.EventLogger=WARN
log4j.logger.org.apache=ERROR
log4j.logger.com.smardec=ERROR
log4j.logger.org.apache.http=ERROR
log4j.logger.org.apache.http.header=ERROR
log4j.logger.org.apache.http.wire=ERROR  
log4j.logger.com.mchange.v2=ERROR
log4j.logger.org.hibernate=WARN
log4j.logger.org.jfree=ERROR
log4j.logger.com.jniwrapper=ERROR
log4j.logger.sun.rmi=INFO

The default appender is com.itko.util.log4j.TimedRollingFileAppender. Log statements for a component are appended to a file that is backed up when it reaches a certain size. The default maximum file size is 10 MB. The default number of backup files is 5.

log4j.appender.A1=com.itko.util.log4j.TimedRollingFileAppender
log4j.appender.A1.File=${lisa.tmpdir}/${LISA_LOG}
log4j.appender.A1.MaxFileSize=10MB
log4j.appender.A1.MaxBackupIndex=5
log4j.appender.A1.layout=org.apache.log4j.EnhancedPatternLayout
log4j.appender.A1.layout.ConversionPattern=%d{ISO8601}{UTC}Z (%d{HH:mm}) [%t] %-5p %-30c - %m%n

The backup files are placed in the same directory as the log file. For example, if the log file for the registry has been backed up three times, the directory contains the following files:

• registry.log
• registry.log.1
• registry.log.2
• registry.log.3

Layouts control the format of log statements. The default layout is org.apache.log4j.EnhancedPatternLayout. The default conversion pattern is %d{ISO8601}{UTC}Z (%d{HH:mm}) [%t] %-5p %-30c - %m%n. This conversion pattern specifies that a log statement includes the date, thread, priority, category, and message. For example:

2014-11-20 14:09:08,152Z (07:09) [main] INFO  com.itko.lisa.net.ActiveMQFactory - Starting amq broker

The date uses Coordinated Universal Time (UTC). This convention makes it easier to follow log events when the registry is running in a different time zone than DevTest Workstation.

For information about the thread dump properties, see Automatic Thread Dumps.