Please enable JavaScript to view this site.

Administration manual

Navigation: Tech Doc > Problem analysis and troubleshooting > Logging > Log in the JobRouter web application

Configuration

Scroll Prev Top Next More

For targeted problem analysis, access to messages with less importance might possibly be needed. Especially searches for the cause of performance problems or otherwise unexplainable behavior might make a temporary change of the log level configuration sensible and useful.

To define the minimum importance required for messages to be logged, the constant CONST_LOG_LEVEL_FILE has to be added to the config.php file and set to the respective value.

Possible values:

FATAL: Critical error (Program termination)

ERROR: Error (Exception caught, processing was handled differently)

WARNING: Unexpected situation occurred (default value)

INFO: General information (Program execution)

DEBUG: Detailed information (Locating errors)

For example, if you define the value INFO as log level, all messages with an importance from INFO to FATAL will be logged.

Attention: Please note, reducing the minimum importance of messages you want to log can lead to a significant amount of data (under circumstances multiple hundreds of MB per hour) written into the log files over a short amount of time. Please ensure that enough free storage space is available for the output directory and after logging all necessary messages, remove the constant CONST_LOG_LEVEL_FILE from the config.php file again or set its value back to the default value WARNING.

By setting the constant CONST_LOGGING_DISABLED to true, logging can also be deactivated.

Process Instance data

The logging output of ongoing instances (e.g. step and process table actions) is recorded in one file per instance (<processname>_<processid>_<date>.log). This way, instance-related actions can be tracked more easily. If you want to record the logging output in files separated per object type instead (e.g. step, incident), you can disable the instance-related logging with the following entry in the configuration file:

<?php

 

// some constants ...

 

return [

    'db' => [

        // database connection data

    ],

    // deactivate logging in separate files for process instance data

    'log' => [

        'separateLogPerProcessInstance' => false,

    ],

];