Call logging

This table describes the events that the Voice Browser service writes to call log files. These events specify the name and the value. The events written to the log file vary based on what happens during the recognition. By default, call log files are written to a hierarchical directory structure under %NUANCE_DATA_DIR%/companycallLogs/... on Speech Server hosts. This environment variable is set to:

  • Windows: C:\ProgramData\Nuance\Enterprise
  • Linux: var/local/Nuance

Not all logging levels in Management Station are available for all services.

Event name

Value

BROWSER

Name of the browser instance handling the call. A browser instance is a logical port within the Voice Browser service instance that communicates with corresponding Telephony Session service and Speech Server ports. Each browser instance handles a call.

BROWSER_ID

ID of the browser instance handling the call.

CALL_LOCAL_URL

For inbound calls, the called number. For outbound calls, the caller’s number, that is, the number or URL of the entity placing the call.

CALL_REMOTE_URL

For inbound calls, the caller’s number. For outbound calls, the called number.

ENTERING_FORM

Name of the processed form element.

ENTERING_FORM_ITEM

Name of the processed form item.

EXECUTING_URL

The URL of the VoiceXML page the browser instance is currently executing.

FAR_END_DURATION

Duration, in seconds, of a successful far-end dialog.

GRAMMAR_LABEL

Unique (and more meaningful) identifier for the grammar associated with each dialog state. The default is the VoiceXML application and document URL, form ID, and form item name.

nvp_metric.caller-perceived-latency

Milliseconds between the end of the caller’s input and the start of the next prompt. See Enabling performance metric events.

nvp_metric.time-to-first-prompt

Milliseconds between the start of the call (answered) and the first prompt. See Enabling performance metric events.

ORIG_CALL_ID

ID of the SIP call into Voice Platform and referenced by the Telephony Session service. The ORIG_CALL_ID event distinguishes this ID from other internal call IDs used by Voice Platform components.

SWItrxb

Name assigned to the start of the task.

SWItrxe

End of task for task name given by SWItrxb event.

FAR_END_DURATION

Duration, in seconds, of a successful far-end dialog.

Here is a sample VoiceXML page:

<vxml version="2.0" xmlns="http://www.w3.org/2001/vxml">
 
 
 <noinput> <prompt>I didn't hear anything.</prompt> </noinput>
<nomatch> <prompt>Your input did not match a grammar.</prompt></nomatch>

    <form id="main">

        <field name="name">
 
          <prompt bargein="true">OK now you're in trouble. Who you wanna             call?</prompt>
            
<grammar root="NAMES" version="1.0" xml:lang="en-US">
 
               <rule id="NAMES" scope="public">
                    
<one-of>
                        
<item>Batman</item>
                        
<item>Superman</item>
                    </one-of>
                
</rule>
            
</grammar>

<filled>
                
<prompt>
                    
I recognized
                    <value expr="name"/>.
                
</prompt>
            
</filled>
        
</field>
    
</form>

</vxml>

Here is part of the call log file showing the events this sample code generates:

...
TIME=...|CHAN=...|EVNT=BROWSER|VALU=Browser_11|...
TIME=...|CHAN=...|EVNT=BROWSER_ID|VALU=18055178|...
TIME=...|CHAN=...|EVNT=CALL_REMOTE_URL|VALU=sip:5149047800@10.3.4.60|...
TIME=...|CHAN=...|EVNT=CALL_LOCAL_URL|VALU=sip:2484@10.3.21.9|...
TIME=...|CHAN=...|EVNT=ORIG_CALL_ID|VALU=4A3343F0-E65411DC-A7288EBA-35D8A367@10.3.4.60|...
...
...
TIME=...|CHAN=...|EVNT=TRANSITION|VALU=InitialPage resulted in http://localhost:8090/PizzaTalk/dialogs/Hero.vxml|...
TIME=...|CHAN=...|EVNT=ENTERING_FORM|VALU=#main|
TIME=...|CHAN=...|EVNT=ENTERING_FORM_ITEM|VALU=field:name|...
TIME=...|CHAN=...|EVNT=GRAMMAR_LABEL|VALU=/PizzaTalk/dialogs/Hero.vxml<>#main<>field:name|...
...
TIME=...|CHAN=...|EVNT=nvp_metric.time-to-first-prompt|VALU=2316|
TIME=...|CHAN=...|EVNT=TRANSITION|VALU=http://localhost:8090/PizzaTalk/dialogs/Hero.vxml resulted in exit|
TIME=...|CHAN=...|EVNT=nvp_metric.caller-perceived-latency|VALU=1394|