...

To provide some examples and templates, there are a number of pre-existing files with the name apl-log4j-<log level name>.properties, for example apl-log4j-trace.properties, which you can use to either copy properties from, or make a copy of the whole file and rename it to <ec-name>-apl-log4j.properties. 

The following template configuration files are included by default:

• apl-log4j-off.properties

• apl-log4j-fatal.properties

• apl-log4j-error.properties

• apl-log4j-warn.properties

• apl-log4j-info.properties

• apl-log4j-debug.properties

• apl-log4j-trace.properties

• apl-log4j-all.properties

The files listed above have a different log level setting but are otherwise identical.

The content of the files defines the logging.

The first line in the example above sets the log level and declares an "appender" named 'a'. The available log levels are listed below in order of severity, from highest to lowest:

• OFF

• FATAL

• ERROR

• WARN

• INFO

• DEBUG

• TRACE

• ALL

Messages of the same or higher severity than the selected level are logged. For instance, if the configured log level is WARN, messages with the severity ERROR and FATAL will be logged as well. The other settings above mean that messages are logged in files that are started, stopped and stored in JSON formatted files in the $MZ_HOME/log directory in regular intervals. When an active log file has reached its maximum size, it is backed up and stored with a number suffix. A new active log file is then created. The default maximum size is 10 MB, and the default number of backup files is one (1).

...

Which workflows are written into which appender is based on the log4j.logger.<class name> property.

# Default
log4j.appender.Default=com.digitalroute.apl.log.DRRollingFileAppender
log4j.appender.Default.file=${mz.home}/log/log4j/{workflow}.log
log4j.appender.Default.layout=org.apache.log4j.PatternLayout
log4j.appender.Default.layout.ConversionPattern=[%d{dd MMM yyyy HH:mm:ss,SSS}];[%-5p];[pico=%X{pico}];[%t];[tag=%X{tag}];[%c]:%m%n
log4j.appender.Default.MaxFileSize=10MB
log4j.appender.Default.MaxBackupIndex=20
log4j.logger.aplLogger.Default=TRACE, Default

# PRIMARY
log4j.appender.PRIMARY=com.digitalroute.apl.log.DRRollingMultiFileAppender
log4j.appender.PRIMARY.file=${mz.home}/log/log4j/{workflow}.log
log4j.appender.PRIMARY.layout=org.apache.log4j.PatternLayout
log4j.appender.PRIMARY.layout.ConversionPattern=[%d{dd MMM yyyy HH:mm:ss,SSS}];[%-5p];[pico=%X{pico}];[%t];[tag=%X{tag}];[%c]:%m%n
log4j.appender.PRIMARY.MaxFileSize=10MB
log4j.appender.PRIMARY.MaxBackupIndex=20
log4j.logger.aplLogger.RT_Folder.RT_TEST_WF=TRACE, PRIMARY

# SECONDARY
log4j.appender.SECONDARY=com.digitalroute.apl.log.DRRollingFileAppender
log4j.appender.SECONDARY.file=${mz.home}/log/log4j/{workflow}.log
log4j.appender.SECONDARY.layout=org.apache.log4j.PatternLayout
log4j.appender.SECONDARY.layout.ConversionPattern=[%d{dd MMM yyyy HH:mm:ss,SSS}];[%-5p];[pico=%X{pico}];[%t];[tag=%X{tag}];[%c]:%m%n
log4j.appender.SECONDARY.MaxFileSize=10MB
log4j.appender.SECONDARY.MaxBackupIndex=20
log4j.logger.aplLogger.RT_Folder.RT_TEST_WF=TRACE, SECONDARY

...

The following functions are used to trigger logging within any of the function blocks in APL:

• void log.fatal(any, any)

• void log.error(any, any)

• void log.warn(any, any)

• void log.info(any, any)

• void log.debug(any, any)

• void log.trace(any, any)

For more information about these functions, see Log and Notification Functions in the APL Reference Guide.

Log Output

The output log files are stored in the directory specified in the active logging configuration.

The fields in the log output are described below.