Skip to content

Configuring Server Diagnostics

This section describes the various information that you can collect by logging.

The file log4j.properties is the logging configuration file of the Business Bot Platform, where the properties are stored in key-value pairs. By default, the platform expects the logging file to be located in the directory <Tomcat>/webapps/bbp/WEB-INF/classes/log4j.properties.

At runtime, the logging level can be activated to get additional messages for troubleshooting. Levels can be assigned to the logger. Possible levels are: TRACE, DEBUG, INFO, WARN, ERROR and FATAL. Change the logger level to obtain the desired log information.

In general, the levels should be used for the following messages:

Level Description
TRACE All messages necessary for tracing
DEBUG All messages necessary for debugging
INFO Messages similar to the Verbose mode
WARN Messages (errors) that are logged, but let the platform continue running
ERROR Messages (errors) that are logged but keep the platform running and e.g. a default value is used instead of a wrong parameter
FATAL Critical message (error) → the platform is possibly unstable / not ready for operation

If a logger is not assigned a level, it inherits the level of the first ancestor to whom a level was assigned. To ensure inheritance, the root logger always has a level.

Logging is written to the file bbp.log as described in the following table:

Operating System Logging File
Windows c:\ProgramData\bbp\logs\bbp.log
Linux /var/log/bbp/bbp.log