Cisco Cisco Customer Voice Portal Downloads Release Note

C

HAPTER 

5:

 

VXML Server

 

L

OGGING

 

 

U

SER 

G

UIDE FOR 

C

ISCO 

U

NIFIED 

CVP

 

VXML

 

S

ERVER 

 

 

 

AND 

C

ISCO 

U

NIFIED 

C

ALL 

S

TUDIO

 

 

 

92 

VXML Server communicates with loggers by triggering logging events that the loggers listen for 
and then deal with. VXML Server activates loggers in a fully multi-threaded environment to 
maximize performance. 

Loggers are divided into two categories: global loggers and application loggers. Global loggers 
are activated by logging events that apply to VXML Server as a whole and that is not directly 
related to any particular application (for example a record of all calls made to the VXML Server 
instance). Application loggers are activated by logging events that apply to a particular 
application running on VXML Server (for example a call visiting an element). Each logger type 
is constructed using separate Java APIs and deals with a separate list of possible logging events . 
Each logger type is also given a separate area to store logs, though a logger may choose to ignore 
this area in the case that it does not log to files. 

The 

global_config.xml

 file found in the 

conf

 directory of Audium Home is used to define the 

global loggers VXML Server is to use. The administrator can define any number of global 
loggers to be simultaneously active, even multiple instances of the same logger class. This file 
also lists the names of the configuration files for these loggers, if they are configurable. The 
configuration files must be placed in the same 

conf

 directory as the 

global_config.xml

 file. 

The 

global_config.xml

 file and any configuration files must be edited by hand, there is no 

interface for editing them. Refer to Chapter 6: VXML Server Configuration for more details 
about this file and how to define global loggers within it. 

Global loggers will be loaded by VXML Server when it starts up and remain in memory until it 
is shut down. Any change made to the 

global_config.xml

 file will not be loaded until VXML 

Server is restarted. 

VXML Server provides the 

logs

 folder of Audium Home for log file storage should the Global 

Loggers require it.  To keep each logger instance’s logs separate, a subfolder with the name of 
the logger instance is created and all logs generated by the logger instance are stored there. 

By default, VXML Server utilizes three loggers to create text log files containing VXML Server-
specific information: a log that keeps track of calls made to the system, a  log for tracking 
VXML Server administration activity, and an log that shows errors that occur on the VXML 
Server level (as opposed to the application level). The global error logger requires a 
configuration that allows for detailed control over how the logger operates. 

The following sections describe these three pre-built global loggers, their configurations (if any), 
and the information stored in their logs. 

The global call logger records a single line for every application visit handled by VXML Server 
into a text call log. Most calls will begin and end in a single application so in that case a line in