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.