Cisco Cisco Unified Customer Voice Portal 11.0(1) User Guide
C
HAPTER
3:
A
DMINISTRATION
U
SER
G
UIDE FOR
C
ISCO
U
NIFIED
CVP
VXML
S
ERVER
AND
C
ISCO
U
NIFIED
C
ALL
S
TUDIO
81
The metrics maintained by VXML Server is available only through the JMX administration
interface. To view the metrics, navigate to the
interface. To view the metrics, navigate to the
Global/Metrics
MBean. The Operations tab lists
15 separate functions that the administrator can call to obtain very specific information
concerning how the system is running as well as how it has performed in the past. Many of the
functions take a time duration as an input. It will display information of the specified period up
to a maximum of 60 minutes.
concerning how the system is running as well as how it has performed in the past. Many of the
functions take a time duration as an input. It will display information of the specified period up
to a maximum of 60 minutes.
The following list describes each function and the information it returns:
•
totalCallsSinceStart
– Returns the total cumulative number of calls handled by VXML Server
since it launched. This number will continually rise and only resets only when VXML Server
or the Java application server is restarted.
or the Java application server is restarted.
•
maxConcurrentCallsInLast
– Returns the most number of simultaneous callers that occurred
in the last X minutes where X is entered by the administrator (maximum of 60 minutes) and
when the maximum was reached. This is helpful in determining how close the call volume
reached the license limit on simultaneous callers. Knowing when the maximum value is
reached can be very helpful in determining if call volume is rising. For example if the peak
call volume for the last 10 minutes was achieved very close to present time, that would
indicate that call volume is rising.
when the maximum was reached. This is helpful in determining how close the call volume
reached the license limit on simultaneous callers. Knowing when the maximum value is
reached can be very helpful in determining if call volume is rising. For example if the peak
call volume for the last 10 minutes was achieved very close to present time, that would
indicate that call volume is rising.
•
avgConcurrentCallsInLast
– Returns the average number of simultaneous callers encountered
in the last X minutes where X is entered by the administrator. This data is helpful in
determining if a peak was an isolated occurrence or a sign of a trend. For example if the
maximum number of concurrent calls in the last hour was 100 but the average is 10, then
there is less to be alarmed about since the 100 peak did not last long and can be attributed to
a temporary spike. If the average were 90, then this would indicate that the call volume is
very steady.
determining if a peak was an isolated occurrence or a sign of a trend. For example if the
maximum number of concurrent calls in the last hour was 100 but the average is 10, then
there is less to be alarmed about since the 100 peak did not last long and can be attributed to
a temporary spike. If the average were 90, then this would indicate that the call volume is
very steady.
•
maxReqRespTimeInLast
– Returns the maximum time, in milliseconds, it took VXML Server
to produce an HTTP response in the last X minutes where X is entered by the administrator
and when the maximum was reached. A voice browser makes an HTTP request to VXML
Server, which then must respond with a VoiceXML page. Clearly a large response time
would be cause for concern as a slow performing system will cause callers to think that the
application has encountered errors and in extreme cases could cause the voice browser to
time out a request and end a call with an error.
and when the maximum was reached. A voice browser makes an HTTP request to VXML
Server, which then must respond with a VoiceXML page. Clearly a large response time
would be cause for concern as a slow performing system will cause callers to think that the
application has encountered errors and in extreme cases could cause the voice browser to
time out a request and end a call with an error.
•
avgReqRespTimeInList
– Returns the average time, in milliseconds, it took to produce an
HTTP response in the last X minutes where X is entered by the administrator. This value
gives the administrator a good idea of how long it takes VXML Server to handle responses
given the call volume. This could help the administrator decide if the system is overloaded
and beginning to affect the perception of callers regarding the responsiveness of the
application. It also establishes a baseline to compare with the maximum response time. A
maximum response time significantly higher than the average could be an indication that
there is a problem with an external resource accessed by a custom element such as a database
or web service and the few calls that visited that element suffered from bad performance. It
gives the administrator a good idea of how long it takes VXML Server to handle responses
given the call volume. This could help the administrator decide if the system is overloaded
and beginning to affect the perception of callers regarding the responsiveness of the
application. It also establishes a baseline to compare with the maximum response time. A
maximum response time significantly higher than the average could be an indication that
there is a problem with an external resource accessed by a custom element such as a database
or web service and the few calls that visited that element suffered from bad performance. It