1-- *****************************************************************
2-- CISCO-RTP-METRICS-MIB
3-- Definitions of managed objects describing RTP flow metrics.
4--
5-- October 2008, Patrick R. Gili
6--
7-- Copyright (c) 2008-2009 by Cisco Systems Inc.
8-- All rights reserved.
9-- *****************************************************************
10
11CISCO-RTP-METRICS-MIB DEFINITIONS ::= BEGIN
12
13IMPORTS
14    MODULE-IDENTITY,
15    OBJECT-IDENTITY,
16    OBJECT-TYPE,
17    Counter64,
18    Gauge32
19        FROM SNMPv2-SMI
20    MODULE-COMPLIANCE,
21    OBJECT-GROUP
22        FROM SNMPv2-CONF
23    TimeStamp
24        FROM SNMPv2-TC
25    ReportIntervalCount
26        FROM CISCO-REPORT-INTERVAL-TC-MIB
27    FlowMetricScale,
28    FlowMetricPrecision,
29    FlowMetricValue
30        FROM CISCO-FLOW-MONITOR-TC-MIB
31    cfmFlowMonitorId,
32    cfmFlowId,
33    cfmFlowMetricsIntNumber
34        FROM CISCO-FLOW-MONITOR-MIB
35    ciscoMgmt
36        FROM CISCO-SMI;
37
38
39ciscoRtpMetricsMIB MODULE-IDENTITY
40    LAST-UPDATED    "200906170000Z"
41    ORGANIZATION    "Cisco Systems, Inc."
42    CONTACT-INFO
43            "Cisco Systems
44            Customer Service
45
46            Postal:  170 W Tasman Drive
47            San Jose, CA 95134
48
49            Tel:  +1 800 553-NETS
50
51            E-mail:  cs-snmp@cisco.com"
52    DESCRIPTION
53        "This MIB module defines objects that describe the quality
54        metrics of RTP streams, similar to those described by an RTCP
55        Receiver Report packet [RFC3550].
56
57        GLOSSARY
58        ============
59
60        Expected Packets - this value is formally defined as the
61            extended last sequence number received less the initial
62            sequence number received.
63
64            An extended last sequence number is a 32-bit value, where
65            the most significant 16-bit word indicates the number of
66            sequence number cycles, and the least significant 16-bit
67            word indicates the highest sequence number received.
68
69        Flow Monitor - a hardware or software entity that classifies
70            traffic flows, collects flow data, and periodically
71            computes flow metrics.
72
73        Flow Metric - a measurement that reflects the quality of a
74            traffic flow.
75
76        Inter-Arrival Jitter - an estimate of the statistical variance
77            of the RTP data packet inter-arrival time.
78
79            The inter-arrival jitter, J, is formally defined to be the
80            mean deviation (smoothed absolute value) of the difference,
81            D, in packet spacing at the flow monitor compared to the
82            sender for a pair of packets.  This is equivalent to the
83            difference in the relative transit time for two packets; the
84            relative transit time is the difference between a packet's
85            RTP timestamp and the device's clock at the time of arrival
86            (measured in the same units):
87
88                D(i,j) = (Rj - Ri) - (Sj - Si) = (Rj - Sj) - (Ri - Si)
89
90            where Si is the RTP timestamp from packet i, and Ri is the
91            time of arrival in RTP timestamp units for packet i.
92
93            The inter-arrival jitter SHOULD be calculated continuously
94            for each RTP data packet received from source SSRCn, using
95            this equation to compute difference for each packet and the
96            previous packet (in order of arrival, not necessarily in
97            sequence).
98
99                                |D(i-1,i)| - J(i-1)
100                J(i) = J(i-1) + -------------------
101                                         16
102
103        Measurement Interval - the length of time over which a flow
104            monitor collects data related to a traffic flow, after which
105            the flow monitor computes flow metrics using the collected
106            data.
107
108        Loss Distance - the difference between the sequence numbers
109            delimiting the start of two consecutive loss intervals.
110
111            Consider the following sequence of RTP data packets:
112
113                111111 111222    2233   33333 444  444 5
114                123456x890123xxxx8901xxx56789x123xx678x0
115
116                      ^      ^       ^       ^   ^    ^
117                      |      |       |       |   |    |
118                     LI1    LI2     LI3     LI4 LI5  LI6
119
120              Loss Interval | Loss Distance
121             ===============+===============
122                     1      |
123                     2      |      7
124                     3      |      8
125                     4      |      8
126                     5      |      4
127                     6      |      5
128
129        Loss Fraction - the fraction of RTP data packets from source
130            SSRCn lost during a measurement interval, expressed as a
131            fixed-point number:
132
133                      Li
134                Fi = ----
135                      Ei
136
137            where Fi is the loss fraction for measurement interval i,
138            Li is the lost packets during measurement interval i, and
139            Ei is the expected packets during measurement interval i.
140
141            Observe that the number of packets lost includes packets
142            that are late or duplicates, and hence this number can can
143            have a theoretical theoretical value between negative
144            infinity and one.
145
146            The cumulative loss fraction is the fraction of RTP data
147            packets from source SSRCn lost over the duration
148            monitoring the flow:
149
150                       n
151                      sum [Li]
152                      i=1
153                Fn = ----------
154                       n
155                      sum [Ei]
156                      i=1
157
158            where Fn is the cumulative loss fraction over n measurement
159            intervals.
160
161        Loss Interval - an interval in which consecutive packet losses
162            were experienced.
163
164            Consider the following sequence of RTP data packets:
165
166                111111 111222    2233   33333 444  444 5
167                123456x890123xxxx8901xxx56789x123xx678x0
168
169                      ^      ^       ^       ^   ^    ^
170                      |      |       |       |   |    |
171                     LI1    LI2     LI3     LI4 LI5  LI6
172
173            LI1 through LI6 indicate the start of loss intervals
174            observed in this sequence.
175
176        Loss Interval Duration - the number of packets lost in a loss
177            interval.
178
179            Consider the following sequence of RTP data packets:
180
181                111111 111222    2233   33333 444  444 5
182                123456x890123xxxx8901xxx56789x123xx678x0
183
184                      ^      ^       ^       ^   ^    ^
185                      |      |       |       |   |    |
186                     LI1    LI2     LI3     LI4 LI5  LI6
187
188             Loss Interval | Duration
189            ===============+==========
190                    1      |    1
191                    2      |    4
192                    3      |    3
193                    4      |    1
194                    5      |    2
195                    6      |    1
196
197        Lost Packets - this value is formally defined as the number of
198            packets expected less the number of packets actually
199            received, where the number of packets received includes
200            those which are late or duplicates.
201
202        SSRCn - the SSRC identifier of the source.
203
204        Traffic Flow - a unidirectional stream of packets conforming to
205            a classifier.  For example, packets having a particular
206            source IP address, destination IP address, protocol type,
207            source port number, and destination port number.
208
209        Transit Time - the latency from the insertion into the network
210            to the flow monitor.  This value can be computed by taking
211            the difference between a packet's RTP timestamp and the
212            device's clock at the time of arrival (measured in the same
213            units).
214
215        REFERENCES
216        ==============
217
218        [RFC3550]   H. Schlzrinne, S. Casner, R. Frederick, V. Jacobson,
219                    'RTP: A Transport Protocol for Real-Time
220                    Applications', RFC-3550, July 2003."
221    REVISION        "200906170000Z"
222    DESCRIPTION
223        "The initial version of the MIB module."
224    ::= { ciscoMgmt 703 }
225
226
227-- **********************************************************************
228-- * Top-Level Trees                                                    *
229-- **********************************************************************
230
231ciscoRtpMetricsMIBNotifs  OBJECT IDENTIFIER
232    ::= { ciscoRtpMetricsMIB 0 }
233
234ciscoRtpMetricsMIBObjects  OBJECT IDENTIFIER
235    ::= { ciscoRtpMetricsMIB 1 }
236
237ciscoRtpMetricsMIBConform  OBJECT IDENTIFIER
238    ::= { ciscoRtpMetricsMIB 2 }
239
240ciscoRtpMetricsMIBIds  OBJECT IDENTIFIER
241    ::= { ciscoRtpMetricsMIB 3 }
242
243-- **********************************************************************
244-- * Objects                                                            *
245-- **********************************************************************
246
247cfmRtpMetrics  OBJECT IDENTIFIER
248    ::= { ciscoRtpMetricsMIBObjects 1 }
249
250
251cfmRtpMetricsTable OBJECT-TYPE
252    SYNTAX          SEQUENCE OF CfmRtpMetricsEntry
253    MAX-ACCESS      not-accessible
254    STATUS          current
255    DESCRIPTION
256        "This table contains aggregate data maintained by a flow
257        monitor for traffic flows for which it is computing RTP
258        metrics.
259
260        This table has an sparse dependent relationship on the
261        cfmFlowMetricsTable (defined by the CISCO-FLOW-MONITOR-MIB),
262        containing a row for each row in the cfmFlowMetricsTable having
263        a corresponding instance of cfmFlowMetricsCollected with the
264        'rtp' bit set to one."
265    ::= { cfmRtpMetrics 1 }
266
267cfmRtpMetricsEntry OBJECT-TYPE
268    SYNTAX          CfmRtpMetricsEntry
269    MAX-ACCESS      not-accessible
270    STATUS          current
271    DESCRIPTION
272        "An entry describes cumulative and aggregate RTP metrics for a
273        single traffic flow.
274
275        The devices creates a row in the cfmRtpMetricsTable when a flow
276        monitor starts monitoring a traffic flow and has been configured
277        to compute RTP metrics for the same traffic flow. Likewise, the
278        device destroys a row in the cfmRtpMetricsTable when the
279        corresponding flow monitor has ceased monitoring the traffic
280        flow (e.g., when a traffic flow has timed out)."
281    INDEX           {
282                        cfmFlowMonitorId,
283                        cfmFlowId
284                    }
285    ::= { cfmRtpMetricsTable 1 }
286
287CfmRtpMetricsEntry ::= SEQUENCE {
288        cfmRtpMetricsValid           BITS,
289        cfmRtpMetricsExpectedPkts    Counter64,
290        cfmRtpMetricsLostPkts        Counter64,
291        cfmRtpMetricsFracScale       FlowMetricScale,
292        cfmRtpMetricsFracPrecision   FlowMetricPrecision,
293        cfmRtpMetricsFrac            FlowMetricValue,
294        cfmRtpMetricsLIs             Counter64,
295        cfmRtpMetricsAvgLDScale      FlowMetricScale,
296        cfmRtpMetricsAvgLDPrecision  FlowMetricPrecision,
297        cfmRtpMetricsAvgLD           FlowMetricValue,
298        cfmRtpMetricsAvgLossDistance Gauge32,
299        cfmRtpMetricsJitterScale     FlowMetricScale,
300        cfmRtpMetricsJitterPrecision FlowMetricPrecision,
301        cfmRtpMetricsJitter          FlowMetricValue
302}
303
304cfmRtpMetricsValid OBJECT-TYPE
305    SYNTAX          BITS {
306                        expectedPkts(0),
307                        lostPkts(1),
308                        lossFraction(2),
309                        lossIntervals(3),
310                        avgLossDuration(4),
311                        avgLossDistance(5),
312                        jitter(6)
313                    }
314    MAX-ACCESS      read-only
315    STATUS          current
316    DESCRIPTION
317        "This object indicates which metrics are valid for the traffic
318        flow:
319
320            'expectedPkts'
321                If this bit is set to '1', then the corresponding
322                instance of cfmRtpMetricsExpectedPkts is valid.
323
324            'lostPkts'
325                If this bit is set to '1', then the corresponding
326                instance of cfmRtpMetricsLostPkts is valid.
327
328            'lossFraction'
329                If this bit is set to '1', then the corresponding
330                instances of cfmRtpMetricsFracScale,
331                cfmRtpMetricsFracPrecision, and cfmRtpMetricsFrac are
332                valid.
333
334            'lossIntervals'
335                If this bit is set to '1', then the corresponding
336                instance of cfmRtpMetricsLIs is valid.
337
338            'avgLossIntervalDuration'
339                If this bit is set to '1', then the corresponding
340                instances of cfmRtpMetricsAvgLDScale,
341                cfmRtpMetricsAvgLDPrecision, and cfmRtpMetricsAvgLD are
342                valid.
343
344            'avgLossDistance'
345                If this bit is set to '1', then the corresponding
346                instance of cfmRtpMetricsAvgLossDistance is valid.
347
348            'jitter'
349                If this bit is set to '1', then the corresponding
350                instances of cfmRtpMetricsJitterScale,
351                cfmRtpMetricsJitterPrecision, and cfmRtpMetricsJitter
352                are valid."
353    ::= { cfmRtpMetricsEntry 1 }
354
355cfmRtpMetricsExpectedPkts OBJECT-TYPE
356    SYNTAX          Counter64
357    UNITS           "packets"
358    MAX-ACCESS      read-only
359    STATUS          current
360    DESCRIPTION
361        "This object indicates the number of RTP packets expected for
362        the traffic flow."
363    ::= { cfmRtpMetricsEntry 2 }
364
365cfmRtpMetricsLostPkts OBJECT-TYPE
366    SYNTAX          Counter64
367    UNITS           "packets"
368    MAX-ACCESS      read-only
369    STATUS          current
370    DESCRIPTION
371        "This object indicates the number of RTP packets lost for the
372        traffic flow."
373    ::= { cfmRtpMetricsEntry 3 }
374
375cfmRtpMetricsFracScale OBJECT-TYPE
376    SYNTAX          FlowMetricScale
377    MAX-ACCESS      read-only
378    STATUS          current
379    DESCRIPTION
380        "This object indicates the scaling factor for the corresponding
381        instance of cfmRtpMetricsFrac."
382    ::= { cfmRtpMetricsEntry 4 }
383
384cfmRtpMetricsFracPrecision OBJECT-TYPE
385    SYNTAX          FlowMetricPrecision
386    MAX-ACCESS      read-only
387    STATUS          current
388    DESCRIPTION
389        "This object indicates the precision for the corresponding
390        instance of cfmRtpmetricsFrac."
391    ::= { cfmRtpMetricsEntry 5 }
392
393cfmRtpMetricsFrac OBJECT-TYPE
394    SYNTAX          FlowMetricValue
395    MAX-ACCESS      read-only
396    STATUS          current
397    DESCRIPTION
398        "This object indicates the loss fraction for traffic flow."
399    ::= { cfmRtpMetricsEntry 6 }
400
401cfmRtpMetricsLIs OBJECT-TYPE
402    SYNTAX          Counter64
403    MAX-ACCESS      read-only
404    STATUS          current
405    DESCRIPTION
406        "This object indicates the number of loss intervals for the
407        traffic flow."
408    ::= { cfmRtpMetricsEntry 7 }
409
410cfmRtpMetricsAvgLDScale OBJECT-TYPE
411    SYNTAX          FlowMetricScale
412    MAX-ACCESS      read-only
413    STATUS          current
414    DESCRIPTION
415        "This object indicates the scaling factor for the corresponding
416        instance of cfmRtpMetricsAvgLD."
417    ::= { cfmRtpMetricsEntry 8 }
418
419cfmRtpMetricsAvgLDPrecision OBJECT-TYPE
420    SYNTAX          FlowMetricPrecision
421    MAX-ACCESS      read-only
422    STATUS          current
423    DESCRIPTION
424        "This object indicates the precision for the corresponding
425        instance of cfmRtpMetricsAvgLD."
426    ::= { cfmRtpMetricsEntry 9 }
427
428cfmRtpMetricsAvgLD OBJECT-TYPE
429    SYNTAX          FlowMetricValue
430    MAX-ACCESS      read-only
431    STATUS          current
432    DESCRIPTION
433        "This object indicates the average loss duration for the
434        traffic flow."
435    ::= { cfmRtpMetricsEntry 10 }
436
437cfmRtpMetricsAvgLossDistance OBJECT-TYPE
438    SYNTAX          Gauge32
439    MAX-ACCESS      read-only
440    STATUS          current
441    DESCRIPTION
442        "This object indicates the average loss distance for the
443        traffic flow."
444    ::= { cfmRtpMetricsEntry 11 }
445
446cfmRtpMetricsJitterScale OBJECT-TYPE
447    SYNTAX          FlowMetricScale
448    MAX-ACCESS      read-only
449    STATUS          current
450    DESCRIPTION
451        "This object indicates the scaling factor for the corresponding
452        instance of cfmRtpMetricsJitter."
453    ::= { cfmRtpMetricsEntry 12 }
454
455cfmRtpMetricsJitterPrecision OBJECT-TYPE
456    SYNTAX          FlowMetricPrecision
457    MAX-ACCESS      read-only
458    STATUS          current
459    DESCRIPTION
460        "This object indicates the precision for the corresponding
461        instance of cfmRtpMetricsJitter."
462    ::= { cfmRtpMetricsEntry 13 }
463
464cfmRtpMetricsJitter OBJECT-TYPE
465    SYNTAX          FlowMetricValue
466    UNITS           "seconds"
467    MAX-ACCESS      read-only
468    STATUS          current
469    DESCRIPTION
470        "This object indicates the inter-arrival jitter for the traffic
471        flow."
472    ::= { cfmRtpMetricsEntry 14 }
473
474
475
476cfmRtpMetricsTableChanged OBJECT-TYPE
477    SYNTAX          TimeStamp
478    MAX-ACCESS      read-only
479    STATUS          current
480    DESCRIPTION
481        "This object indicates the value of sysUpTime the last time the
482        device created/destroyed a row in the cfmRtpMetricsTable."
483    ::= { cfmRtpMetrics 2 }
484
485cfmRtpMetricsIntTable OBJECT-TYPE
486    SYNTAX          SEQUENCE OF CfmRtpMetricsIntEntry
487    MAX-ACCESS      not-accessible
488    STATUS          current
489    DESCRIPTION
490        "This table contains historic RTP metrics for the traffic flows
491        monitored by each of the flow monitors supported by the device.
492
493        This table has an sparse dependent relationship on the
494        cfmFlowMetricsIntTable (defined by the CISCO-FLOW-MONITOR-MIB),
495        containing a row for each row in the cfmFlowMetricsIntTable
496        having a corresponding instance of cfmFlowMetricsCollected with
497        the 'rtp' bit set to one."
498    ::= { cfmRtpMetrics 3 }
499
500cfmRtpMetricsIntEntry OBJECT-TYPE
501    SYNTAX          CfmRtpMetricsIntEntry
502    MAX-ACCESS      not-accessible
503    STATUS          current
504    DESCRIPTION
505        "An entry describes RTP metrics collected for a previous
506        measurement interval for a corresponding traffic flow."
507    INDEX           {
508                        cfmFlowMonitorId,
509                        cfmFlowId,
510                        cfmFlowMetricsIntNumber
511                    }
512    ::= { cfmRtpMetricsIntTable 1 }
513
514CfmRtpMetricsIntEntry ::= SEQUENCE {
515        cfmRtpMetricsIntValid            BITS,
516        cfmRtpMetricsIntExpectedPkts     ReportIntervalCount,
517        cfmRtpMetricsIntLostPkts         ReportIntervalCount,
518        cfmRtpMetricsIntFracScale        FlowMetricScale,
519        cfmRtpMetricsIntFracPrecision    FlowMetricPrecision,
520        cfmRtpMetricsIntFrac             FlowMetricValue,
521        cfmRtpMetricsIntLIs              ReportIntervalCount,
522        cfmRtpMetricsIntAvgLDScale       FlowMetricScale,
523        cfmRtpMetricsIntAvgLDPrecision   FlowMetricPrecision,
524        cfmRtpMetricsIntAvgLD            FlowMetricValue,
525        cfmRtpMetricsIntAvgLossDistance  ReportIntervalCount,
526        cfmRtpMetricsIntJitterScale      FlowMetricScale,
527        cfmRtpMetricsIntJitterPrecision  FlowMetricPrecision,
528        cfmRtpMetricsIntJitter           FlowMetricValue,
529        cfmRtpMetricsIntTransitScale     FlowMetricScale,
530        cfmRtpMetricsIntTransitPrecision FlowMetricPrecision,
531        cfmRtpMetricsIntTransit          FlowMetricValue
532}
533
534cfmRtpMetricsIntValid OBJECT-TYPE
535    SYNTAX          BITS {
536                        expectedPkts(0),
537                        lostPkts(1),
538                        lossFraction(2),
539                        lossIntervals(3),
540                        avgLossIntervalDuration(4),
541                        avgLossDistance(5),
542                        maxJitter(6),
543                        maxMinTransit(7)
544                    }
545    MAX-ACCESS      read-only
546    STATUS          current
547    DESCRIPTION
548        "This object indicates which metrics are valid for the
549        measurement interval:
550
551            'expectedPkts'
552                If this bit is set to '1', then the corresponding
553                instance of cfmRtpMetricsIntExpectedPkts is valid.
554
555            'lostPkts'
556                If this bit is set to '1', then the corresponding
557                instance of cfmRtpMetricsIntLostPkts is valid.
558
559            'lossFraction'
560                If this bit is set to '1', then the corresponding
561                instances of cfmRtpMetricsIntFracScale,
562                cfmRtpMetricsIntFracPrecision, and cfmRtpMetricsIntFrac
563                are valid.
564
565            'lossIntervals'
566                If this bit is set to '1', then the corresponding
567                instance of cfmRtpMetricsIntLIs is valid.
568
569            'avgLossDuration'
570                If this bit is set to '1', then the corresponding
571                instances of cfmRtpMetricsIntAvgLDScale,
572                cfmRtpMetricsIntAvgLDPrecision, and
573                cfmRtpMetricsIntAvgLD are valid.
574
575            'avgLossDistance'
576                If this bit is set to '1', then the corresponding
577                instance of cfmRtpMetricsIntAvgLossDistance is valid.
578
579            'maxJitter'
580                If this bit is set to '1', then the corresponding
581                instances of cfmRtpMetricsIntJitterScale,
582                cfmRtpMetricsIntJitterPrecision, and
583                cfmRtpMetricsIntJitter are valid.
584
585            'maxMinTransit'
586                If this bit is set to '1', then the corresponding
587                instances of cfmRtpMetricsIntTransitScale,
588                cfmRtpMetricsIntTransitPrecision, and
589                cfmRtpMetricsIntTransit are valid."
590    ::= { cfmRtpMetricsIntEntry 1 }
591
592cfmRtpMetricsIntExpectedPkts OBJECT-TYPE
593    SYNTAX          ReportIntervalCount
594    UNITS           "packets"
595    MAX-ACCESS      read-only
596    STATUS          current
597    DESCRIPTION
598        "This object indicates the number of RTP packets expected for
599        the traffic flow during the measurement interval."
600    ::= { cfmRtpMetricsIntEntry 2 }
601
602cfmRtpMetricsIntLostPkts OBJECT-TYPE
603    SYNTAX          ReportIntervalCount
604    UNITS           "packets"
605    MAX-ACCESS      read-only
606    STATUS          current
607    DESCRIPTION
608        "This object indicates the number of RTP packets lost for the
609        traffic flow during the measurement interval."
610    ::= { cfmRtpMetricsIntEntry 3 }
611
612cfmRtpMetricsIntFracScale OBJECT-TYPE
613    SYNTAX          FlowMetricScale
614    MAX-ACCESS      read-only
615    STATUS          current
616    DESCRIPTION
617        "This object indicates the scaling factor for the corresponding
618        instance of cfmRtpMetricsIntFrac."
619    ::= { cfmRtpMetricsIntEntry 4 }
620
621cfmRtpMetricsIntFracPrecision OBJECT-TYPE
622    SYNTAX          FlowMetricPrecision
623    MAX-ACCESS      read-only
624    STATUS          current
625    DESCRIPTION
626        "This object indicates the precision for the corresponding
627        instance of cfmRtpmetricsIntFrac."
628    ::= { cfmRtpMetricsIntEntry 5 }
629
630cfmRtpMetricsIntFrac OBJECT-TYPE
631    SYNTAX          FlowMetricValue
632    MAX-ACCESS      read-only
633    STATUS          current
634    DESCRIPTION
635        "This object indicates the loss fraction for traffic flow
636        during the measurement interval."
637    ::= { cfmRtpMetricsIntEntry 6 }
638
639cfmRtpMetricsIntLIs OBJECT-TYPE
640    SYNTAX          ReportIntervalCount
641    MAX-ACCESS      read-only
642    STATUS          current
643    DESCRIPTION
644        "This object indicates the number of loss intervals for the
645        traffic flow during the measurement interval."
646    ::= { cfmRtpMetricsIntEntry 7 }
647
648cfmRtpMetricsIntAvgLDScale OBJECT-TYPE
649    SYNTAX          FlowMetricScale
650    MAX-ACCESS      read-only
651    STATUS          current
652    DESCRIPTION
653        "This object indicates the scaling factor for the corresponding
654        instance of cfmRtpMetricsIntAvgLD."
655    ::= { cfmRtpMetricsIntEntry 8 }
656
657cfmRtpMetricsIntAvgLDPrecision OBJECT-TYPE
658    SYNTAX          FlowMetricPrecision
659    MAX-ACCESS      read-only
660    STATUS          current
661    DESCRIPTION
662        "This object indicates the precision for the corresponding
663        instance of cfmRtpMetricsIntAvgLD."
664    ::= { cfmRtpMetricsIntEntry 9 }
665
666cfmRtpMetricsIntAvgLD OBJECT-TYPE
667    SYNTAX          FlowMetricValue
668    MAX-ACCESS      read-only
669    STATUS          current
670    DESCRIPTION
671        "This object indicates the average loss duration for the
672        traffic flow during the measurement interval."
673    ::= { cfmRtpMetricsIntEntry 10 }
674
675cfmRtpMetricsIntAvgLossDistance OBJECT-TYPE
676    SYNTAX          ReportIntervalCount
677    MAX-ACCESS      read-only
678    STATUS          current
679    DESCRIPTION
680        "This object indicates the average loss distance for the
681        traffic flow during the measurement interval."
682    ::= { cfmRtpMetricsIntEntry 11 }
683
684cfmRtpMetricsIntJitterScale OBJECT-TYPE
685    SYNTAX          FlowMetricScale
686    MAX-ACCESS      read-only
687    STATUS          current
688    DESCRIPTION
689        "This object indicates the scaling factor for the corresponding
690        instance of cfmRtpMetricsIntJitter."
691    ::= { cfmRtpMetricsIntEntry 12 }
692
693cfmRtpMetricsIntJitterPrecision OBJECT-TYPE
694    SYNTAX          FlowMetricPrecision
695    MAX-ACCESS      read-only
696    STATUS          current
697    DESCRIPTION
698        "This object indicates the precision for the corresponding
699        instance of cfmRtpMetricsIntJitter."
700    ::= { cfmRtpMetricsIntEntry 13 }
701
702cfmRtpMetricsIntJitter OBJECT-TYPE
703    SYNTAX          FlowMetricValue
704    MAX-ACCESS      read-only
705    STATUS          current
706    DESCRIPTION
707        "This object indicates the maximum inter-arrival jitter for the
708        traffic flow during the measurement interval."
709    ::= { cfmRtpMetricsIntEntry 14 }
710
711cfmRtpMetricsIntTransitScale OBJECT-TYPE
712    SYNTAX          FlowMetricScale
713    MAX-ACCESS      read-only
714    STATUS          current
715    DESCRIPTION
716        "This object indicates the scaling factor for the corresponding
717        instance of cfmRtpMetricsIntTransit."
718    ::= { cfmRtpMetricsIntEntry 15 }
719
720cfmRtpMetricsIntTransitPrecision OBJECT-TYPE
721    SYNTAX          FlowMetricPrecision
722    MAX-ACCESS      read-only
723    STATUS          current
724    DESCRIPTION
725        "This object indicates the precision for the corresponding
726        instance of cfmRtpMetricsIntTransit."
727    ::= { cfmRtpMetricsIntEntry 16 }
728
729cfmRtpMetricsIntTransit OBJECT-TYPE
730    SYNTAX          FlowMetricValue
731    MAX-ACCESS      read-only
732    STATUS          current
733    DESCRIPTION
734        "This object indicates the max-min transit time for the traffic
735        flow during the measurement interval.  The max-min transit is
736        the difference between the maximum and minimum transit times
737        observed for RTP data packets during the measurement interval."
738    ::= { cfmRtpMetricsIntEntry 17 }
739
740
741-- **********************************************************************
742-- * Object Identifiers                                                 *
743-- **********************************************************************
744
745cfmRtpMonitoredElements  OBJECT IDENTIFIER
746    ::= { ciscoRtpMetricsMIBIds 1 }
747
748
749cfmeRtpSsrcMismatch OBJECT-IDENTITY
750    STATUS          current
751    DESCRIPTION
752        "This object identifier represents the monitored element
753        describing the condition that arises when a flow monitor
754        detects a RTP SSRC mismatch for a traffic flow during the last
755        measurement interval."
756    ::= { cfmRtpMonitoredElements 1 }
757
758
759cfmeRtpCumulativeLostPkts OBJECT-IDENTITY
760    STATUS          current
761    DESCRIPTION
762        "This object identifier represents the monitored element
763        describing the cumulative number of lost RTP data packets for a
764        traffic flow (cfmRtpMetricsLostPkts)."
765    ::= { cfmRtpMonitoredElements 2 }
766
767
768cfmeRtpCumulativeLossFraction OBJECT-IDENTITY
769    STATUS          current
770    DESCRIPTION
771        "This object identifier represents the monitored element
772        describing the cumulative RTP loss fraction for a traffic flow
773        (cfmRtpMetricsFrac)."
774    ::= { cfmRtpMonitoredElements 3 }
775
776
777cfmeRtpCumulativeLossIntervals OBJECT-IDENTITY
778    STATUS          current
779    DESCRIPTION
780        "This object identifier represents the monitored element
781        describing the cumulative number of RTP loss intervals for a
782        traffic flow (cfmRtpMetricsLIs)."
783    ::= { cfmRtpMonitoredElements 4 }
784
785
786cfmeRtpCumulativeAvgLossDuration OBJECT-IDENTITY
787    STATUS          current
788    DESCRIPTION
789        "This object identifier represents the monitored element
790        describing the average duration of a RTP loss interval for a
791        traffic flow (cfmRtpMetricsAvgLD)."
792    ::= { cfmRtpMonitoredElements 5 }
793
794
795cfmeRtpCumulativeAvgLossDistance OBJECT-IDENTITY
796    STATUS          current
797    DESCRIPTION
798        "This object identifier represents the monitored element
799        describing the average RTP loss distance for a traffic flow
800        (cfmRtpMetricsAvgLossDistance)."
801    ::= { cfmRtpMonitoredElements 6 }
802
803
804cfmeRtpCumulativeJitter OBJECT-IDENTITY
805    STATUS          current
806    DESCRIPTION
807        "This object identifier represents the monitored element
808        describing the average inter-arrival jitter of RTP data
809        packets for a traffic flow (cfmRtpMetricsJitter)."
810    ::= { cfmRtpMonitoredElements 7 }
811
812
813cfmeRtpLostPkts OBJECT-IDENTITY
814    STATUS          current
815    DESCRIPTION
816        "This object identifier represents the monitored element
817        describing the number of lost RTP data packets for a traffic
818        flow during the last measurement interval
819        (cfmRtpMetricsIntLostPkts)."
820    ::= { cfmRtpMonitoredElements 8 }
821
822
823cfmeRtpLossFraction OBJECT-IDENTITY
824    STATUS          current
825    DESCRIPTION
826        "This object identifier represents the monitored element
827        describing the RTP loss fraction for a traffic flow during the
828        last measurement interval (cfmRtpMetricsIntFrac)."
829    ::= { cfmRtpMonitoredElements 9 }
830
831
832cfmeRtpLossIntervals OBJECT-IDENTITY
833    STATUS          current
834    DESCRIPTION
835        "This object identifier represents the monitored element
836        describing the number of RTP loss intervals for a traffic flow
837        during the last measurement interval (cfmRtpMetricsIntLIs)."
838    ::= { cfmRtpMonitoredElements 10 }
839
840
841cfmeRtpAvgLossDuration OBJECT-IDENTITY
842    STATUS          current
843    DESCRIPTION
844        "This object identifier represents the monitored element
845        describing the average duration of a RTP loss interval for
846        a traffic flow during the last measurement interval
847        (cfmRtpMetricsIntAvgLD)."
848    ::= { cfmRtpMonitoredElements 11 }
849
850
851cfmeRtpAvgLossDistance OBJECT-IDENTITY
852    STATUS          current
853    DESCRIPTION
854        "This object identifier represents the monitored element
855        describing the average RTP loss distance for a traffic flow
856        during the last measurement interval
857        (cfmRtpMetricsIntAvgLossDistance)."
858    ::= { cfmRtpMonitoredElements 12 }
859
860
861cfmeRtpMaxJitter OBJECT-IDENTITY
862    STATUS          current
863    DESCRIPTION
864        "This object identifier represents the monitored element
865        describing the maximum inter-arrival jitter of RTP data packets
866        for a traffic flow during the last measurement interval
867        (cfmRtpMetricsIntJitter)."
868    ::= { cfmRtpMonitoredElements 13 }
869
870
871cfmeRtpMaxMinTransit OBJECT-IDENTITY
872    STATUS          current
873    DESCRIPTION
874        "This object identifier represents the monitored element
875        describing the max-min transit time of the RTP data packets for
876        a traffic flow during the last measurement interval
877        (cfmRtpMetricsIntTransit)."
878    ::= { cfmRtpMonitoredElements 14 }
879
880-- **********************************************************************
881-- * Conformance                                                        *
882-- **********************************************************************
883
884ciscoRtpMetricsMIBCompliances  OBJECT IDENTIFIER
885    ::= { ciscoRtpMetricsMIBConform 1 }
886
887ciscoRtpMetricsMIBGroups  OBJECT IDENTIFIER
888    ::= { ciscoRtpMetricsMIBConform 2 }
889
890
891ciscoRtpMetricsCompliance01 MODULE-COMPLIANCE
892    STATUS          current
893    DESCRIPTION
894        "This compliance statement specifies the minimal requirements an
895        implementation must meet in order to claim full compliance with
896        the definition of the CISCO-RTP-METRICS-MIB."
897    MODULE          -- this module
898    MANDATORY-GROUPS { cfmRtpMetricsGroup }
899    ::= { ciscoRtpMetricsMIBCompliances 1 }
900
901-- **********************************************************************
902-- * Units of Conformance                                               *
903-- **********************************************************************
904
905cfmRtpMetricsGroup OBJECT-GROUP
906    OBJECTS         {
907                        cfmRtpMetricsValid,
908                        cfmRtpMetricsExpectedPkts,
909                        cfmRtpMetricsLostPkts,
910                        cfmRtpMetricsFracScale,
911                        cfmRtpMetricsFracPrecision,
912                        cfmRtpMetricsFrac,
913                        cfmRtpMetricsLIs,
914                        cfmRtpMetricsAvgLDScale,
915                        cfmRtpMetricsAvgLDPrecision,
916                        cfmRtpMetricsAvgLD,
917                        cfmRtpMetricsAvgLossDistance,
918                        cfmRtpMetricsJitterScale,
919                        cfmRtpMetricsJitterPrecision,
920                        cfmRtpMetricsJitter,
921                        cfmRtpMetricsTableChanged,
922                        cfmRtpMetricsIntValid,
923                        cfmRtpMetricsIntExpectedPkts,
924                        cfmRtpMetricsIntLostPkts,
925                        cfmRtpMetricsIntFracScale,
926                        cfmRtpMetricsIntFracPrecision,
927                        cfmRtpMetricsIntFrac,
928                        cfmRtpMetricsIntLIs,
929                        cfmRtpMetricsIntAvgLDScale,
930                        cfmRtpMetricsIntAvgLDPrecision,
931                        cfmRtpMetricsIntAvgLD,
932                        cfmRtpMetricsIntAvgLossDistance,
933                        cfmRtpMetricsIntJitterScale,
934                        cfmRtpMetricsIntJitterPrecision,
935                        cfmRtpMetricsIntJitter,
936                        cfmRtpMetricsIntTransitScale,
937                        cfmRtpMetricsIntTransitPrecision,
938                        cfmRtpMetricsIntTransit
939                    }
940    STATUS          current
941    DESCRIPTION
942        "This group contains objects that describe RTP metrics."
943    ::= { ciscoRtpMetricsMIBGroups 1 }
944
945END
946
947
948
949
950
951
952