To display a list of trace log messages, follow these summarized steps:
Choose Start > Programs > Cisco VLT > VLT.
Choose File > Open > Open > Yes/No.
Choose File > Append > Open > Yes/No.
Choose File > Save Translation.
Choose File > Close and File > Exit.
To display a list of trace log messages, follow these detailed steps:
Choose Start > Programs > Cisco VLT > VLT to open Cisco VLT.
In the Open Files box, go to the folder where the trace log message files are stored, highlight one or more filenames (use <Ctrl> or <Shift> as needed to select multiple messages) and click Open.
The first 1000 selected files open in a single pane, sorted by timestamp.
The number of files that you can open is limited only by available system memory. If files are large, system performance may be affected.
If you open multiple log files, the tab displays only the first filename.
Open an additional set of log files, if needed:
Choose File > Append.
Highlight one or more filenames and click Open.
Edit the Messages upper pane display:
To display or hide columns, choose View > Columns, check or uncheck the boxes, as needed.
To display all calls in a file, choose View > List All CallRefs. A new window displays the following information depending on protocol and message types: timestamp, protocol, call reference, calling party, and called party. Close the window when finished.
Figure 1. Cisco VLT View Menu
To change the display contrast and font size, follow these steps:
Choose a log level (off, fatal, error, warn, info, debug, or all).
Choose a theme (default or high contrast).
Choose a font size (small, normal, or large).
Figure 2. Cisco VLT Configuration Window
Edit the Messages Translation lower pane display by toggling among the following choices: Raw, Simple, and Detailed.
If the signaling protocol for a message is invalid or not supported, you can display the message in raw format only.
To open and display the trace log files that contain one or more particular messages, highlight the messages, right-click, and select Open Trace File. New windows display the trace log files. To search for a particular text string, use the Find box. Close the windows when you are finished.
To display a list of valid wildcards and operations, choose Help > Regular Expression Reference.
To save a message translation to a flat text (.txt file extension) file, choose File > Save Translation. In the Save File box, enter a location and name for the new file, and click Save.
When you are finished, close any active messages-list windows by choosing File > Close. Exit Cisco VLT by choosing File > Exit.
Filtering the Trace Log Message List
You can filter a trace log message list to do the following:
Display a list of messages with criteria that you check or supply, or with the same criteria as those possessed by messages that you highlight, see Detailed Steps below. Criteria includes the following:
Retries—Messages that are flagged as retried messages.
Highlighted device IP—Device IP address where messages are sent or received. Typically includes Cisco Unified Communications Manager, Cisco IOS gateways, IP phones, and more.
Highlighted direction—Receive or Send.
Highlighted protocol—H.225, H.245, JTAPI, MGCP, Q.931, SCCP, or SIP.
Highlighted call reference—The call-reference string in the CallRef column.
Highlighted channel—A voice port on a device. Examples: B channels on a PRI, a voice port on an IP phone, a CTI port for JTAPI.
Highlighted call—All messages that are associated with the call for which one or more messages are highlighted, across multiple signaling protocols (MGCP, Q.931, SCCP, and SIP).
Highlighted rows—Only the highlighted messages use <Ctrl> or <Shift> as needed to select multiple rows. If you highlight multiple messages, the Messages Translation lower pane displays the message for the last selected message.
Keyword—Messages that contain a specified text string.
Abnormal disconnect—Messages that have abnormal disconnect causes (cause codes that designate abnormal disconnect vary by protocol). This applies to calls that disconnect for reasons other than Normal Call Clearing or User Busy. Calls that disconnect because the user dials an invalid prefix or other numbers is classified as an abnormal disconnect.
Display a list of messages for calls with specified criteria—this is useful if you prefer to enter parameters directly instead of selecting messages in the Messages upper pane, see Detailed Steps below.
Highlight one or more messages (use <Ctrl> or <Shift> as needed to select multiple messages) with the desired device IP, direction, protocol, message type, call reference, channel, or call.
Click Filter (or right-click the highlighted message), then check the desired filter criteria and, if prompted, enter required information such as keywords (Detailed Steps). (To see a list of filter criteria, see the discussion preceding this procedure.) Column headings for the desired criteria display in parentheses.
Repeat, as needed, to further filter by other criteria.
To disable a filter, click the column headings in parentheses or choose Filter > Clear All Filters.
Figure 3. Cisco VLT Filter Menu
A customized filter is useful if you know the parameters and prefer to enter them directly instead of constructing filters by selecting messages in the Messages upper pane. To define your own customized filter, do the following:
Choose Filter > Advanced Filter.
Check and uncheck the displayed conditions as appropriate. Review the displayed values for each condition and edit them using wildcards and simple AND and OR operations.
To display a list of valid wildcards and operations, click ?.
To clear all entries, click Clear. To reload the current filter, click Current.
Click Ok. A filtered list displays.
When you are done, do the following:
Close any active messages-list windows by choosing File > Close.
Exit Cisco VLT by choosing File > Exit.
Finding Information in Trace Log Message Text
You can do the following with the text of a trace log message:
Specify a level of translation—raw, simple, or detailed (Detailed Steps below).