Ad Hoc Logging at Runtime

For extended error analysis, it is possible to log the output of individual process steps at runtime. This requires neither changing the .wrf file of the related technical process nor restarting the server. In addition, conditional logging in sub-processes is also made possible, e.g. if a sub-process was called by a certain main process.

Configuration

The logging behaviour can be controlled via the tracelog.properties file under X4\Server\X4DB\0. The expected format is also described here, among other things, if a process or process step is to be addressed and logging is to be switched on:

• Log individual process steps: Individual process steps that are to be logged can be specified according to the following scheme: <user>/<process path>/<ActionID> = 1

• Conditional logging of subprocess steps: If single process steps are to be logged in a subprocess that was called by a specific parent process, this can be specified using the following scheme: executor_user>/<process_path_parent>/<user>/<process_path_subprocess>/<ActionID> = 1

The content of the log output corresponds to the content of the logging via Log4J on a transition, i.e. the status or the data of the last process step is logged via Log4J. The Log4J logger used is de.softproject.integration.logging.integrated.TraceLog and the Log4J log level is INFO.

If changes have been made in the tracelog.properties file, the configuration must be read in again. The reading of the configuration can be triggered via the MBean. To do this, execute the MBean operation reloadTraceLogSettings.

Logging individual process steps

Example configuration for logging a specific process step

1/Test/Log/logtest.wrf/2 = 1

Explanation

Logging is enabled for:

• user 1
• Process Test/Log/logtest.wrf
• Process component with Action ID 2

Conditional logging of subprocess steps

Example configuration for conditional logging of a subprocess

1/Test/Log/logtestParent.wrf/1/Test/Log/logtestSub.wrf/2 = 1 

Explanation

Logging is enabled for:

• User 1
• Process Test/Log/logtestSub.wrf
• Process component with Action ID 2

Condition:

• Process Test/Log/logtestParent.wrf was executed by
• user 1