4 Log Browser
The Log Browser allows you to view the log entries stored during each phone call. Use it to debug your application using information about completed calls, after the fact.
Note: To use the BeVocal tools, you must have the Java Runtime Environment (JRE) 1.5.7 installed on your computer.
As a phone call to an application progresses, the interpreter records various messages to a log file. Click Log Browser in the Tools & File Management menu to view a list of the calls that have been made to your account. You can then use the Log Browser to view the log messages for selected calls.
After you click Log Browser, the Log Browser Command Area shows a call list from the current date.
Searching the Call List
You use the fields at the top of the Command Area to specify call list search criteria. For example:
| • | To see entries for all calls made on a particular date, enter that date in both the From Date field and the To Date field and leave all other fields blank. |
| • | To see entries for all calls on a sequence of days, enter the first date in the From Date field, enter the last date in the To Date field, and leave all other fields blank. |
| • | To see entries for all calls made from a particular telephone, enter the phone number in the Caller ID field and leave all other fields blank. |
| • | To see only calls that generated errors, click the box next to Show error calls only. |
| • | To see an entry with a specific Session ID, enter the value in the SessionID field and leave all other fields blank. |
After filling in the fields, click Submit to search the call list for calls that meet your search criteria. When the search is complete, the table header indicates how many matching calls were found. Calls are ordered by the time each call was placed, with the most recent one first.
To specify how many calls you want to see on each page of the call list, select a value for Results per page. The default is 20 calls per page. You can click the page number links at the bottom of the table to see the next set of calls.
The call table view is customizable. Click Customize View to select display columns from the following list:
| • | Start Time--The time at which the call was placed |
| • | Caller ID--The telephone number from which the call was placed |
| • | Duration--The number of seconds that the call lasted |
| • | Mis-recognition count--The number of missed recognitions during the call |
| • | User ID--Your account number |
| • | Dialed Number--The telephone number that was called |
| • | Error Count--The number of errors that occurred during the call |
| • | Session ID--The unique call identifier, such as 2002-eng001-ch001-6u2er. |
Click Default in the Customize window to revert to the default settings.
Viewing the Log for Selected Calls
For each call that matched your search criteria, the table in the Command Area shows an entry for that call.
The rightmost column of the table, labeled Details, is active. You click a View Log cell in that column to display the messages logged during the call described by that row in the table. The Log Browser console starts and displays the call's log.
The Log Browser console contains a Log Browser Control Area and a Log Message Area. Log Messages are color-coded according to their message type.
The Control Area contains:
| • | Checkboxes that let you filter the messages displayed to those types that are of interest. |
| • | An Apply Filter button, which causes the display to update according to the specified filter criteria. |
| • | A Reset button, which restores the checkboxes to their most recently applied values. |
| • | An Apply Default button, which restores the checkboxes to their default setting (all selected) and updates the display. |
The color-coded log message types are described in the table below:
| Message Type |
Used to Display |
General Flow Trace
|
Major elements in the call progression, such as initializing form interpretation or adding a prompt to the prompt queue list.
|
Event Trace
|
Any events thrown by the interpreter or application, such as a no speech timeout event or a hang-up event.
|
Performance Data
|
Timing data, such as how long to fetch a grammar.
|
Variables Trace
|
Initial values and value changes to any JavaScript variables used in the VoiceXML application.
|
Error Message
|
Error conditions detected during the call that cause the interpreter to stop.
|
Custom Message
|
Messages from any VoiceXML <log> tags or use of the JavaScript bevocal.log command used in the VoiceXML application.
|
Call Control
|
Any use of the <transfer> tag or the JavaScript call-control extensions in BeVocal VoiceXML, such as bevocal:dial, bevocal:connect, and so on.
|
Platform
|
Low level platform messages, including playing stored audio prompts or text-to-speech (TTS) text.
|
Recognition Info
|
Attributes of a speech recognition, such as confidence level and the returned result.
|
HTTP Header Info
|
All HTTP header information when the application fetches any VoiceXML scripts or resources, such as audio prompts, grammars, or JavaScript files.
|
Warning Message
|
Error conditions detected during the call that do not cause the interpreter to stop.
|
Show Timestamp
|
A timestamp along with all the other message types.
|
.
You can limit the messages displayed to whichever types are of interest by selecting the corresponding checkboxes and then clicking Apply Filter.
[Show Frames] [FIRST] [PREVIOUS] [NEXT]
