Externalising Logger Properties

This section explains you how to avail the option of externalising log file configuration and log level in the Transact Explorer (tb-server) API framework.

You can specify an external configuration file through -Dlog4j2.configurationFile=<location> to override the settings in log4j2.properties in the war files. You can also externalize the log level through -Dcom.temenos.te.api.logLevel=<log level>. The hierarchy from low to high is: DEBUG, INFO, WARN, ERROR. When a log level is specified, only messages at that level or higher are logged, whereas the lower-level messages are ignored.

If log level is not set, the system takes ERROR as default value.

The logger property file based on the current configuration is given below as an example.

################################################################################
#
# Log file configuration
#
# This file should be in classpath to be picked up automatically
#
# TEMENOS (c) 2020
#
#
# This file contains configuration parameters for the log4j logging.
#
# Log Level = DEBUG, INFO, WARN, ERROR
#
################################################################################

property.defaultLogDirectory=target/logs
#Change the logger directory as required
property.logger.dir=${env:LOG_HOME}
property.logger.dir.archive=${env:LOG_HOME}/archived
property.defaultPattern=%d{yyy-MM-dd HH:mm:ss.SSS} %-5p [%t] [%c{1}] %m%n
property.defaultRolloverIntervalDays=1
property.defaultMaxFileSize= 5MB
property.defaultMinBackupIndex = 1
property.defaultMaxBackupIndex = 5
property.logLevel = ${sys:com.temenos.te.api.logLevel:-ERROR}

# default logging in Browser
################################################################################
# default logging is to the console, for output to the file comment following
# lines and uncomment the subsequent line
rootLogger.level = ${logLevel}

loggers=TBLOGGER

logger.TBLOGGER.name=DIAGNOSTIC.TBSERVER
logger.TBLOGGER.level=${logLevel}
logger.TBLOGGER.additivity=false
logger.TBLOGGER.appenderRefs=logFile
logger.TBLOGGER.appenderRef.file.ref=logFile

# Appenders
appenders=console,logFile

appender.console.type=console
appender.console.name=console
appender.console.layout.type=PatternLayout
appender.console.layout.pattern=${defaultPattern}

appender.logFile.type=RollingRandomAccessFile
appender.logFile.name=logFile
appender.logFile.fileName=${logger.dir}/tbserver.log
appender.logFile.filePattern=${logger.dir}/tbserver.log-%d{dd-MMM-yyyy@HH.mm.ss}
appender.logFile.layout.type=PatternLayout
appender.logFile.layout.pattern=${defaultPattern}
appender.logFile.policies.type = Policies
appender.logFile.policies.size.type = SizeBasedTriggeringPolicy
appender.logFile.policies.size.size=${defaultMaxFileSize}
appender.logFile.strategy.type = DefaultRolloverStrategy
appender.logFile.strategy.min = ${defaultMinBackupIndex}
appender.logFile.strategy.max = ${defaultMaxBackupIndex}