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” chapter.
- 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 Micro Traces.
Step 2 On the Micro Traces page, in the Server field, select the name of the Unity Connection server and select Go.
Step 3 In the Micro Trace field, select VUI and select Go.
Step 4 Check the Capture Utterances check box (level 05) and select Save.
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 http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cucm/service/10_0_1/rtmt/CUCM_BK_CA30A928_00_cisco-unified-rtmt-administration-100/CUCM_BK_CA30A928_00_cisco-unified-rtmt-administration-100_chapter_01000.html .
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 Remote Browse.
Step 9 In the Remote Browse window, select Trace Files and select Next.
Step 10 In the Select CUC Services/Application tab, check the check box next to the IP address of the server and select Next.
Step 11 In the Select System Services/Applications tab, select Finish.
Step 12 When the Result pop-up displays, indicating that the Remote Browse is ready, select Close.
Step 13 On the Remote Browse tab, browse to the Nodes > Server Name > CUC > Unity Connection Voice Recognition Transport folder.
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 Other 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 Open. Then select the name of the application you just added.
Step 17 Select OK.
Step 18 In Cisco Unity Connection Serviceability, disable the trace that you enabled in Step 3, then select Save.
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 http://www.ciscounitytools.com.
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 Download Now.
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 System Settings, then select Advanced > Conversations.
Step 2 On the Conversation Configuration page, check the Enable Remote Port Status Monitor Output check box.
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.