Logging preferences for the Log and Trace Analyzer

The Logging preferences window (Window > Preferences > Logging ) enables you to specify your preferences for the level of messages that are recorded in the log file, LoggingUtil.log that is written to by the product's plug-ins. It also enables you to set the number of days after which the archived log file will be deleted. This file is usually of interest to plug-in developers. A new LoggingUtil.log file will be created every time you start the workbench and the previous LoggingUtil.log file will be archived.

The window consists of these pages: Loggers and General.

Loggers

Displays the list of plug-ins implementing the loggingOptions extension point, which is defined by the com.ibm.etools.logging.util_version plug-in.

The table is composed of the following columns:

Logger Name
The name of the logger, specified by the loggingOptions extension point.  
Note: If no name is specified, the default logging name will be used, defined by the com.ibm.etools.logging.util.loggingDefault extension point.
 
Logging Level
The logging level, specified by the loggingOptions extension point.
The logging level is that level at which messages with a certain degree of detail and less will be recorded in the log file. That is, the higher the logging level, the lesser the amount of information logged. Only messages with the same or higher logging level than the logging level that is selected (that is, specified by the loggingOptions extension point) will be logged to the LoggingUtil.log file.
Note: When the level that is selected is NONE, no messages are logged.

The order of logging levels is as follows:

  1. ALL (all information logged)
  2. FINEST (lowest level: most information logged)
  3. FINER
  4. FINE
  5. CONFIG
  6. INFO
  7. WARNING
  8. SEVERE (highest level: least information logged)
  9. NONE (no logging)

For example, if you select WARNING, SEVERE messages will be included but INFO messages will not.


Note:

General

This page displays the workbench default logging options, and has the following fields:

Archived file days
Set the number of days after which archived LoggingUtil.log files will be deleted. The default is 7 days. If you specify 0 for the number of days, the files will never be deleted.

Note: Archived files have the form LoggingUtiltimestamp.log where timestamp is the standard Java timestamp (the time in milliseconds between the exact time when the files were archived and midnight, January 1, 1970 Universal Time Coordinate (UTC)). For example, a file archived at 11:30:20 a.m. EDT on the 6th of June, 2002 will have the form LoggingUtil1023377420784.log.
Default logging level

This is the default logging level applied to all loggers which do not provide their own logging level. The default level is specified by the com.ibm.etools.logging.util.loggingDefaults extension point, and is set to CONFIG.

Only messages with the same or higher logging level than the logging level that is selected (that is, specified by the loggingOptions extension point) will be logged to the LoggingUtil.log file. If NONE is selected, no messages are logged. Refer to the order of logging levels under the Logging levels section for Loggers.

Related tasks
Setting logging preferences