Using Diagnostic Traces for Voice Recognition
Cisco Unity Connection Serviceability offers diagnostic micro traces and macro traces for help in troubleshooting voice-recognition issues. For detailed instructions on enabling the traces and viewing the trace logs, see the
“Diagnostic Traces in Cisco Unity Connection 10.x”
Conversation Development Environment (CDE)
– 10 State Machine Trace
– 22 Speech Recognition Grammar
Media: Input/Output (MiuIO)
– 25 ASR and MRCP
Subscriber Conversation (ConvSub)
– 03 Named Properties Access
– 05 Call Progress
– 10 Speech Recognition
Set the Voice User Interface/Speech Recognition Traces.
Note Use this macro trace only if you have first tried to diagnose the problem using the recommended micro traces. The macro trace generates a large amount of diagnostic information which can be difficult to sort through.
Using the Utterance Capture Trace to Review User Utterances
When you enable the VUI micro trace level 05 (Capture Utterances), Unity Connection saves user utterances as WAV files in CCITT (u-law) 8-kHz mono format. The files are stored on the file system, with one folder created for each MRCP session. (You can view MRCP session information for a call in the diagnostic logs by enabling the MiuIO level 25 micro trace for ASR and MRCP.)
You can access the utterance files using the Real-Time Monitoring Tool (RTMT)..
Enabling the utterance capture micro trace can affect system performance. Consider doing so only when the system is not under heavy load, and be sure to disable the trace when you are done collecting the desired utterances.
To Enable and View Utterance Capture Traces Using RTMT
Step 1 In Cisco Unity Connection Serviceability, on the Trace menu, select
Step 2 On the Micro Traces page, in the Server field, select the name of the Unity Connection server and select
Step 3 In the Micro Trace field, select
Step 4 Check the
check box (level 05) and select
Step 5 Reproduce the problem.
Step 6 To access the utterance files, launch Real-Time Monitoring Tool (RTMT). For details, see the “Traces and Logs” chapter of the
Cisco Unified Real-Time Monitoring Tool Administration Guide, Release 10.0(1), available at
Step 7 In RTMT, on the System menu, select
Tools > Trace > Trace & Log Central
Step 8 In the Trace & Log Central tree hierarchy, double-click
Step 9 In the Remote Browse window, select
Step 10 In the Select CUC Services/Application tab, check the check box next to the IP address of the server and select
Step 11 In the Select System Services/Applications tab, select
Step 12 When the Result pop-up displays, indicating that the Remote Browse is ready, select
Step 13 On the Remote Browse tab, browse to the
Server Name > CUC
Unity Connection Voice Recognition Transport
Step 14 In the Unity Connection Voice Recognition Transport folder, double-click the name of a folder to view the audio files that were captured for that MRCP session. (One folder is created for each MRCP session.)
Step 15 In the files pane, double-click the name of an audio file to play it.
Step 16 In the Open With window, select the application you want to use to play the audio file.
If an appropriate audio player is not available in the list, select the
tab at the bottom of the window, browse to the location of an audio player, double-click the name of the audio player executable, and select
. Then select the name of the application you just added.
Step 17 Select
Step 18 In Cisco Unity Connection Serviceability, disable the trace that you enabled in Step 3, then select
Using the Remote Port Status Monitor
The Remote Port Status Monitor tool is useful for troubleshooting voice-recognition problems because it displays the conversation flow for a call in real time, including speech input and confidence scores, system interpretations of utterances, and changes to the search scope that can affect name and digit interpretation during the course of the call. To use the tool, do the following procedures in order.
To Download the Remote Port Status Monitor
Step 1 In a web browser, go to the Cisco Unity Tools website at
Step 2 In the Tool Update Log section, select
Port Status Monitor
Step 3 On the Cisco Unified Communication Tools page for the Port Status Monitor, select
Step 4 Follow the on-screen instructions to download the Remote Port Status Monitor tool.
To Configure Unity Connection for the Remote Port Status Monitor
Step 1 In Cisco Unity Connection Administration, expand
, then select
Advanced > Conversations
Step 2 On the Conversation Configuration page, check the
Enable Remote Port Status Monitor Output
Step 3 In the IP Addresses Allowed to Connect for Remote Port Status Monitor Output field, enter the IP addresses of your workstations and select Save.
Note You can enter up to 70 IP addresses. Each IP address must be separated from the following IP address by a comma.