Display messages for a particular call (as identified by its call reference) or for all calls involving a particular device IP address, direction (send or receive), protocol, command, message, or channel. For example, you can display all messages related to the T1 1/0:3 on gateway A.B.C.D.
Display messages for calls with specified criteria.
Display messages by call reference; each message contains show timestamp, protocol, calling number, and called number. For example, you can display all messages for a particular call leg (any supported protocol) or for both legs (SCCP side and MGCP/Q.931 side) of a call.
Display messages for calls whose device IP address, direction (send or receive), protocol, command, message, call reference, or channel contains a text string.
Specify a level of translation (raw, simple, or detailed) for the text of a trace log message (see Finding Information in Trace Log Message Text). You can copy the message text to the clipboard, export translated messages to a text file, and search for a specific test string in message text.
If the signaling protocol for a message is invalid or not supported, you can display the message in raw format only.
Troubleshooting a Typical Cisco VLT Use Scenario
If you are an experienced administrator, familiar with Cisco products (including Cisco Unified Communications Manager, IOS command-line interface, and networking concepts and technologies) and are responsible for post-installation support of enterprise voice installations, use the following procedure to troubleshoot a scenario:
Receive notification of a problem with a Cisco Unified Communications Manager or JTAPI application.
Enable trace logging on relevant Cisco Unified Communications Manager servers or JTAPI clients.
Retrieve the following information about the problem call:
Call flow (whether transfer, conference, or forward are involved; whether the call is internal or external; types of devices involved, etc.)
Collect trace log message files from the Cisco Unified Communications Manager or JTAPI client, usually several files surrounding the time of the event.
Open the file whose time stamp is closest to the reported trouble time. (Alternatively, depending on circumstances, open the entire collection of trace files at once.)
Search each file's translated message text (by using the Find in Messages Translation function) until you locate the called or calling phone number for the trouble-causing call. Note the call reference.
Filter the display based on call reference to display all messages that pertain to that call.
Troubleshoot as needed. Possible actions depend on the type of problem, but include the following:
Save the one or more trace log message translations that pertain to the call to a flat file, open them with a text editor, and locate the exact timestamp or other helpful information.
Compare two or more message translations (typically for different calls) by using the Filter > by Highlighted Rows function to display the translations together. Comparing the translations for a successful and a failed call is a useful troubleshooting technique.
Messages upper pane—Displays a list of trace log messages from one or more files.
Messages Translation lower pane—Displays the raw or translated text of a highlighted message.
Figure 1. Cisco VLT User Interface (Standalone System)
Figure 2. Cisco VLT User Interface (Plug-in System)
The window allows for typical GUI display control such as window resize, column resize, vertical and horizontal scroll, minimize, restore, and close. You can also grab and move the border between the Messages upper pane and the Messages Translation lower pane.
The toolbar has both a top line (with text) and a bottom line (with icons).
To navigate using the top line. choose one of the displayed choices—File, Edit, Filter, View, or Help. These selections open a successive context-sensitive display of new choices, as shown in Cisco VLT GUI Display and Navigation.
Figure 4. Cisco VLT Toolbar: Successive Display of Choices
Alternatively, you can navigate using the icons on the bottom line. Icons for Open Log Files, Open and Add Log Files into Current Log Panel, Save Translated Messages, Copy, Paste, Find in Translated Message, Advanced Filter, and Call References duplicate most of the text options for the top line.
Cisco VLT Message Translations
Cisco VLT allows you to view message (raw) text at one of two translation levels. Examples of raw and translated messages, and how they display the same information (in this case, the code word X in an MGCP NTFY message), are as follows: