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:
- ALL (all information logged)
- FINEST (lowest level: most information logged)
- FINER
- FINE
- CONFIG
- INFO
- WARNING
- SEVERE (highest level: least information logged)
- NONE (no logging)
For example, if you select WARNING, SEVERE messages will be
included but INFO messages will not.
Note:
- If no level is specified, the default logging level will be used,
defined by the com.ibm.etools.logging.util.loggingDefault extension point.
- If a plug-in has a level saved in the preference store from a previous
session of the workbench, then that level is used.
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
(C) Copyright IBM Corporation 2000, 2005. All Rights
Reserved.