Cisco Cisco Customer Voice Portal Downloads User Guide

Page of 107
C
HAPTER 
5:
 
V
OICE
XML
 
S
ERVER 
L
OGGING
 
 
V
OICE
XML
 
S
ERVER 
U
SER 
G
UIDE 
 
 
 
FOR 
C
ISCO 
U
NIFIED 
C
USTOMER 
V
OICE 
P
ORTAL 
R
ELEASE 
4.0(1) 
 
 
 
 
 
67
Category 
Action 
Description 
custom 
[NAME] 
Anywhere the developer adds custom name/value information to 
the log will have the name appear as the action and the value 
stored within as the description. 
Table 5-1 
Notes on the Activity Logger: 
    Due to its complexity, the Activity Logger requires that the enforce call event order option to 
be set for the logger instance using it and will throw an error if it is not set. 
    When one Unified CVP application performs an application transfer to another application, 
the reported timestamps of the end category of the source application and the start category 
of the destination application could be imprecise when the source application ends with the 
playing of audio content. This is due to the fact that voice browsers typically request 
VoiceXML pages in advance if the current page contains only audio and a submit to the next 
page. In other words, the browser could be playing audio to the caller while making a request 
for the next VoiceXML page. If that page were the last of an application, the subsequent 
request would begin the process of entering the new application including having the 
Activity Logger handle start and end of call logging for the two applications. It would then 
report the end time for the source application as being before the time the caller actually 
“experienced” the destination application by hearing its audio. 
o
  The above scenario that describes how application transfers may result in unexpected 
logging timestamps also applies to the reporting database, which receives its data via the 
Datafeed logger.  Due to this, when custom reports are generated from the reporting 
database, care should be taken with data from voice applications which include 
application transfers. One option is to create reports using queries that expect unusual 
data around application transfers, and either mark or exclude it.  Minimally, developers 
and administrators should be familiar with the impact of application transfers on logging 
(and therefore reporting) timestamps. 
The Activity Logger utilizes a configuration to control the finer details of the information it 
stores in its log files. The configuration controls five different aspects of the Activity Logger: the 
format of the files, how much data to store in them, how often to rotate the files, how caching 
should work, and how often should log files be purged. This configuration is specified as an 
XML file created by the designer in Unified CVP VoiceXML Studio.