VQMon Parameters

All of the parameters that configure Voice Quality Monitoring in the following table are located in the features.cfg template.

Table 1. Voice Quality Monitoring Parameters

Template

Parameter

Permitted Values

Change Causes Restart or Reboot

features.cfg

voice.qualityMonitoring.collector. alert.moslq.threshold.critical

Specify the threshold value of listening MOS score (MOS-LQ) that causes the phone to send a critical alert quality report. Configure the desired MOS value multiplied by 10.

For example, a value of 28 corresponds to the MOS score 2.8.

0 (default) - Critical alerts are not generated due to MOS-LQ.

0 - 40

Yes

features.cfg

voice.qualityMonitoring.collector. alert.moslq.threshold.warning

Specify the threshold value of listening MOS score (MOS-LQ) that causes phone to send a warning alert quality report. Configure the desired MOS value multiplied by 10.

For example, a configured value of 35 corresponds to the MOS score 3.5.

0 (default) - Warning alerts are not generated due to MOS-LQ.

0 - 40

Yes

features.cfg

voice.qualityMonitoring.collector. alert.delay.threshold.critical

Specify the threshold value of one way-delay (in milliseconds) that causes the phone to send a critical alert quality report.

One-way delay includes both network delay and end system delay.

0 (default) - Critical alerts are not generated due to one-way delay.

0 - 2000 ms

Yes

features.cfg

voice.qualityMonitoring.collector. alert.delay.threshold.warning

Specify the threshold value of one-way delay (in milliseconds) that causes the phone to send a critical alert quality report.

One-way delay includes both network delay and end system delay.

0 (default) - Warning alerts are not generated due to one-way delay.

0 - 2000 ms

Yes

features.cfg

voice.qualityMonitoring.collector. enable.periodic

0 (default) - Periodic quality reports are not generated.

1 - Periodic quality reports are generated throughout a call.

Yes

features.cfg

voice.qualityMonitoring.collector. enable.session

0 (default) - Quality reports are not generated at the end of each call.

1 - Reports are generated at the end of each call.

Yes

features.cfg

voice.qualityMonitoring.collector. enable.triggeredPeriodic

0 (default) - Alert states do not cause periodic reports to be generated.

1 - Periodic reports are generated if an alert state is critical.

2 - Period reports are generated when an alert state is either warning or critical.

Note: This parameter is ignored when voice.qualityMonitoring.collector.enable.periodic is 1, since reports are sent throughout the duration of a call.

Yes

features.cfg

voice.qualityMonitoring.collector. period

The time interval (in milliseconds) between successive periodic quality reports.

5 (default)

5 - 900 ms

Yes

features.cfg

voice.qualityMonitoring.collector. server.x.address

The server address of a SIP server (report collector) that accepts voice quality reports contained in SIP PUBLISH messages.

Set x to 1 as only one report collector is supported at this time.

NULL (default)

IP address or hostname

Yes

features.cfg

voice.qualityMonitoring.collector. server.x.outboundProxy.address

This parameter directs SIP messages related to voice quality monitoring to a separate proxy. No failover is supported for this proxy, and voice quality monitoring is not available for error scenarios.

NULL (default)

IP address or FQDN

No

features.cfg

voice.qualityMonitoring.collector. server.x.outboundProxy.port

Specify the port to use for the voice quality monitoring outbound proxy server.

0 (default)

0 to 65535

No

features.cfg

voice.qualityMonitoring.collector. server.x.outboundProxy.transport

Specify the transport protocol the phone uses to send the voice quality monitoring SIP messages.

DNSnaptr (default)

TCPpreferred

UDPOnly

TLS

TCPOnly

No

features.cfg

voice.qualityMonitoring.collector.server.x.port

Set the port of a SIP server (report collector) that accepts voice quality reports contained in SIP PUBLISH messages.

Set x to 1 as only one report collector is supported at this time.

5060 (default)

1 to 65535

No

features.cfg

voice.qualityMonitoring.failover.enable

1 (default) - The phone performs a failover when voice quality SIP PUBLISH messages are unanswered by the collector server.

0 - No failover is performed; note, however, that a failover is still triggered for all other SIP messages.

This parameter is ignored if voice.qualityMonitoring.collector.server.x.outboundProxy is enabled.

No

features.cfg

voice.qualityMonitoring.location

Specify the device location with a valid location string. If you do not configure a location value, you must use the default string ‘Unknown'.

Unknown (default)

No

features.cfg

voice.qualityMonitoring.rfc6035.enable

0 (default) - The existing draft implementation is supported.

1 - Complies with RFC6035.

No

features.cfg

voice.qualityMonitoring.rtcpxr.enable

0 (default) - RTCP-XR packets are not generated.

1 - The packets are generated.

Yes