Event log properties
Use the properties below to configure event logging. For more information about event logs, see the online help topic, About Event Log Properties.
Screen Field Description Severity The Severity field sets the maximum error severity level that causes an event to be logged. This field can have one of the following five values (in descending order of severity):
- Severe - Indicates probable future failures.
- Error - A failure occurred which affected only the current user, thread, or context.
- Warning - Something is amiss, recovery is being attempted. Better look into it soon.
- Information - No action is required.
- Debug - Debugging output.
Debug < Information < Warning < Error < Severe
If the user sets the Severity field to "Error", then the Factory servlet logs the events of "Severe" and "Error" levels. If the user sets the severity level to Warning, then the Factory servlet logs the events of "Warning", "Error" and "Severe" levels. If the user sets the Severity field to "Information", then the Factory servlet logs events of "Severe," "Error," "Warning" and "Information" levels.
File: WEB-INF/config/logging.properties
Entry: logging.event.criterion.abnormal.severity
Default value: warning
There are other filters that include events in or exclude events from the log file. The first is the Comparator that can take one of three values:
- >= (Include events with severity greater than or equal to the severity value.)
- > (Include only events with severity greater than the severity value.)
- = (Include only events with severity equal to the severity value.)
File: WEB-INF/config/logging.properties
Entry: logging.event.criterion.abnormal.comparator
Default value: >=
The attribute value "*" means unspecified. The field will be skipped during comparison.
Log File Directory The Log File Directory displays the full path (relative to the Factory installation directory) to the base directory where event log files are stored. The Factory servlet must be restarted before a change to this value takes effect. Access privileges to the Log File Directory control who is allowed to view event logs. File: WEB-INF/config/logging.properties
Entry: logging.driver.eventSink.directory
Default value: ${bowstreet.rootDirectory}/logs
Log File Prefix The Log File Prefix field defines the beginning of the name of the event log file written by the Factory servlet. The log file name has the following format: "prefix" + "timestamp" + "suffix" File: WEB-INF/config/logging.properties
Entry: logging.driver.eventSink.prefix
Default value: event_
Log File Suffix The Log File Suffix field defines the end of the name of the event log file written by the Factory servlet. The log file name has the following format: "prefix" + "timestamp" + "suffix" File: WEB-INF/config/logging.properties
Entry: logging.driver.eventSink.suffix
Default value: .log
Log File Max Size (KB) The Log File Max Size field sets the maximum size (in kilobytes) that the Factory servlet allows an event log file to reach. When a log file reaches this size, the Factory servlet closes the current log file, resets its internal counters and begins writing a new log file. File: WEB-INF/config/logging.properties
Entry: logging.driver.eventSink.maxSize
Default value: 1000
Flush Log Every (seconds) The Flush Log Every field sets the number of seconds that the Factory servlet waits before writing the contents of the event log queue to the event log file. File: WEB-INF/config/logging.properties
Entry: logging.event.flush.interval
Default value: 60
Flush Log Files Immediately The Flush Log Files Immediately checkbox tells the Factory servlet (when checked and true) to disregard the Flush Log Every _ Seconds parameter and immediately write all subsequent events to the event log file. File: WEB-INF/config/logging.properties
Entry: logging.event.criterion.abnormal.flushImmediately
Default value: false