3.18 PhoneQuality

Use this Knowledge Script to collect real-time voice-quality statistics for active calls on Avaya IP phones. This script raises one event per call if statistics exceed or fall below the thresholds you set. In addition, this script generates data streams for the following statistics:

Maximum interval MOS
Maximum interval R-Value MOS and R-Value are computed only for calls that use one of the following codecs: G.711u, G.711a, or G.729.
Maximum interval jitter
Maximum interval latency
Maximum interval packet loss

NOTE:You can trigger NetIQ Vivinet Diagnostics to diagnose the problem when voice quality thresholds are exceeded. For more information, see Triggering Call and Phone Quality Diagnoses.

When you start the PhoneQuality Knowledge Script job, the managed object begins collecting voice quality statistics. The managed object stops collecting statistics approximately one minute after the PhoneQuality job stops. If you attempt to delete a phone on which collection is still occurring, the following event is raised:

The phone(s) could not be removed because one or more phones are currently being monitored by the PhoneQuality Knowledge Script. You must stop the PhoneQuality job(s) before removing the phones.

NOTE:Unlike other proxy-based AppManager modules, AppManager for Avaya Communication Manager supports only one AppManager repository (QDB) per proxy agent computer. This limitation ensures the accuracy of monitoring phones with the PhoneQuality script. The list of phones for monitoring with this script does not differentiate between repositories; if multiple repositories were allowed, you could very well monitor the wrong set of phones for a given repository.

3.18.1 Prerequisite

Run AddPhone to add phones to be monitored. The PhoneQuality script is not available until after you run the AddPhone script.

3.18.2 Resource Object

AvayaCM Station object

NOTE:Do not monitor more than 100 active phone (station) objects in one cluster or across multiple clusters.

3.18.3 Default Schedule

By default, this script runs on an asynchronous schedule.

3.18.4 Setting Parameter Values

Set the following parameters as needed:

Description	How To Set It
General Settings
Job Failure Notification
Event severity when job fails	Set the event severity level, from 1 to 40, to indicate the importance of the failure of the PhoneQuality job. The default is 5.
Monitor Settings
Data collection interval for voice quality metrics	Specify the interval at which data points are generated for voice quality metrics. The default is 30 seconds. The minimum is 15 seconds. NOTE:Communication Manager sends RTCP packets to the proxy computer in almost real-time. If your data collection interval is the default, 30 seconds, and you are monitoring 100 phones and collecting data for only one metric, such as MOS, AppManager will generate about three data points per second (100 phones / 30 seconds). With all five metrics enabled, AppManager will generate about 16 data points per second. If you change to a more frequent data collection interval, for example every 15 seconds, AppManager will generate about 32 data points per second.
Additional fixed delay for MOS/R-Value calculation	Enter a length of delay (in milliseconds) that you want to add to a call. This delay is in addition to the three other types of delay associated with calculating MOS and R-Value: Network delay in one direction. Packetization delay. This value is fixed, based on the type of codec being used. Jitter buffer delay. This value is fixed, based on the type and size of the jitter buffer being used. The default is 0 milliseconds.
Monitor Interval MOS
Event Notification
Raise event if interval MOS falls below threshold?	Select Yes to raise an event if the value of interval MOS falls below the threshold that you set. The default is Yes. Interval MOS is the MOS value measured during the data collection interval you set. It is not the MOS value at the instance of data collection.
Threshold - Minimum interval MOS	Specify the lowest interval MOS value that can be calculated before an event is raised. The default is 3.60.
Event severity when interval MOS falls below threshold	Set the event severity level, from 1 to 40, to indicate the importance of an event in which the interval MOS value falls below the threshold you set. The default is 5.
Data Collection
Collect data for interval MOS?	Select Yes to collect interval MOS data for charts and graphs. When enabled, data collection returns the value of interval MOS measured during the data collection interval. The default is Yes.
Monitor Interval R-Value
Event Notification
Raise event if interval R-Value falls below threshold?	Select Yes to raise an event if interval R-Value falls below the threshold that you set. The default is Yes. Interval R-Value is the R-Value measured during the data collection interval you set. It is not the R-Value at the instance of data collection.
Threshold - Minimum interval R-value	Enter the lowest interval R-Value that can be calculated before an event is raised. The default is 70.
Event severity when interval R-value falls below threshold	Set the event severity level, from 1 to 40, to indicate the importance of an event in which interval R-Value falls below the threshold you set. The default is 5.
Data Collection
Collect data for interval R-Value?	Select Yes to collect interval R-Value data for charts and graphs. When enabled, data collection returns the value of interval R-Value measured during the data collection interval. The default is unselected.
Monitor Interval Jitter
Event Notification
Raise event if interval jitter exceeds threshold?	Select Yes to raise an event if the amount of interval jitter exceeds the threshold that you set. The default is Yes. Interval jitter is the jitter value measured during the data collection interval you set. It is not the jitter value at the instance of data collection.
Threshold - Maximum interval jitter	Specify the highest amount of interval jitter that can be achieved before an event is raised. The default is 60 milliseconds.
Event severity when interval jitter exceeds threshold	Set the event severity level, from 1 to 40, to indicate the importance of an event in which the amount of interval jitter exceeds the threshold you set. The default is 15.
Data Collection
Collect data for interval jitter?	Select Yes to collect interval jitter data for charts and graphs. When enabled, data collection returns the value of interval jitter measured during the data collection interval. The default is unselected.
Monitor Interval Latency
Event Notification
Raise event if interval latency exceeds threshold?	Select Yes to raise an event if the amount of interval latency exceeds the threshold that you set. The default is Yes. Interval latency is the latency value measured during the data collection interval you set. It is not the latency value at the instance of data collection.
Threshold - Maximum interval latency	Specify the highest amount of interval latency that can be achieved before an event is raised. The default is 400 milliseconds.
Event severity when interval latency exceeds threshold	Set the event severity level, from 1 to 40, to indicate the importance of an event in which the amount of interval latency exceeds the threshold you set. The default is 15.
Data Collection
Collect data for interval latency?	Select Yes to collect interval latency data for charts and graphs. When enabled, data collection returns the value of interval latency measured during the data collection interval. The default is unselected.
Monitor Interval Packet Loss
Event Notification
Raise event if interval packet loss exceeds threshold?	Select Yes to raise an event if the percentage of interval packet loss exceeds the threshold that you set. The default is Yes. Interval packet loss is the percentage of packet loss measured during the data collection interval you set. It is not the packet loss value at the instance of data collection.
Threshold - Maximum interval packet loss	Specify the highest percentage of interval packet loss that can occur before an event is raised. The default is 1.0%.
Event severity when interval packet loss exceeds threshold	Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of interval packet loss exceeds the threshold you set. The default is 15.
Data Collection
Collect data for interval packet loss?	Select Yes to collect interval packet loss data for charts and graphs. When enabled, data collection returns the percentage of interval packet loss measured during the data collection interval. The default is unselected.