Configuring Admin Server Logging
This file is located in the install_dir\bin directory.
The sections of the properties file are:
- Logger section
Configures the TM1 sub-components and message severity level that you want to log.
Example:
log4j.rootLogger=INFO*, R1
log4j.logger.TM1=INFO
*INFO is the message level.
- Appender section
Example:
Controls the output destination of the logging. The default configuration uses the RollingFileAppender option to write messages to the tm1admsrv.log file.
# R1 is set to be a RollingFileAppender
log4j.appender.R1=org.apache.log4j.RollingFileAppender
log4j.appender.R1.File=tm1admsrv.log*
log4j.appender.R1.MaxFileSize-10 MB
log4j.appender.R1.MaxBackupIndex=2
*tm1admsrv.log is the log file name.
- Pattern Layout section
Controls the output fields and formatting of the messages that are written to the log file. The default settings use a time reference of GMT.
Example:
# R1 uses PatternLayout
log4j.appender.R1.layout=org.apache.log4j.PatternLayout
log4j.appender.R1.layout.ConversionPattern=%t %p %d(%Y-%m-%d %H:%M:%S,%Q) %c %m%n
log4j.appender.R1.layout.TimeZone=GMT
The default logging configuration logs all INFO level messages. You can adjust the logging message level by editing the following two statements in the logging properties file:
log4j.rootLogger=INFO, R1
log4j.logger.TM1=INFO
For example, replace INFO with the DEBUG logging level:
log4j.rootLogger=DEBUG, R1
log4j.logger.TM1=DEBUG