Logging
IBM Traveler has many different logs with a variety of purposes.
All of the logs are located in <Domino data root>\IBM_TECHNICAL_SUPPORT\traveler\logs
.
For many of the files, IBM Traveler utilizes JLog levels which are SEVERE, WARNING, INFO,
FINE, FINER
, and FINEST
. This is a sliding scale from
SEVERE
, which only logs errors, to FINEST
, which logs everything.
The default is generally INFO
, which is a good balance between the amount of
information logged and the size of the files. The logging changes needed for diagnosing a problem
are detailed in Gathering log files for support. IBM Traveler also has a custom
level called USAGE
.
Each file has a maximum size (prior to being zipped). When that
file size is reached, the logs are rotated, where the current file
is zipped and a new file is created. Each set of files has a cap based
on count and maximum age. If the count or maximum age has been reached,
the oldest file is deleted. This provides the administrator the ability
to cap the logs based on count or maximum age. For example, if the
administrator wants thirty days of logs (regardless of the amount
of files that includes), they could set the count to be very large
(but not so large as to run out of disk space) and set the maxage
to 30
.
NTSErrors files contain any errors that IBM Traveler has encountered. These are just the
SEVERE
level messages.
NTSAudit files contain changes to the system, such as settings
changes (server document, notes.ini
, and so on) and
server state changes (up, down, and so on). These all use the custom USAGE
level.
NTSUsage files contain the NTSAudit information, plus an entry for each transaction that the system performs on behalf of the devices. These transactions are logged once they complete (not when they begin) and allow the administrator to easily see who is syncing, how often, how long it took, and whether or not there were any errors.
NTSActivity files contain the NTSErrors, NTSAudit, NTSUsage information, plus anything else that
IBM Traveler logs. Thus, NTSActivity files contain everything that would be in an
NTS*.log
file.
All of the NTS*.log
files have names of the format NTS*_YYMMDD_HHMMSS.log
,
where the timestamp (YYMMDD_HHMMSS
) corresponds to
the date and time that the log file was created. All of the files
contain a header section that describes the format of the message
applicable to that file along with other information.
When a user is logged at level FINEST
, IBM Traveler also logs the XML
representations of the HTTP messages received from and sent to the devices. This can be found in the
<Domino data root>IBM_TECHNICAL_SUPPORT\traveler\logs\xml
directory and has
similar file rotation constructs as the NTS*.log
files.
tell traveler log help
and tell traveler
log handler
provide more details on all the options available.