rtp-stat threshold

Last Updated : Nov 06, 2012 |

Sets thresholds for QoS metrics sampled by the RTP statistics application. An event counter for each metric increments every time the metric exceeds its threshold during an RTP session. Use the rtp-stat threshold command also to set thresholds on averages of metrics. When an RTP session terminates, the RTP statistics application evaluates the average metrics and generates a QoS trap (if QoS traps are configured) if one or more of them is over its corresponding threshold. See also rtp-stat event-threshold.

Syntax

rtp-stat threshold {codec-loss|average-codec-loss|loss|average-loss|remote-loss| average-remote-loss} percentage

rtp-stat threshold {codec-rtt|rtt|jitter|remote-jitter} milliseconds

rtp-stat threshold echo-return-loss db

no rtp-stat threshold {all|codec-loss|average-codec-loss|codec-rtt|echo-return-loss|loss| average-loss|remote-loss|average-remote-loss|rtt|jitter|remote-loss| echo-return-loss}

Parameters

Parameter

Description

Possible Values

Default Value

codec-loss

Keyword specifying to set the percentage of time the codec plays fill frames due to lack of valid RTP frames. Possible causes include jitter and packet loss.

average-codec-loss

Keyword specifying to set the average codec loss measurement since the beginning of the RTP stream

loss

Keyword specifying to set the estimated network RTP packet loss.

The VoIP engine evaluates the current received packet loss every RTCP interval — usually 5 to 8 seconds. The VoIP engine postpones loss estimation until the next interval if the number of packets received is less than the minimum statistic window. The minimum statistic window is configured with the CLI command rtp-stat min-stat-win.

average-loss

Keyword specifying to set the average packet loss evaluation since the beginning of the RTP stream

remote-loss

Keyword specifying to set the network loss according to the remote RTP receiver. The device learns of the remote packet loss from received RTCP messages.

average-remote-loss

Keyword specifying to set the average remote network loss measurement since the beginning of the RTP stream

percentage

The percent value

0.0-100.0

codec-rtt

Keyword specifying to set an estimation of the overall Round Trip Time (RTT) on the voice-channel, including the network delay and internal delays.

Round Trip Time is the time taken for a message to get to the remote peer and back to the local receiver.

rtt

Keyword specifying to set the network RTT. This metric does not include internal delay. The device learns of the RTT from RTCP messages.

jitter

Keyword specifying to set the variation in delay of packet delivery to the local peer

remote-jitter

Keyword specifying to set the variation in delay of packet delivery to the remote peer. The device learns of the remote jitter from RTCP messages.

milliseconds

0-5000

echo-return-loss

Keyword specifying to set the echo cancellation loss on the TDM bus

db

The db value

0-100

all

Keyword specifying to clear all configured thresholds

User level

read-write

Context

general

Example

To set the echo return loss threshold to 5 dB:

Gxxx-001(super)# rtp-stat threshold echo-return-loss 5