-- extracted from draft-clark-avt-rtcpxrmib-00.txt -- at Wed Sep 15 06:23:05 2004 RTCPXR-MIB DEFINITIONS ::= BEGIN IMPORTS Counter32, Counter64, Gauge32, mib-2, Integer32, MODULE-IDENTITY, OBJECT-TYPE, Unsigned32 FROM SNMPv2-SMI OBJECT-GROUP, MODULE-COMPLIANCE FROM SNMPv2-CONF InterfaceIndex FROM IF-MIB ItuPerceivedSeverity FROM ITU-ALARM-TC; rtcpXrMIB MODULE-IDENTITY LAST-UPDATED "200409120000Z" ORGANIZATION "IETF AVT Working Group" DESCRIPTION "The managed objects of RTCP XR systems. Refer to RFC 3611, Real Time Control Protocol Extended Reports (RTCP XR) Section 4.7 VoIP Metrics" REVISION "200409120000Z" DESCRIPTION "Initial version of this MIB. Published as draft-clark-avt-rtcpxrmib-00.txt." ::= { mib-2 TBD } -- -- OBJECTS -- rtcpXrMIBObjects OBJECT IDENTIFIER ::= { rtcpXrMIB 1 } rtcpXrConformance OBJECT IDENTIFIER ::= { rtcpXrMIB 2 } rtcpXrEvents OBJECT IDENTIFIER ::= { rtcpXrMIB 3 } -- -- RTCP Extended Reports - Voice over IP Metrics -- -- Description -- This MIB provides basic voice quality monitoring capabilities -- for Voice-over-packet systems. The MIB contains 5 tables of -- information:- -- a table with one entry for each voice terminationPoint -- a table that defines the parameters associated with voice -- coders -- a table of call records with call identifying and quality -- information -- a table of extended call records with additional metrics -- a table of Termination Point groups with one entry per -- logical group rtcpXrVoipTable OBJECT-TYPE SYNTAX SEQUENCE OF rtcpXrVoipEntry ACCESS not-accessible STATUS current DESCRIPTION "Table of information about a receiver or receivers of RTCP XR session data. RTP hosts that receive RTCP XR session packets MUST create an entry in this table for that receiver/sender pair. RTP hosts that send RTCP XR session packets MAY create an entry in this table for each receiver to their stream using RTCP XR feedback from the RTP group. " ::= { rtcpXrMIBObjects 1 } rtcpXrVoipEntry OBJECT-TYPE SYNTAX rtcpXrVoipEntry STATUS current DESCRIPTION "An entry in the table of call records. A row in this table is created for each RTP session endpoint participating." INDEX { rtcpXrVoipIndex } ::= { rtcpXrVoipTable 1 } rtcpXrVoipEntry ::= SEQUENCE { rtcpXrVoipIndex INTEGER, rtcpXrVoipCallIdentifier OCTET STRING, rtcpXrVoipSessionIdentifier OCTET STRING, rtcpXrVoipSourceIPaddress OCTET STRING, rtcpXrVoipSourceIdentifier OCTET STRING, rtcpXrVoipDestinationIPaddress OCTET STRING, rtcpXrVoipDestinationIdentifier OCTET STRING, rtcpXrVoipVocoderType OCTET STRING, rtcpXrVoipFrameSize INTEGER, rtcpXrVoipSmapleRate INTEGER, rtcpXrVoipCallDurationMs INTEGER, rtcpXrVoipNetworkLossRate INTEGER, rtcpXrVoipAverageDiscardRate INTEGER, rtcpXrVoipBurstLossDensity INTEGER, rtcpXrVoipBurstLenMs INTEGER, rtcpXrVoipGapLossDensity INTEGER, rtcpXrVoipGapLenMs INTEGER, rtcpXrVoipAverageOneWayDelay INTEGER, rtcpXrVoipEndSystemDelay INTEGER, rtcpXrVoipNoiseLeveldBm INTEGER, rtcpXrVoipSignalLeveldBm INTEGER, rtcpXrVoipLocalRERLdB INTEGER, rtcpXrVoipConversationalR INTEGER, rtcpXrVoipListeningR INTEGER, rtcpXrVoipListeningMOSLQ INTEGER, rtcpXrVoipConversationalMOSCQ INTEGER, rtcpXrVoipPlcType INTEGER, rtcpXrVoipJitterBufferAdaptationMode INTEGER, rtcpXrVoipJitterBufferAdaptationRate INTEGER, rtcpXrVoipJitterBufferAverageDelay INTEGER, rtcpXrVoipJitterBufferMaximumDelay INTEGER, rtcpXrVoipJitterBufferSize INTEGER } rtcpXrVoipIndex OBJECT-TYPE SYNTAX INTEGER (0..65535) STATUS current DESCRIPTION "Index for this call." ::= { rtcpXrVoipEntry 1 } rtcpXrVoipCallIdentifier OBJECT-TYPE SYNTAX OCTET STRING STATUS optional DESCRIPTION "Call identifier for this call." ::= { rtcpXrVoipEntry 2 } rtcpXrVoipSessionIdentifier OBJECT-TYPE SYNTAX OCTET STRING STATUS optional DESCRIPTION "Unique identifier for this session. Where a billing record correlation identifer is not available for a particular call, another identifier such as SSRC can be used." ::= { rtcpXrVoipEntry 3 } rtcpXrVoipSourceIPaddress OBJECT-TYPE SYNTAX OCTET STRING STATUS optional DESCRIPTION "Source IP address for this session." ::= { rtcpXrVoipEntry 4 } rtcpXrVoipSourceIdentifierType OBJECT-TYPE SYNTAX INTEGER { dialedNumber(0), urlId (1) } DESCRIPTION "Defines the type of address in parameter rtcpXrVoipSourceIdentifier" ::= { rtcpXrVoipEntry 5 } rtcpXrVoipSourceIdentifier OBJECT-TYPE SYNTAX OCTET STRING STATUS optional DESCRIPTION "Alternate identifier to the IP address. This can be E.164, DN,or URL." ::= { rtcpXrVoipEntry 6 } rtcpXrVoipDestinationIPaddress OBJECT-TYPE SYNTAX OCTET STRING STATUS current DESCRIPTION "Source IP address for this session." ::= { rtcpXrVoipEntry 7 } rtcpXrVoipDestinationIdentifierType OBJECT-TYPE SYNTAX INTEGER { dialedNumber(0), urlId (1) } DESCRIPTION "Defines the type of address in parameter rtcpXrVoipDestinationIdentifier" ::= { rtcpXrVoipEntry 8 } rtcpXrVoipDestinationIdentifier OBJECT-TYPE SYNTAX OCTET STRING STATUS current DESCRIPTION "Alternate identifier to the IP address. This can be E.164, DN, or URL." ::= { rtcpXrVoipEntry 9 } rtcpXrVoipVocoderType OBJECT-TYPE SYNTAX OCTET STRING STATUS current DESCRIPTION "Vocoder type used on this call." ::= { rtcpXrVoipEntry 10 } rtcpXrVoipFrameSize OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Companion information to vocoder type. This represents the size of the frames within the RTP packets at the time the information is capture." ::= { rtcpXrVoipEntry 11 } rtcpXrVoipSampleRate OBJECT-TYPE SYNTAX OCTET STRING STATUS current DESCRIPTION "Companion information to vocoder type. This represents the rate at which the frames where sampled. ::= { rtcpXrVoipEntry 12 } rtcpXrVoipCallDurationMs OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Duration of call in milliseconds." ::= { rtcpXrVoipEntry 13 } rtcpXrVoipStartTimestamp OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The timestamp captured at the start of the session." ::= { rtcpXrVoipEntry 14 } rtcpXrVoipEndTimestamp OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "The timestamp captured at the end of the session." ::= { rtcpXrVoipEntry 15 } rtcpXrVoipNetworkLossRate OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Average rate of network packet loss (RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 16 } rtcpXrVoipAverageDiscardRate OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Average rate of discards due to jitter(RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 17 } rtcpXrVoipBurstLossDensity OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Density of loss and discarded packets during burst periods. (see RFC3611 Section 4.7)" ::= { rtcpXrVoipEntry 18 } rtcpXrVoipBurstLenMs OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Average length of bursts in milliseconds (RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 19 } rtcpXrVoipGapLossDensity OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Density of loss and discarded packets during gap periods (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 20 } rtcpXrVoipGapLenMs OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Average length of gaps in milliseconds (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 21 } rtcpXrVoipAverageOneWayDelay OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Average (symmetric) one way RTCP delay on call. A value of zero may indicate that this value has not yet been determined. (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 22 } rtcpXrVoipEndSystemDelay OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Average end system delay on call. A value of zero may indicate that this value has not yet been determined (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 23 } rtcpXrVoipNoiseLeveldBm OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Measured received silent period noise level in dBm (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 24 } rtcpXrVoipSignalLeveldBm OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Measured received signal level during talkspurts in dBm (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 25 } rtcpXrVoipLocalRERLdB OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Residual Echo Return Loss measured at this endpoint (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 26 } rtcpXrVoipConversationalRCQ OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Conversational quality R factor for this call (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 27 } rtcpXrVoipListeningMOSLQ OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Estimated listening quality MOS for this call (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 28 } rtcpXrVoipConversationalMOSCQ OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Estimated conversational quality MOS for this call (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 29 } rtcpXrVoipPlcType OBJECT-TYPE SYNTAX INTEGER { disabled(1), enhanced(2), standard(3), unspecified (4)} STATUS current DESCRIPTION "Defines type of packet loss concealment used on this call (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 30 } rtcpXrVoipJitterBufferAdaptationMode OBJECT-TYPE SYNTAX INTEGER { reserved (1), nonAdaptive (2), adaptive (3), unknown (4) } STATUS current DESCRIPTION "Defines if jitter buffer is in fixed or adaptive mode (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 31 } rtcpXrVoipJitterBufferAdaptationRate OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Estimated adaptation rate of jitter buffer (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 32 } rtcpXrVoipJitterBufferAverageDelay OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Average size of jitter buffer in mS (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 33 } rtcpXrVoipJitterBufferMaximumDelay OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Maximum delay through jitter buffer at current size in mS (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 34 } rtcpXrVoipJitterBufferSize OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Absolute maximum size jitter buffer can reach in mS (see RFC3611 Section 4.7)." ::= { rtcpXrVoipEntry 35 } -- Notifications rtcpXrVoipNotifications OBJECT IDENTIFIER ::= { rtcpXrEvents 0 } -- -- RTCP XR Threshold Violation Notification -- -- RTCP XR issues event notification when two conditions are met: -- 1) The notification is enabled for a specified endpoint -- 2) The voice quality falls below the specified threshold -- rtcpXrVoipThresholdViolation TRAP-TYPE ENTERPRISE rtcpXrVoipNotifications VARIABLES { rtcpXrVoipAlertSeverity, rtcpXrVoipAlertType, rtcpXrVoipIndex} DESCRIPTION "Notification that voice quality has changed Sent immediately when the condition is detected." ::= 1 -- -- Definition of Alert Severity: import from Alarm MIB -- rtcpXrVoipAlertSeverity OBJECT-TYPE SYNTAX ItuPerceivedSeverity STATUS current DESCRIPTION "The severity of the alert as defined in ITU-T X.733." ::= { rtcpXrVoipEntry 36 } -- -- -- The definition of the syntax is as follows: -- -- ItuPerceivedSeverity ::= TEXTUAL-CONVENTION -- STATUS current -- DESCRIPTION -- "ITU perceived severity values" -- REFERENCE -- "ITU Recommendation M.3100, 'Generic Network -- Information Model', 1995 -- ITU Recommendation X.733, 'Information Technology -- - Open Systems Interconnection - System Management: -- Alarm Reporting Function', 1992" -- SYNTAX INTEGER -- { -- cleared (1), -- indeterminate (2), -- critical (3), -- major (4), -- minor (5), -- warning (6) -- } -- -- -- In use with these alarms, the cleared value will not be used -- due the size of alarms. rtcpXrVoipAlertType OBJECT-TYPE SYNTAX OCTET STRING ACCESS read-only STATUS current DESCRIPTION "Text description of the type of alert. Where possible, this parameter should be populated with the correct rtcpXrVoipEventsEntry" ::= { rtcpXrVoipEntry 37 } -- NOTE: this END was not present in draft-clark-avt-rtcpxrmib-00.txt, -- but this does appear to be the end of the MIB. -- (the next line is '4. Security Considerations') END -- -- Copyright (C) The Internet Society (2004). This document is subject -- to the rights, licenses and restrictions contained in BCP 78, and -- except as set forth therein, the authors retain all their rights -- -- This document and translations of it may be copied and furnished to -- others, and derivative works that comment on or otherwise explain it -- or assist in its implementation may be prepared, copied, published -- and distributed, in whole or in part, without restriction of any -- kind, provided that the above copyright notice and this paragraph are -- included on all such copies and derivative works. However, this -- document itself may not be modified in any way, such as by removing -- the copyright notice or references to the Internet Society or other -- Internet organizations, except as needed for the purpose of -- developing Internet standards in which case the procedures for -- copyrights defined in the Internet Standards process must be -- followed, or as required to translate it into languages other than -- English. -- -- The limited permissions granted above are perpetual and will not be -- revoked by the Internet Society or its successors or assigns. -- -- This document and the information contained herein is provided on an -- "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING -- TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING -- BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION -- HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF -- MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.