Diagnostics Tools; Configuring Diagnostic Logging - Cisco TelePresence Administrator's Manual

Maintenance

Diagnostics tools

This section provides information about how to use the diagnostics tools:
diagnostic logging
n
system snapshot
n
Network Log and Support Log
n
incident reporting
n

Configuring diagnostic logging

The Diagnostic logging
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.
To use this tool:
1. Go to Maintenance > Diagnostics > Diagnostic
2. Click Start new log.
3. (Optional) Enter some Marker text and click Add marker.
The marker facility can be used to add comment text to the log file before certain activities are
l
performed. This helps to subsequently identify the relevant sections in the downloaded diagnostic log
file.
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.
l
4. Reproduce the system issue you want to trace in the diagnostic log.
5. Click Stop logging.
6. 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).
The downloaded diagnostic log file can be sent to your Cisco support representative, if you have been
requested to do so.
Note that:
Only one diagnostic log can be produced at a time; creating a new diagnostic log will replace any previously
n
produced log.
The VCS continually logs all system activity to a unified log file. The diagnostic logging facility works by
n
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.
The diagnostic log will continue logging all system activity until it is stopped, including over multiple login
n
sessions and system restarts.
When starting a diagnostic log, the relevant system modules have their log levels automatically set to
n
"debug". You can ignore any "Verbose log levels configured" alarms; the log levels are reset to their original
values when you stop logging.
Diagnostic logging can only be controlled through the web interface; there is no CLI option.
n
Cisco VCS Administrator Guide (X8.1.1)
advanced logging configuration tools
tool (Maintenance > Diagnostics > Diagnostic logging) can be used to assist in
logging.
Diagnostics tools
Page 303 of 507