Problem
How and where do you control the logging level in the various log files?
Solution
There are 3 different levels at which you can set and control logging functionality.
1 In the root of the propath, the config.ini file has settings for 'logging-level' and 'stack-trace'.
- 'logging-level' can be a number from 0-3 or the words 'None, Error Only, Basic, Verbose' signifying the logging levels.
- 'stack-trace' turns on stack trace messaging in the log file and in UI error messages.
- The benefit to using this level is that it can be set by IT personnel and cannot be overridden unless a higher level is specified on another level.
2 In RecTrac Static Parameters Profile there are 2 fields:
- The 'WebSpeed Debugging Level' which sets the logging level for all programs running through the WebSpeed broker (RecTrac and WebTrac).
- The 'AppServer Debugging Level' determines the AppServer logging level.
Also, the 'Include Stack Trace in error message?' toggle turns on/off stack trace messages being written to the log file. This option is beneficial for turning on logging for only the AppServer and not WebSpeed.
3 In RecTrac Interface Parameter Management there are 2 fields:
- The 'Interface Debugging' which allows for a specific interface to be logged
- The 'JavaScript Debugging' which will output log messages to the FireBug console. You can turn this on in RecTrac by hitting F9 on the fly.
Also, the 'Interface Stack Trace' toggle turns stack tracing on for that interface. This option is beneficial for logging a specific interface like WebTrac.
Notes:
- The logging level is the max of the 3 different levels, meaning that if it is set to Error Only at the config.ini level but the interface parameter level is set to Verbose, then the logging for that interface will be verbose.
- Stack-trace messages get sent to both the log file and the UIErrorMessage.
- The logging level on the Agent/Broker in OE Management has absolutely no effect on the logging functions.
Logging Levels:
0 = No logging AT ALL meaning nothing will get written to the log. The ONE exception to this rule is if Stack-Trace is turned on, these will be written to the log. This is necessary for hard to find Progress errors to be written to the log even when logging is not turned on.
1 = Error Only which logs only messages flagged as 'ERROR' or 'COMPILE'. 'STACK' will show if Stack-Trace is turned on.
2 = Errors and Information. This level lets through the 'ERROR', 'COMPILE', 'DEBUG', and 'QUERY' messages. This is useful for those times we need to get some logging for a report or something where we need to see the QUERY, and also for any other messages set as 'DEBUG'.
3 = Verbose logging. Basically there are no restrictions here and all messages are written to the log.