4.11 VGMC_CallQuality

Use this Knowledge Script to monitor channel statistics for the Avaya Voice Gateway Media Card (VGMC), Media Gateway Controller (MGC), and MC32S: audio setup, voice time, jitter, lost packets, and channel latency. This script raises an event if a statistic exceeds the threshold you set. In addition, this script generates the following data streams:

  • Total number of audio setups, which is the number of call legs established in a call. A simple call may have only one audio setup, but a conference call or a call on hold can have multiple audio setups.

  • Total amount of voice time for all calls of a particular set type during the reporting period.

  • Average and maximum jitter. Jitter is the mean deviation of the difference in RTP data packet spacing at the receiver compared to the sender for a pair of packets.

  • Average percentage of lost packets, calculated based on the number of expected packets and the number of packets actually received. The number of packets received includes those that were late or duplicates. Packets that arrive late are not counted as lost. The presence of duplicate packets could result in a negative lost data amount.

  • Average channel latency (not available from VGMCs). Latency is the average value of the difference between the time stamp indicated by the senders of messages and the timestamp of the receivers, measured when the messages are received. The average is obtained by adding all of the estimates, then dividing by the number of received messages.

For more information, see Section 4.7.6, Understanding How Data Streams are Calculated.

4.11.1 Prerequisite

Run GetOMReport before running this script.

4.11.2 Resource Objects

NortelCS VGMC

NortelCS Media Gateway Controller

NortelCS MC32S

4.11.3 Default Schedule

By default, this script runs once every hour, at ten minutes past the hour. Do not change the default. Devices collect data for the OM Report on the hour. The GetOMReport Knowledge Script retrieves the OM Report at five minutes past the hour.

If you change the default schedule for this script, you risk not retrieving the latest data.

4.11.4 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

Event Notification

Raise event if audio setups exceed threshold?

Select Yes to raise an event if the number of audio setups exceeds the threshold you set. The default is unselected.

Event severity if audio setups exceed threshold

Set the severity level, between 1 and 40, to indicate the importance of an event raised when the number of audio setups exceeds the threshold you set. The default is 15.

Raise event if voice time exceeds threshold?

Select Yes to raise an event if the duration of voice time exceeds the threshold you set. The default is unselected.

Event severity if voice time exceeds threshold

Set the severity level, between 1 and 40, to indicate the importance of an event raised when the amount of voice time exceeds the threshold you set. The default is 15.

Raise event if call quality exceeds threshold?

Select Yes to raise an event if any of the call quality statistics exceeds the threshold you set. The default is Yes.

Event severity if call quality exceeds threshold

Set the severity level, between 1 and 40, to indicate the importance of an event raised when the call quality statistics (maximum lost packets or maximum jitter) exceed the threshold you set. The default is 15.

Monitoring

Threshold - Maximum audio setups

Specify the highest number of audio setups that can occur before an event is raised. The default is 0.

NOTE:The default value has no significance and is not a recommended threshold value.

Threshold - Maximum voice time

Specify the largest amount of voice time that can accrue before an event is raised. The default is 0.

NOTE:The default value has no significance and is not a recommended threshold value.

Call Quality

Threshold - Maximum lost packets

Specify the highest average percentage of packets that can be lost before an event is raised. The default is 1%.

Threshold - Maximum jitter

Specify the highest amount of jitter that can occur before an event is raised. The default is 60 milliseconds.

Threshold - Maximum average latency

Specify the highest amount of average channel latency that can occur before an event is raised. The default is 60 milliseconds.

Collect data?

Select Yes to collect data for reports and graphs. When enabled, data collection returns data streams based on the thresholds you set. The default is unselected.