Technical Notes

HOWTO: Enabling detailed logging with Zetalink

ZTN2000

ID: ZTN2000

This Zetalink technical note applies to:

  • Zetalink 1.0

Summary

Logging information can be used and may be required for support personnel to diagnose the cause of a problem in the Zetalink system. Use caution when increasing the logging level as this may cause large files to be produced over time depending on system activity and reduce performance.

When troubleshooting a problem it is advised to reduce the system usage to a minimum in order to not add unnecessary logging information to the traces and to aid in locating the cause of the problem. Once a procedure can be followed to produce an error the logging level can be increased to trace the procedure and isolate the cause of the problem.

More information

Increasing the logging level for Zetalink is achieved by editing the registry.

WARNING: Using Registry Editor incorrectly can cause serious problems that may require you to reinstall your operating system. Equisys cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use the Registry Editor at your own risk.

For information about how to edit the registry, view the " Changing Keys and Values" Help topic in Registry Editor (REGEDIT.EXE) or the " Add and Delete Information in the Registry" and " Edit Registry Data" Help topics in REGEDT32.EXE. Note that you should back up the registry before you edit it. If you are running Windows NT or Windows 2000, you should also update your Emergency Repair Disk (ERD).

  1. Start Registry Editor on the Zetalink server.
  2. Locate the following key in the registry:

HKEY_LOCAL_MACHINE\SOFTWARE\Equisys\Zetalink\Logger

  1. Select the DWORD entry below and set the desired logging level:

Log To DB

0 is debug, 1 is trace, 2 is info, 3 is warning, 4 is error and 5 is severe.

Log to Event Log

0 is debug, 1 is trace, 2 is info, 3 is warning, 4 is error and 5 is severe.

Use Trace File

(Reserved for later use)

Note: It is not recommend to set 'Log to Event Log' too low (i.e. 0 or 1) as this will quickly fill the event log with trace messages.

Setting logging to debug (0) also requires a debug registry setting to be enabled on a module-by-module basis. (This should only done when advised by an Equisys support personnel and would normally not be required).

  1. To use the debug log feature create a registry key for the module advised. Set the value LogDebug to 1.
  2. Restart the PC to make sure the registry key is read. Debug messages will now appear for the module.
  3. 'Log To DB' entries are viewed in the activity log of the Zetalink configuration snap-in and 'Log to Event Log' are viewed with the 'Event Viewer' snap-in.

Last updated: 15 November 2001 (JG/DH)