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.
Prolog information
Metadata
Keywords:

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