Adapter Logging

Modified on Thu, Feb 12 at 7:26 AM

Guide for configuring adapter logging.

Overview

NetLD provides a logging mechanism to assist with diagnosing problems with device backups and tool execution.

When to use

When reporting an issue to support related to backups or other device operations support will often ask for additional logging information for the operations failures. For 95% of backup failures, these logs are sufficient for support to be able to diagnose the failure.

Enable Adapter Logging

Select the desired network on the top right corner of the UI (if you do not have multiple networks you can ignore this step). Make sure you enable adapter logging for the same network that the device lives in.
In the NetLD web UI, go to the Help -> About screen, then click Adapter Logging
Enter the IP address of the device, then dismiss the dialog
Perform the failing operation (backup, tool, etc.) against the target device, for which analysis logs will be collected
Go to Help -> About screen again, and click Send Log
In the Send Information to Support dialog select Save. You do not need to enter an email address.

Adapter logging will be automatically disabled 5 minutes after this setting is enabled, so be sure to run the operation within 5 minutes.

Log Files

When performing an operation with adapter logging enabled one or more files will be written into the scratch/logs directory.

<adapter>_<operation>_<ipaddress>.log	This log contains the details for commands sent and responses that were received from the device, as well as other debug logging that is useful for diagnosing problems. All operations will create a log of this form.
<adapter>_<operation>_<ipaddress>.ipcrun.log	This log contains byte by byte information about data that was sent to and received from the device for SSH. This log is only created for operations that use SSH.
<adapter>_<operation>_<ipaddress>.telnet.log	This log contains byte by byte information about data that was sent to and received from the device for Telnet. This log is only created for operations that use Telnet.