{"type":"doc","content":[{"type":"paragraph"},{"type":"paragraph","content":[{"type":"mediaInline","attrs":{"width":110,"alt":"MediationZone_text_small .png","id":"903110b6-58d9-4fd2-bd1d-f028ee179220","collection":"contentId-5966350","type":"image","height":20}},{"text":" includes a log4j extension that enables the generation of customized logs from agents configured with APL. This section describes how to configure these logs to meet deployment-specific requirements.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Configuration Files","type":"text"}]},{"type":"paragraph","content":[{"text":"The configuration files are used to specify the path of log files, log filtering rules, log level, and formatting. These files must be stored in ","type":"text"},{"text":"$MZ_HOME/etc/logging","type":"text","marks":[{"type":"code"}]},{"text":" and named ","type":"text"},{"text":"apl-log4j-.properties","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"-apl-log4j-.properties","type":"text","marks":[{"type":"code"}]},{"text":". Use ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" prefixed filenames when you want to use different log settings for different Execution Contexts.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example. Configuration filenames","type":"text"}]},{"type":"paragraph","content":[{"text":"$MZ_HOME/etc/logging/apl-log4j-myloglevel.properties","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"$MZ_HOME/etc/logging/ec1-apl-log4j-myloglevel.properties","type":"text","marks":[{"type":"code"}]}]}]},{"type":"paragraph","content":[{"text":"The following configuration files are included by default:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"apl-log4j-off.properties","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"apl-log4j-fatal.properties","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"apl-log4j-error.properties","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"apl-log4j-warn.properties","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"apl-log4j-info.properties","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"apl-log4j-debug.properties","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"apl-log4j-trace.properties","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"apl-log4j-all.properties","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"The files listed above have a different log level setting but are otherwise identical.","type":"text"}]},{"type":"paragraph","content":[{"text":"The content of the files defines the logging.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example. Configuration file contents","type":"text"}]},{"type":"paragraph","content":[{"text":"log4j.rootLogger=ALL, a","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"log4j.appender.a=com.digitalroute.apl.log.DRRollingFileAppender","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"log4j.appender.a.file=${mz.home}/log/{pico}_{workflow}.log","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"log4j.appender.a.layout=com.digitalroute.apl.log.JsonLayout","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"log4j.appender.a.layout.MdcFieldsToLog=pico, workflow, agent, tag","type":"text","marks":[{"type":"code"}]}]}]},{"type":"paragraph","content":[{"text":"The first line in the example above sets the log level and declares an \"appender\" named '","type":"text"},{"text":"a'","type":"text","marks":[{"type":"code"}]},{"text":". The available log levels are listed below in order of severity, from highest to lowest:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OFF","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FATAL","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ERROR","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"WARN","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"INFO","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DEBUG","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TRACE","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ALL","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"Messages of the same or higher severity than the selected level are logged. For instance, if the configured log level is ","type":"text"},{"text":"WARN","type":"text","marks":[{"type":"code"}]},{"text":", messages with the severity ","type":"text"},{"text":"ERROR","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"FATAL","type":"text","marks":[{"type":"code"}]},{"text":" will be logged as well. The other settings above mean that messages are logged and stored in rotated and JSON formatted files in the ","type":"text"},{"text":"$MZ_HOME/log","type":"text","marks":[{"type":"code"}]},{"text":" directory. 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).","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Appenders","type":"text"}]},{"type":"paragraph","content":[{"text":"There are two different types of appenders; ","type":"text"},{"text":"DRRollingFileAppender","type":"text","marks":[{"type":"code"}]},{"text":" och ","type":"text"},{"text":"DRRollingMultiFileAppender","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"}]},{"type":"paragraph","content":[{"text":"DRRollingFileAppender ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Writes to a single defined file based on the log4j.appender..file property","type":"text"}]},{"type":"paragraph","content":[{"text":"DRRollingMultiFileAppender ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Writes one file for each workflow instance it encounters based on the log4j.appender..file","type":"text"}]},{"type":"paragraph","content":[{"text":"Which workflows are written into which appender is based on the log4j.logger. property.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples Appender Configurations","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":"# Default\nlog4j.appender.Default=com.digitalroute.apl.log.DRRollingFileAppender\nlog4j.appender.Default.file=${mz.home}/log/log4j/{workflow}.log\nlog4j.appender.Default.layout=org.apache.log4j.PatternLayout\nlog4j.appender.Default.layout.ConversionPattern=[%d{dd MMM yyyy HH:mm:ss,SSS}];[%-5p];[pico=%X{pico}];[%t];[tag=%X{tag}];[%c]:%m%n\nlog4j.appender.Default.MaxFileSize=10MB\nlog4j.appender.Default.MaxBackupIndex=20\nlog4j.logger.Default=TRACE, Default","type":"text"}]},{"type":"paragraph","content":[{"text":"The appender named Default will write a single file for all workflows contained under the Default folder.","type":"text"}]},{"type":"codeBlock","content":[{"text":"# PRIMARY\nlog4j.appender.PRIMARY=com.digitalroute.apl.log.DRRollingMultiFileAppender\nlog4j.appender.PRIMARY.file=${mz.home}/log/log4j/{workflow}.log\nlog4j.appender.PRIMARY.layout=org.apache.log4j.PatternLayout\nlog4j.appender.PRIMARY.layout.ConversionPattern=[%d{dd MMM yyyy HH:mm:ss,SSS}];[%-5p];[pico=%X{pico}];[%t];[tag=%X{tag}];[%c]:%m%n\nlog4j.appender.PRIMARY.MaxFileSize=10MB\nlog4j.appender.PRIMARY.MaxBackupIndex=20\nlog4j.logger.RT_Folder.RT_TEST_WF=TRACE, PRIMARY","type":"text"}]},{"type":"paragraph","content":[{"text":"The appender named Primary will create multiple files; one for each workflow instance based on the RT_Folder.RT_TEST_WF workflow.","type":"text"}]},{"type":"codeBlock","content":[{"text":"# SECONDARY\nlog4j.appender.SECONDARY=com.digitalroute.apl.log.DRRollingFileAppender\nlog4j.appender.SECONDARY.file=${mz.home}/log/log4j/{workflow}.log\nlog4j.appender.SECONDARY.layout=org.apache.log4j.PatternLayout\nlog4j.appender.SECONDARY.layout.ConversionPattern=[%d{dd MMM yyyy HH:mm:ss,SSS}];[%-5p];[pico=%X{pico}];[%t];[tag=%X{tag}];[%c]:%m%n\nlog4j.appender.SECONDARY.MaxFileSize=10MB\nlog4j.appender.SECONDARY.MaxBackupIndex=20\nlog4j.logger.RT_Folder.RT_TEST_WF=TRACE, SECONDARY","type":"text"}]},{"type":"paragraph","content":[{"text":"The appender Secondary will create a single file for each workflow instance based on the RT_Folder.RT_TEST_WF workflow. The file will take the name of the first workflow instance it encounters, for example \"RT_Folder.RT_TEST_WF.workflow_1\" ","type":"text"}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Hint!","type":"text"}]},{"type":"paragraph","content":[{"text":"You can change the maximum file size and the number of backup files by adding the following lines:","type":"text"},{"type":"hardBreak"},{"text":"log4j.appender.a.MaxFileSize=100MB","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.appender.a.MaxBackupIndex=10","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"You can add a filtering rule by adding the line ","type":"text"},{"text":"log4j.logger.=","type":"text","marks":[{"type":"code"}]},{"text":". This is useful when you want to set different log levels for specific folders or configurations.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"Example. Sets the general log level to ERROR and to DEBUG for the agent named agent_1

log4j.rootLogger=ERROR, a
log4j.appender.a=com.digitalroute.apl.log.DRRollingFileAppender
log4j.appender.a.file=${mz.home}/log/{pico}_{workflow}.log
log4j.appender.a.layout=com.digitalroute.apl.log.JsonLayout
log4j.logger.Default.debug.workflow_1.agent_1=DEBUG

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example. Sets the general log level to ERROR and to DEBUG for the agent named agent_1","type":"text"}]},{"type":"paragraph","content":[{"text":"log4j.rootLogger=ERROR, a ","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.appender.a=com.digitalroute.apl.log.DRRollingFileAppender","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.appender.a.file=${mz.home}/log/{pico}_{workflow}.log","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.appender.a.layout=com.digitalroute.apl.log.JsonLayout","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.logger.Default.debug.workflow_1.agent_1=DEBUG","type":"text","marks":[{"type":"code"}]}]}]}],"version":1}}}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"If you want to apply the filtering rule to all APL configurations in the default folder, change the last line in the previous example to ","type":"text"},{"text":"log4j.logger.Default=DEBUG","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note!","type":"text"}]},{"type":"paragraph","content":[{"text":"For performance reasons it is recommended to use the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"DRRollingFileAppender","type":"text","marks":[{"type":"code"}]},{"text":" and configure individual appenders for each workflow. Only use the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"DRRollingMultiFileAppender","type":"text","marks":[{"type":"code"}]},{"text":" if you need individual files on a workflow instance level.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"For more information about available settings, see the log4j documentation at ","type":"text"},{"text":"https://logging.apache.org/log4j/1.2/manual.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://logging.apache.org/log4j/1.2/manual.html"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"mzsh Command","type":"text"}]},{"type":"paragraph","content":[{"text":"You can select the active logging configuration for each Execution Context by using the mzsh command ","type":"text"},{"text":"loglevel","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"usage: ","type":"text"},{"text":"apl-loglevel [ display | set ] ","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"The ","type":"text"},{"text":"level","type":"text","marks":[{"type":"code"}]},{"text":" argument to the command is based on the corresponding configuration filename in ","type":"text"},{"text":"$MZ_HOME/etc/logging","type":"text","marks":[{"type":"code"}]},{"text":". For instance, the command below will activate the configuration in ","type":"text"},{"text":"ec1-apl-log4j-myloglevel.properties","type":"text","marks":[{"type":"code"}]},{"text":" on the Execution Context named ec1 and ","type":"text"},{"text":"ec2-apl-log4j-myloglevel.properties","type":"text","marks":[{"type":"code"}]},{"text":" on ec2. If any of these files cannot be found, the command will (if possible) apply the settings of a file without the Execution Context prefix, i e ","type":"text"},{"text":"apl-log4j-myloglevel.properties","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example. Selecting and applying a configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"$ mzsh mzadmin/ apl-loglevel set myloglevel ec1 ec2","type":"text","marks":[{"type":"code"}]}]}]},{"type":"paragraph","content":[{"text":"You can view the configured log directory and refresh interval with ","type":"text"},{"text":"apl-loglevel display","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example. Display settings","type":"text"}]},{"type":"paragraph","content":[{"text":"$ mzsh mzadmin/ apl-loglevel display ec1 ec2","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"logdir = /opt/mz/etc/logging","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"refresh interval = 1000 ms","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"---------------------------------------------","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"Contents of: /opt/mz/etc/logging/ec1-apl-log4j.properties","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"---------------------------------------------","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.rootLogger=ALL, a","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"log4j.appender.a=com.digitalroute.apl.log.DRRollingFileAppender","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.appender.a.file=${mz.home}/log/{pico}_{workflow}.log","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.appender.a.layout=com.digitalroute.apl.log.JsonLayout","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.appender.a.layout.MdcFieldsToLog=pico, workflow, agent, ","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"tag","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"---------------------------------------------","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"---------------------------------------------","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"Contents of: /opt/mz/etc/logging/ec2-apl-log4j.properties","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"---------------------------------------------","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.rootLogger=ALL, a","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"log4j.appender.a=com.digitalroute.apl.log.DRRollingFileAppender","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.appender.a.file=${mz.home}/log/{pico}_{workflow}.log","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.appender.a.layout=com.digitalroute.apl.log.JsonLayout","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"log4j.appender.a.layout.MdcFieldsToLog=pico, workflow, agent, ","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"tag","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"---------------------------------------------","type":"text","marks":[{"type":"code"}]}]}]},{"type":"paragraph","content":[{"text":"The log refresh interval is set to 1000 ms by default. You can change this value by setting the Platform property ","type":"text"},{"text":"mz.logging.refreshinterval","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"When you activate a configuration the contents of the corresponding file is copied to <","type":"text"},{"text":"ec name>-apl-log4j.properties","type":"text","marks":[{"type":"code"}]},{"text":". Any changes in this file will become effective at the next refresh interval.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"APL Commands","type":"text"}]},{"type":"paragraph","content":[{"text":"The following functions are used to trigger logging within any of the function blocks in APL:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"void log.fatal(any, any)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"void log.error(any, any)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"void log.warn(any, any)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"void log.info(any, any)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"void log.debug(any, any)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"void log.trace(any, any)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"For more information about these functions, see ","type":"text"},{"text":"23. Log and Notification Functions","type":"text","marks":[{"type":"link","attrs":{"href":"https://infozone.atlassian.net/wiki/spaces/MD83/pages/5967140"}}]},{"text":" in the ","type":"text"},{"text":"APL Reference Guide","type":"text","marks":[{"type":"link","attrs":{"href":"https://infozone.atlassian.net/wiki/spaces/MD83/pages/5967124"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Log Output","type":"text"}]},{"type":"paragraph","content":[{"text":"The output log files are stored in the directory specified in the active logging configuration.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Example. Log file in JSON format","type":"text"}]},{"type":"paragraph","content":[{"text":"{\"timestamp\":\"2015-12-20:22:44:10 UTC\",\"level\":\"DEBUG\",\"thread\":\"Default.logtestwf.workflow_1: TCP_IP_1_1\",\"category\":\"Default.logtestwf.workflow_1.Analysis_1\",\"message\":\"In consume\",\"pico\":\"EC1\",\"workflow\":\"Default.logtestwf.workflow_1\",\"agent\":\"Analysis_1\"}","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The fields in the log output are described below.","type":"text"}]},{"type":"table","attrs":{"layout":"align-start","width":1044.0,"localId":"1dddd133-fdd7-4a46-bd3b-2aa75b262e51"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[147.0]},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[897.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[147.0]},"content":[{"type":"paragraph","content":[{"text":"timestamp","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[897.0]},"content":[{"type":"paragraph","content":[{"text":"The time when the message was logged. The UTC timezone and international standard date and time notation is used by default. ","type":"text"},{"type":"hardBreak"},{"text":"You can specify the date format by adding the following line in the configuration file:","type":"text"}]},{"type":"paragraph","content":[{"text":"log4j.appender.a.layout.DateFormat=","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"For information about how to use SimpleDateFormat patterns, see:","type":"text"},{"type":"hardBreak"},{"text":"https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[147.0]},"content":[{"type":"paragraph","content":[{"text":"level","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[897.0]},"content":[{"type":"paragraph","content":[{"text":"The log level i e ","type":"text"},{"text":"FATAL","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"ERROR","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"WARN","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"INFO","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"DEBUG","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"TRACE","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[147.0]},"content":[{"type":"paragraph","content":[{"text":"thread","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[897.0]},"content":[{"type":"paragraph","content":[{"text":"The name of the workflow thread.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[147.0]},"content":[{"type":"paragraph","content":[{"text":"category","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[897.0]},"content":[{"type":"paragraph","content":[{"text":"The logged configuration. This field contains the ","type":"text"},{"text":"category","type":"text","marks":[{"type":"code"}]},{"text":" class of the appender that is defined in the configuration file.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[147.0]},"content":[{"type":"paragraph","content":[{"text":"message","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[897.0]},"content":[{"type":"paragraph","content":[{"text":"The log message specified in the APL command.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[147.0]},"content":[{"type":"paragraph","content":[{"text":"pico","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[897.0]},"content":[{"type":"paragraph","content":[{"text":"The name of the Execution Context.","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Warning!","type":"text"}]},{"type":"paragraph","content":[{"text":"The ECs must be restarted if you manually delete or rename active log files or backup log files.","type":"text"}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Hint!","type":"text"}]},{"type":"paragraph","content":[{"text":" If the log files are not generated as expected, review the EC logs. Your configuration files may contain errors.","type":"text"}]}]},{"type":"paragraph"},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"scroll-ignore","parameters":{"macroParams":{"scroll-viewport":{"value":"false"},"scroll-pdf":{"value":"true"},"scroll-office":{"value":"false"},"scroll-chm":{"value":"true"},"scroll-docbook":{"value":"true"},"scroll-eclipsehelp":{"value":"true"},"scroll-epub":{"value":"true"},"scroll-html":{"value":"false"}},"macroMetadata":{"macroId":{"value":"3b29ad90-5e85-474b-be4d-600584757e91"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://scroll-exporter-extensions.us.exporter.k15t.app/static/assets/images/macro-icons/scroll-ignore.svg"}}],"title":"Scroll Ignore"}},"localId":"b5ee82d9-0ebd-4e9f-a8e9-3c388785ad5e"},"content":[{"type":"paragraph"},{"type":"table","attrs":{"layout":"default","localId":"e49e49f6-0ca3-4411-b0b3-9044237f1f03"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Next:","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"11. Couchbase","type":"text","marks":[{"type":"link","attrs":{"href":"https://infozone.atlassian.net/wiki/spaces/MD83/pages/5966352"}}]}]}]}]}]},{"type":"paragraph"}]},{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"scroll-pagebreak","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"38c3d168-12ab-4472-ad4b-30bf673fe23b"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://scroll-exporter-extensions.us.exporter.k15t.app/static/assets/images/macro-icons/scroll-pagebreak.svg"}}],"title":"Scroll Pagebreak"}},"localId":"d802b01a-c5ae-4147-ba81-fe0e9d8893c6"}}],"version":1}

Browser not supported