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 |