Log types

HCL 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, HCL 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. HCL 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 HCL 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 HCL 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, HCL 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. Because of the amount of extra logging generated with FINEST, this setting for a user will expire after the number of days specified by the notes.ini NTS_LOG_USER_EXPIRATION. The default is 14 days.

For more details on the commands for configuring and working with the Traveler logs, see the Logging commands.