Cisco Cisco Expressway Maintenance Manual
Diagnostics tools
This section provides information about how to use the diagnostics tools:
n
n
n
advanced logging configuration tools
n
Configuring diagnostic logging
The
Diagnostic logging
tool (
Maintenance > Diagnostics > Diagnostic logging
) can be used to assist in
troubleshooting system issues.
It allows you to generate a diagnostic log of system activity over a period of time, and then to download the
log so that it can be sent to your Cisco customer support representative. You can also take and subsequently
download a tcpdump while logging is in progress.
log so that it can be sent to your Cisco customer support representative. You can also take and subsequently
download a tcpdump while logging is in progress.
To use this tool:
1. Go to
Maintenance > Diagnostics > Diagnostic logging
.
2. Optionally, select Take tcpdump while logging.
3. Click Start new log.
4. (Optional) Enter some Marker text and click Add marker.
l
The marker facility can be used to add comment text to the log file before certain activities are
performed. This helps to subsequently identify the relevant sections in the downloaded diagnostic log
file.
performed. This helps to subsequently identify the relevant sections in the downloaded diagnostic log
file.
l
You can add as many markers as required, at any time while the diagnostic logging is in progress.
l
Marker text is added to the log with a "DEBUG_MARKER" tag.
5. Reproduce the system issue you want to trace in the diagnostic log.
6. Click Stop logging.
7. Click Download log to save the diagnostic log to your local file system. You are prompted to save the file
(the exact wording depends on your browser).
8. If appropriate, click Download tcpdump to also download the tcpdump file to your local file system.
The downloaded diagnostic log file and tcpdump can be sent to your Cisco support representative, if you
have been requested to do so.
have been requested to do so.
Note that:
n
Only one diagnostic log can be produced at a time; creating a new diagnostic log will replace any previously
produced log.
produced log.
n
The Expressway continually logs all system activity to a unified log file. The diagnostic logging facility
works by extracting a portion of this unified log. On busy systems the unified log file may become full over
time and will discard historic log data so that it can continue logging current activity. This means that all or
part of your diagnostic log could be overwritten. The system will warn you if you attempt to download a
partial diagnostic log file.
works by extracting a portion of this unified log. On busy systems the unified log file may become full over
time and will discard historic log data so that it can continue logging current activity. This means that all or
part of your diagnostic log could be overwritten. The system will warn you if you attempt to download a
partial diagnostic log file.
n
The diagnostic log will continue logging all system activity until it is stopped, including over multiple login
sessions and system restarts.
sessions and system restarts.
Cisco Expressway Administrator Guide (X8.1)
Page 191 of 344
Maintenance
Diagnostics tools