idnits 2.17.1 draft-ietf-rmonmib-raqmon-mib-12.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** It looks like you're using RFC 3978 boilerplate. You should update this to the boilerplate described in the IETF Trust License Policy document (see https://trustee.ietf.org/license-info), which is required now. -- Found old boilerplate from RFC 3978, Section 5.1 on line 20. -- Found old boilerplate from RFC 3978, Section 5.5 on line 1781. -- Found old boilerplate from RFC 3979, Section 5, paragraph 1 on line 1792. -- Found old boilerplate from RFC 3979, Section 5, paragraph 2 on line 1799. -- Found old boilerplate from RFC 3979, Section 5, paragraph 3 on line 1805. ** This document has an original RFC 3978 Section 5.4 Copyright Line, instead of the newer IETF Trust Copyright according to RFC 4748. ** This document has an original RFC 3978 Section 5.5 Disclaimer, instead of the newer disclaimer which includes the IETF Trust according to RFC 4748. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- == No 'Intended status' indicated for this document; assuming Proposed Standard == The page length should not exceed 58 lines per page, but there was 38 longer pages, the longest (page 2) being 60 lines == It seems as if not all pages are separated by form feeds - found 0 form feeds but 39 pages Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- No issues found here. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the RFC 3978 Section 5.4 Copyright Line does not match the current year == The document seems to use 'NOT RECOMMENDED' as an RFC 2119 keyword, but does not include the phrase in its RFC 2119 key words list. -- The document seems to lack a disclaimer for pre-RFC5378 work, but may have content which was first submitted before 10 November 2008. If you have contacted all the original authors and they are all willing to grant the BCP78 rights to the IETF Trust, then this is fine, and you can ignore this comment. If not, you may need to add the pre-RFC5378 disclaimer. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (12 February 2006) is 6647 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) == Outdated reference: A later version (-16) exists of draft-ietf-rmonmib-raqmon-framework-15 -- No information found for draft-ietf-raqmon-pdu - is the name correct? Summary: 3 errors (**), 0 flaws (~~), 6 warnings (==), 8 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Internet Draft Anwar Siddiqui 3 Avaya Inc. 4 Dan Romascanu 5 Avaya 6 Eugene Golovinsky 7 BMC Software 8 12 February 2006 10 Real-time Application Quality of Service 11 Monitoring (RAQMON) MIB 13 15 Status of this Memo 17 By submitting this Internet-Draft, each author represents that any 18 applicable patent or other IPR claims of which he or she is aware 19 have been or will be disclosed, and any of which he or she becomes 20 aware will be disclosed, in accordance with Section 6 of BCP 79. 22 Internet-Drafts are working documents of the Internet Engineering 23 Task Force (IETF), its areas, and its working groups. Note that 24 other groups may also distribute working documents as Internet- 25 Drafts. 27 Internet-Drafts are draft documents valid for a maximum of six months 28 and may be updated, replaced, or obsoleted by other documents at any 29 time. It is inappropriate to use Internet-Drafts as reference 30 material or to cite them other than as "work in progress". 32 The list of current Internet-Drafts can be accessed at 33 http://www.ietf.org/1id-abstracts.html 35 The list of Internet-Draft Shadow Directories can be accessed at 36 http://www.ietf.org/shadow.html 38 Abstract 40 This memo defines a portion of the Management Information Base (MIB) 41 for use with network management protocols in the Internet community. 42 The document proposes an extension to the Remote Monitoring MIB - RFC 43 2819. In particular, it describes managed objects used for real-time 44 application Quality of Service (QoS) monitoring. 46 Distribution of this memo is unlimited. 48 Table of Contents 50 Status of this Memo 1 51 Abstract 1 52 1 Introduction 2 53 2 The Internet-Standard Management Framework 2 54 3 RAQMON Framework 2 55 4 Structure of the RAQMON MIB 3 56 5 RAQMON MIB Definitions 3 57 6 Security Considerations 34 58 7 IANA Considerations 36 59 8 Acknowledgements 36 60 Normative References 36 61 Informative References 37 62 Author's Address 37 63 Full Copyright Statement 38 64 IPR Disclosure Acknowledgement 38 66 1. Introduction 68 This memo defines a portion of the Management Information Base (MIB) 69 for use with network management protocols in the Internet community. 70 In particular, it extends [RFC2819] with managed objects used for 71 real-time application QOS monitoring. 73 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 74 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 75 document are to be interpreted as described in [RFC2119]. 77 2. The Internet-Standard Management Framework 79 For a detailed overview of the documents that describe the current 80 Internet-Standard Management Framework, please refer to section 7 of 81 RFC 3410 [RFC3410]. 83 Managed objects are accessed via a virtual information store, termed 84 the Management Information Base or MIB. MIB objects are generally 85 accessed through the Simple Network Management Protocol (SNMP). 86 Objects in the MIB are defined using the mechanisms defined in the 87 Structure of Management Information (SMI). This memo specifies a MIB 88 module that is compliant to the SMIv2, which is described in STD 58, 89 RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 90 [RFC2580]. 92 3. RAQMON Framework 93 As outlined in [RAQMON-FRAMEWORK], the RAQMON framework is based on 94 three entities: 96 - RAQMON Data Source (RDS) 98 - RAQMON Report Collector (RRC) 100 - RAQMON MIB Structure 102 The RAQMON MIB describes information passed between RRCs and a RAQMON 103 Application ("RAQMON manager"). 105 4. Structure of the RAQMON MIB 107 The RAQMON MIB module is composed of three MIB groups: raqmonSession, 108 raqmonException, and raqmonConfig. 110 The raqmonSession MIB group incorporates the following tables: 111 - The raqmonParticpantTable contains information about 112 participants in open and closed (terminated) sessions, including 113 parameters of the sessions they are involved in, aggregated since 114 the beginning of the session. 115 - The raqmonQosTable contains historical information about QoS 116 during sessions. The set of parameters represented in this table 117 is more restricted, but it includes historical per RAQMON report 118 information. 119 - The raqmonParticpantAddrTable maps participant addresses into 120 the indices of the raqmonParticpantTable. This table allows 121 management applications to find entries sorted by 122 raqmonParticipantAddr rather than raqmonParticipantStartDate. 124 The raqmonException MIB group includes a table of filters that 125 trigger notifications for sessions with poor QoS. 127 The raqmonConfig MIB group includes object that define the 128 configuration of the RAQMON Report Collector. 130 This MIB module MUST be implemented by RAQMON Report Collectors. 132 A separate MIB module is defined in [RAQMON-PDU] for mapping the 133 RAQMON PDUs onto an SNMP transport. The MIB module defined in 134 [RAQMON-PDU] is normally implemented by RAQMON Data Sources (RDS). 136 5. RAQMON MIB Definitions 138 The following MIB module IMPORTS definitions from the following: 139 SNMPv2-SMI [RFC2578] 140 SNMPv2-TC [RFC2579] 141 SNMPv2-CONF [RFC2580] 142 RMON-MIB [RFC2819] 143 SNMP-FRAMEWORK-MIB [RFC3411] 144 INET-ADDRESS-MIB [RFC4001] 146 It also uses REFERENCE clauses to refer to [RAQMON-FRAMEWORK]. 148 It also mentions [RFC3737] with respect to the MODULE-IDENTITY OID 149 allocation. 151 RAQMON-MIB DEFINITIONS ::= BEGIN 153 IMPORTS 154 OBJECT-GROUP, NOTIFICATION-GROUP, MODULE-COMPLIANCE 155 FROM SNMPv2-CONF 156 Integer32, Unsigned32, 157 Gauge32, Counter32, OBJECT-TYPE, 158 MODULE-IDENTITY, NOTIFICATION-TYPE 159 FROM SNMPv2-SMI 160 InetAddressType, InetAddress, InetPortNumber 161 FROM INET-ADDRESS-MIB 162 SnmpAdminString 163 FROM SNMP-FRAMEWORK-MIB 164 rmon 165 FROM RMON-MIB 166 RowStatus, TruthValue, DateAndTime, RowPointer 167 FROM SNMPv2-TC; 169 raqmonMIB MODULE-IDENTITY 170 LAST-UPDATED "200602120000Z" -- February 12, 2006 171 ORGANIZATION 172 "IETF RMON MIB Working Group" 173 CONTACT-INFO 174 "WG Charter: 175 http://www.ietf.org/html.charters/rmonmib-charter.html 177 Mailing lists: 178 General Discussion: rmonmib@ietf.org 179 To Subscribe: rmonmib-requests@ietf.org 180 In Body: subscribe your_email_address 182 Chair: Andy Bierman 183 Email: ietf@andybierman.com 185 Editor: Dan Romascanu 186 Avaya 187 Email: dromasca@avaya.com" 188 DESCRIPTION 189 "Real-Time Application QoS Monitoring MIB. 191 Copyright (c) The Internet Society (2006). 192 This version of this MIB module is part of 193 RFC yyyy; See the RFC itself for full legal notices." 195 -- RFC Ed.: replace yyyy with the actual RFC 196 -- number & remove this notice. 198 REVISION "200602120000Z" 199 DESCRIPTION 200 "Initial version, published as RFC yyyy." 201 -- RFC-Editor assigns yyyy 202 ::= { rmon 31 } 204 -- This OID allocation conforms to [RFC3737] 206 -- 207 -- Node definitions 208 -- 209 raqmonNotifications OBJECT IDENTIFIER ::= { raqmonMIB 0 } 211 raqmonSessionAlarm NOTIFICATION-TYPE 212 OBJECTS { raqmonParticipantAddr, 213 raqmonParticipantName, 214 raqmonParticipantPeerAddrType, 215 raqmonParticipantPeerAddr, 216 raqmonQoSEnd2EndNetDelay, 217 raqmonQoSInterArrivalJitter, 218 raqmonQosLostPackets, 219 raqmonQosRcvdPackets } 220 STATUS current 221 DESCRIPTION 222 "A notification generated by an entry in the 223 raqmonSessionExceptionTable." 224 ::= { raqmonNotifications 1 } 226 raqmonMIBObjects OBJECT IDENTIFIER ::= { raqmonMIB 1 } 228 raqmonSession OBJECT IDENTIFIER ::= { raqmonMIBObjects 1 } 230 raqmonParticipantTable OBJECT-TYPE 231 SYNTAX SEQUENCE OF RaqmonParticipantEntry 232 MAX-ACCESS not-accessible 233 STATUS current 234 DESCRIPTION 235 "This table contains information about participants in 236 both active and closed (terminated) sessions." 237 ::= { raqmonSession 1 } 239 raqmonParticipantEntry OBJECT-TYPE 240 SYNTAX RaqmonParticipantEntry 241 MAX-ACCESS not-accessible 242 STATUS current 243 DESCRIPTION 244 "Each row contains information for a single session 245 (application) run by one participant. 246 Indexation by the start time of the session aims 247 easing sorting by management applications. Agents MUST 248 NOT report identical start time for any two sessions 249 on the same host. 250 Rows are removed for inactive sessions 251 when implementation-specific age or space limits are 252 reached." 253 INDEX { raqmonParticipantStartDate, raqmonParticipantIndex } 254 ::= { raqmonParticipantTable 1 } 256 RaqmonParticipantEntry ::= 257 SEQUENCE { 258 raqmonParticipantStartDate DateAndTime, 259 raqmonParticipantIndex Unsigned32, 260 raqmonParticipantReportCaps BITS, 261 raqmonParticipantAddrType InetAddressType, 262 raqmonParticipantAddr InetAddress, 263 raqmonParticipantSendPort InetPortNumber, 264 raqmonParticipantRecvPort InetPortNumber, 265 raqmonParticipantSetupDelay Integer32, 266 raqmonParticipantName SnmpAdminString, 267 raqmonParticipantAppName SnmpAdminString, 268 raqmonParticipantQosCount Gauge32, 269 raqmonParticipantEndDate DateAndTime, 270 raqmonParticipantDestPayloadType Integer32, 271 raqmonParticipantSrcPayloadType Integer32, 272 raqmonParticipantActive TruthValue, 273 raqmonParticipantPeer RowPointer, 274 raqmonParticipantPeerAddrType InetAddressType, 275 raqmonParticipantPeerAddr InetAddress, 276 raqmonParticipantSrcL2Priority Integer32, 277 raqmonParticipantDestL2Priority Integer32, 278 raqmonParticipantSrcDSCP Integer32, 279 raqmonParticipantDestDSCP Integer32, 280 raqmonParticipantCpuMean Integer32, 281 raqmonParticipantCpuMin Integer32, 282 raqmonParticipantCpuMax Integer32, 283 raqmonParticipantMemoryMean Integer32, 284 raqmonParticipantMemoryMin Integer32, 285 raqmonParticipantMemoryMax Integer32, 286 raqmonParticipantNetRTTMean Integer32, 287 raqmonParticipantNetRTTMin Integer32, 288 raqmonParticipantNetRTTMax Integer32, 289 raqmonParticipantIAJitterMean Integer32, 290 raqmonParticipantIAJitterMin Integer32, 291 raqmonParticipantIAJitterMax Integer32, 292 raqmonParticipantIPDVMean Integer32, 293 raqmonParticipantIPDVMin Integer32, 294 raqmonParticipantIPDVMax Integer32, 295 raqmonParticipantNetOwdMean Integer32, 296 raqmonParticipantNetOwdMin Integer32, 297 raqmonParticipantNetOwdMax Integer32, 298 raqmonParticipantAppDelayMean Integer32, 299 raqmonParticipantAppDelayMin Integer32, 300 raqmonParticipantAppDelayMax Integer32, 301 raqmonParticipantPacketsRcvd Integer32, 302 raqmonParticipantPacketsSent Integer32, 303 raqmonParticipantOctetsRcvd Integer32, 304 raqmonParticipantOctetsSent Integer32, 305 raqmonParticipantLostPackets Integer32, 306 raqmonParticipantLostPacketsFrct Integer32, 307 raqmonParticipantDiscards Integer32, 308 raqmonParticipantDiscardsFrct Integer32 309 } 311 raqmonParticipantStartDate OBJECT-TYPE 312 SYNTAX DateAndTime 313 MAX-ACCESS not-accessible 314 STATUS current 315 DESCRIPTION 316 "The date and time of this entry. 317 It will be the date and time 318 of the first report received." 319 ::= { raqmonParticipantEntry 1 } 321 raqmonParticipantIndex OBJECT-TYPE 322 SYNTAX Unsigned32 (1..2147483647) 323 MAX-ACCESS not-accessible 324 STATUS current 325 DESCRIPTION 326 "The index of the conceptual row which is for SNMP 327 purposes only and has no relation to any protocol value. 329 There is no requirement that these rows be created or 330 maintained sequentially. The index will be unique for a 331 particular date and time." 332 ::= { raqmonParticipantEntry 2 } 334 raqmonParticipantReportCaps OBJECT-TYPE 335 SYNTAX BITS { 336 raqmonPartRepDsrcName(0), 337 raqmonPartRepRecvName(1), 338 raqmonPartRepDsrcPort(2), 339 raqmonPartRepRecvPort(3), 340 raqmonPartRepSetupTime(4), 341 raqmonPartRepSetupDelay(5), 342 raqmonPartRepSessionDuration(6), 343 raqmonPartRepSetupStatus(7), 344 raqmonPartRepRTEnd2EndNetDelay(8), 345 raqmonPartRepOWEnd2EndNetDelay(9), 346 raqmonPartApplicationDelay(10), 347 raqmonPartRepIAJitter(11), 348 raqmonPartRepIPDV(12), 349 raqmonPartRepRcvdPackets(13), 350 raqmonPartRepRcvdOctets(14), 351 raqmonPartRepSentPackets(15), 352 raqmonPartRepSentOctets(16), 353 raqmonPartRepCumPacketsLoss(17), 354 raqmonPartRepFractionPacketsLoss(18), 355 raqmonPartRepCumDiscards(19), 356 raqmonPartRepFractionDiscards(20), 357 raqmonPartRepSrcPayloadType(21), 358 raqmonPartRepDestPayloadType(22), 359 raqmonPartRepSrcLayer2Priority(23), 360 raqmonPartRepSrcTosDscp(24), 361 raqmonPartRepDestLayer2Priority(25), 362 raqmonPartRepDestTosDscp(26), 363 raqmonPartRepCPU(27), 364 raqmonPartRepMemory(28), 365 raqmonPartRepAppName(29) 366 } 367 MAX-ACCESS read-only 368 STATUS current 369 DESCRIPTION 370 "The Report capabilities of the participant, as 371 perceived by the Collector. 373 If the participant can report the Data Source Name 374 as defined in [RAQMON-FRAMEWORK], Section 5.3, 375 then the raqmonPartRepDsrcName bit will be set. 377 If the participant can report the Receiver Name 378 as defined in [RAQMON-FRAMEWORK], Section 5.4, 379 then the raqmonPartRepRecvName bit will be set. 381 If the participant can report the Data Source Port 382 as defined in [RAQMON-FRAMEWORK], Section 5.5, 383 then the raqmonPartRepDsrcPort bit will be set. 385 If the participant can report the Receiver Port 386 as defined in [RAQMON-FRAMEWORK], Section 5.6, 387 then the raqmonPartRepRecvPort bit will be set. 389 If the participant can report the Session Setup Time 390 as defined in [RAQMON-FRAMEWORK], Section 5.7, 391 then the raqmonPartRepSetupTime bit will be set. 393 If the participant can report the Session Setup Delay 394 as defined in [RAQMON-FRAMEWORK], Section 5.8, 395 then the raqmonPartRepSetupDelay bit will be set. 397 If the participant can report the Session Duration 398 as defined in [RAQMON-FRAMEWORK], Section 5.9, 399 then the raqmonPartRepSessionDuration bit will be set. 401 If the participant can report the Setup Status 402 as defined in [RAQMON-FRAMEWORK], Section 5.10, 403 then the raqmonPartRepSetupStatus bit will be set. 405 If the participant can report the Round-Trip 406 End-to-end Network Delay 407 as defined in [RAQMON-FRAMEWORK], Section 5.11, 408 then the raqmonPartRepRTEnd2EndNetDelay bit will be set. 410 If the participant can report the One-way 411 End-to-end Network Delay 412 as defined in [RAQMON-FRAMEWORK], Section 5.12, 413 then the raqmonPartRepOWEnd2EndNetDelay bit will be set. 415 If the participant can report the Application Delay 416 as defined in [RAQMON-FRAMEWORK], Section 5.13, 417 then the raqmonPartApplicationDelay bit will be set. 419 If the participant can report the Inter-Arrival Jitter 420 as defined in [RAQMON-FRAMEWORK], Section 5.14, 421 then the raqmonPartRepIAJitter bit will be set. 423 If the participant can report the IP Packet Delay 424 Variation as defined in [RAQMON-FRAMEWORK], Section 425 5.15, then the raqmonPartRepIPDV bit will be set. 427 If the participant can report the number of application 428 packets received 429 as defined in [RAQMON-FRAMEWORK], Section 5.16, 430 then the raqmonPartRepRcvdPackets bit will be set. 432 If the participant can report the number of application 433 octets received 434 as defined in [RAQMON-FRAMEWORK], Section 5.17, 435 then the raqmonPartRepRcvdOctets bit will be set. 437 If the participant can report the number of application 438 packets sent 439 as defined in [RAQMON-FRAMEWORK], Section 5.18, 440 then the raqmonPartRepSentPackets bit will be set. 442 If the participant can report the number of application 443 octets sent 444 as defined in [RAQMON-FRAMEWORK], Section 5.19, 445 then the raqmonPartRepSentOctets bit will be set. 447 If the participant can report the number of 448 cumulative packets lost 449 as defined in [RAQMON-FRAMEWORK], Section 5.20, 450 then the raqmonPartRepCumPacketsLoss bit will be set. 452 If the participant can report the fraction of packets 453 loss as defined in [RAQMON-FRAMEWORK], Section 5.21, 454 then the raqmonPartRepFractionPacketsLoss bit will be 455 set. 457 If the participant can report the number of 458 cumulative discards 459 as defined in [RAQMON-FRAMEWORK], Section 5.22, 460 then the raqmonPartRepCumDiscards bit will be set. 462 If the participant can report the fraction of discards 463 as defined in [RAQMON-FRAMEWORK], Section 5.23, 464 then the raqmonPartRepFractionDiscards bit will be set. 466 If the participant can report the Source Payload Type 467 as defined in [RAQMON-FRAMEWORK], Section 5.24, 468 then the raqmonPartRepSrcPayloadType bit will be set. 470 If the participant can report the Destination Payload 471 Type as defined in [RAQMON-FRAMEWORK], Section 5.25, 472 then the raqmonPartRepDestPayloadType bit will be set. 474 If the participant can report the Source layer 2 475 Priority as defined in [RAQMON-FRAMEWORK], Section 5.26, 476 then the raqmonPartRepSrcLayer2Priority bit will be set. 478 If the participant can report the Source DSCP/ToS value 479 as defined in [RAQMON-FRAMEWORK], Section 5.27, 480 then the raqmonPartRepSrcToSDscp bit will be set. 482 If the participant can report the Destination layer 2 483 Priority as defined in [RAQMON-FRAMEWORK], Section 5.28, 484 then the raqmonPartRepDestLayer2Priority bit will be 485 set. 487 If the participant can report the Destination DSCP/ToS 488 Value as defined in [RAQMON-FRAMEWORK], Section 5.29, 489 then the raqmonPartRepDestToSDscp bit will be set. 491 If the participant can report the CPU utilization 492 as defined in [RAQMON-FRAMEWORK], Section 5.30, 493 then the raqmonPartRepCPU bit will be set. 495 If the participant can report the memory utilization 496 as defined in [RAQMON-FRAMEWORK], Section 5.31, 497 then the raqmonPartRepMemory bit will be set. 499 If the participant can report the Application Name 500 as defined in [RAQMON-FRAMEWORK], Section 5.32, 501 then the raqmonPartRepAppName bit will be set. 503 The capability of reporting of a specific metric 504 does not mandate that the metric must be reported 505 permanently by the data source to the respective 506 collector. Some data sources MAY be configured not 507 to send a metric, or some metrics may not be relevant 508 to the specific application." 509 ::= { raqmonParticipantEntry 3 } 511 raqmonParticipantAddrType OBJECT-TYPE 512 SYNTAX InetAddressType 513 MAX-ACCESS read-only 514 STATUS current 515 DESCRIPTION 516 "The type of the Internet address of the participant for 517 this session." 518 ::= { raqmonParticipantEntry 4 } 520 raqmonParticipantAddr OBJECT-TYPE 521 SYNTAX InetAddress 522 MAX-ACCESS read-only 523 STATUS current 524 DESCRIPTION 525 "The Internet Address of the participant for this 526 session. Formatting of this object is determined 527 by the value of raqmonParticipantAddrType." 528 ::= { raqmonParticipantEntry 5 } 530 raqmonParticipantSendPort OBJECT-TYPE 531 SYNTAX InetPortNumber 532 MAX-ACCESS read-only 533 STATUS current 534 DESCRIPTION 535 "Port from which session data is sent. 536 If the value was not reported to the collector, 537 this object will have the value 0." 538 REFERENCE 539 "Section 5.5 of the [RAQMON-FRAMEWORK]" 540 ::= { raqmonParticipantEntry 6 } 542 raqmonParticipantRecvPort OBJECT-TYPE 543 SYNTAX InetPortNumber 544 MAX-ACCESS read-only 545 STATUS current 546 DESCRIPTION 547 "Port on which session data is received. 548 If the value was not reported to the collector, 549 this object will have the value 0." 550 REFERENCE 551 "Section 5.6 of the [RAQMON-FRAMEWORK]" 552 ::= { raqmonParticipantEntry 7 } 554 raqmonParticipantSetupDelay OBJECT-TYPE 555 SYNTAX Integer32 (-1|0..2147483647) 556 UNITS "milliseconds" 557 MAX-ACCESS read-only 558 STATUS current 559 DESCRIPTION 560 "Session setup time. 561 If the value was not reported to the collector, 562 this object will have the value -1." 563 REFERENCE 564 "Section 5.8 of the [RAQMON-FRAMEWORK]" 565 ::= { raqmonParticipantEntry 8 } 567 raqmonParticipantName OBJECT-TYPE 568 SYNTAX SnmpAdminString 569 MAX-ACCESS read-only 570 STATUS current 571 DESCRIPTION 572 "The data source name for the participant." 573 REFERENCE 574 "Section 5.3 of the [RAQMON-FRAMEWORK]" 575 ::= { raqmonParticipantEntry 9 } 577 raqmonParticipantAppName OBJECT-TYPE 578 SYNTAX SnmpAdminString 579 MAX-ACCESS read-only 580 STATUS current 581 DESCRIPTION 582 "A string giving the name and possibly the version 583 of the application generating the stream, e.g., 584 'videotool 1.2.' 586 This information may be useful for debugging purposes 587 and is similar to the Mailer or Mail-System-Version SMTP 588 headers. The tool value is expected to remain constant 589 for the duration of the session." 590 REFERENCE 591 "Section 5.32 of the [RAQMON-FRAMEWORK]" 592 ::= { raqmonParticipantEntry 10 } 594 raqmonParticipantQosCount OBJECT-TYPE 595 SYNTAX Gauge32 596 UNITS "entries" 597 MAX-ACCESS read-only 598 STATUS current 599 DESCRIPTION 600 "The current number of entries in the raqmonQosTable 601 for this participant and session." 602 ::= { raqmonParticipantEntry 11 } 604 raqmonParticipantEndDate OBJECT-TYPE 605 SYNTAX DateAndTime 606 MAX-ACCESS read-only 607 STATUS current 608 DESCRIPTION 609 "The date and time of the most recent report received." 610 ::= { raqmonParticipantEntry 12 } 612 raqmonParticipantDestPayloadType OBJECT-TYPE 613 SYNTAX Integer32 (-1|0..127) 614 MAX-ACCESS read-only 615 STATUS current 616 DESCRIPTION 617 "Destination Payload Type. 618 If the value was not reported to the collector, 619 this object will have the value -1." 620 REFERENCE 621 "RFC 3551 and Section 5.25 of the [RAQMON-FRAMEWORK]" 622 ::= { raqmonParticipantEntry 13 } 624 raqmonParticipantSrcPayloadType OBJECT-TYPE 625 SYNTAX Integer32 (-1|0..127) 626 MAX-ACCESS read-only 627 STATUS current 628 DESCRIPTION 629 "Source Payload Type. 630 If the value was not reported to the collector, 631 this object will have the value -1." 632 REFERENCE 633 "RFC 3551 and Section 5.24 of the [RAQMON-FRAMEWORK]" 634 ::= { raqmonParticipantEntry 14 } 636 raqmonParticipantActive OBJECT-TYPE 637 SYNTAX TruthValue 638 MAX-ACCESS read-only 639 STATUS current 640 DESCRIPTION 641 "Value 'true' indicates that the session 642 for this participant is active (open). 643 Value 'false' indicates that the session 644 is closed (terminated)." 645 ::= { raqmonParticipantEntry 15 } 647 raqmonParticipantPeer OBJECT-TYPE 648 SYNTAX RowPointer 649 MAX-ACCESS read-only 650 STATUS current 651 DESCRIPTION 652 "The pointer to the corresponding entry in this table for 653 the other peer participant. If there is no such entry 654 in the particpant table of the collector represented by 655 this SNMP agent, then the value will be { 0 0 }. 656 " 657 ::= { raqmonParticipantEntry 16 } 659 raqmonParticipantPeerAddrType OBJECT-TYPE 660 SYNTAX InetAddressType 661 MAX-ACCESS read-only 662 STATUS current 663 DESCRIPTION 664 "The type of the Internet address of the peer participant 665 for this session." 666 ::= { raqmonParticipantEntry 17 } 668 raqmonParticipantPeerAddr OBJECT-TYPE 669 SYNTAX InetAddress 670 MAX-ACCESS read-only 671 STATUS current 672 DESCRIPTION 673 "The Internet Address of the peer participant for this 674 session. Formatting of this object is determined by 675 the value of raqmonParticipantPeerAddrType." 676 ::= { raqmonParticipantEntry 18 } 678 raqmonParticipantSrcL2Priority OBJECT-TYPE 679 SYNTAX Integer32 (-1|0..7) 680 MAX-ACCESS read-only 681 STATUS current 682 DESCRIPTION 683 "Source Layer 2 priority. 684 If the value was not reported to the collector, 685 this object will have the value -1." 686 REFERENCE 687 "Section 5.26 of the [RAQMON-FRAMEWORK]" 688 ::= { raqmonParticipantEntry 19 } 690 raqmonParticipantDestL2Priority OBJECT-TYPE 691 SYNTAX Integer32 (-1|0..7) 692 MAX-ACCESS read-only 693 STATUS current 694 DESCRIPTION 695 "Destination Layer 2 priority. 696 If the value was not reported to the collector, 697 this object will have the value -1." 698 REFERENCE 699 "Section 5.28 of the [RAQMON-FRAMEWORK]" 700 ::= { raqmonParticipantEntry 20 } 702 raqmonParticipantSrcDSCP OBJECT-TYPE 703 SYNTAX Integer32 (-1|0..63) 704 MAX-ACCESS read-only 705 STATUS current 706 DESCRIPTION 707 "Source Layer 3 DSCP value. 708 If the value was not reported to the collector, 709 this object will have the value -1." 710 REFERENCE 711 "Section 5.27 of the [RAQMON-FRAMEWORK]" 712 ::= { raqmonParticipantEntry 21 } 714 raqmonParticipantDestDSCP OBJECT-TYPE 715 SYNTAX Integer32 (-1|0..63) 716 MAX-ACCESS read-only 717 STATUS current 718 DESCRIPTION 719 "Destination Layer 3 DSCP value" 720 REFERENCE 721 "Section 5.29 of the [RAQMON-FRAMEWORK]" 722 ::= { raqmonParticipantEntry 22 } 724 raqmonParticipantCpuMean OBJECT-TYPE 725 SYNTAX Integer32 (-1|0..100) 726 UNITS "percents" 727 MAX-ACCESS read-only 728 STATUS current 729 DESCRIPTION 730 "Mean CPU utilization. 731 If the value was not reported to the collector, 732 this object will have the value -1." 733 REFERENCE 734 "Section 5.30 of the [RAQMON-FRAMEWORK]" 735 ::= { raqmonParticipantEntry 23 } 737 raqmonParticipantCpuMin OBJECT-TYPE 738 SYNTAX Integer32 (-1|0..100) 739 UNITS "percents" 740 MAX-ACCESS read-only 741 STATUS current 742 DESCRIPTION 743 "Minimum CPU utilization. 744 If the value was not reported to the collector, 745 this object will have the value -1." 746 REFERENCE 747 "Section 5.30 of the [RAQMON-FRAMEWORK]" 748 ::= { raqmonParticipantEntry 24 } 750 raqmonParticipantCpuMax OBJECT-TYPE 751 SYNTAX Integer32 (-1|0..100) 752 UNITS "percents" 753 MAX-ACCESS read-only 754 STATUS current 755 DESCRIPTION 756 "Maximum CPU utilization. 757 If the value was not reported to the collector, 758 this object will have the value -1." 759 REFERENCE 760 "Section 5.30 of the [RAQMON-FRAMEWORK]" 761 ::= { raqmonParticipantEntry 25 } 763 raqmonParticipantMemoryMean OBJECT-TYPE 764 SYNTAX Integer32 (-1|0..100) 765 UNITS "percents" 766 MAX-ACCESS read-only 767 STATUS current 768 DESCRIPTION 769 "Mean memory utilization. 770 If the value was not reported to the collector, 771 this object will have the value -1." 772 REFERENCE 773 "Section 5.31 of the [RAQMON-FRAMEWORK]" 774 ::= { raqmonParticipantEntry 26 } 776 raqmonParticipantMemoryMin OBJECT-TYPE 777 SYNTAX Integer32 (-1|0..100) 778 UNITS "percents" 779 MAX-ACCESS read-only 780 STATUS current 781 DESCRIPTION 782 "Minimum memory utilization. 783 If the value was not reported to the collector, 784 this object will have the value -1." 785 REFERENCE 786 "Section 5.31 of the [RAQMON-FRAMEWORK]" 787 ::= { raqmonParticipantEntry 27 } 789 raqmonParticipantMemoryMax OBJECT-TYPE 790 SYNTAX Integer32 (-1|0..100) 791 UNITS "percents" 792 MAX-ACCESS read-only 793 STATUS current 794 DESCRIPTION 795 "Maximum memory utilization. 796 If the value was not reported to the collector, 797 this object will have the value -1." 798 REFERENCE 799 "Section 5.31 of the [RAQMON-FRAMEWORK]" 800 ::= { raqmonParticipantEntry 28 } 802 raqmonParticipantNetRTTMean OBJECT-TYPE 803 SYNTAX Integer32 (-1|0..2147483647) 804 UNITS "milliseconds" 805 MAX-ACCESS read-only 806 STATUS current 807 DESCRIPTION 808 "Mean round trip end-to-end network 809 delay over the entire session. 810 If the value was not reported to the collector, 811 this object will have the value -1." 812 REFERENCE 813 "Section 5.11 of the [RAQMON-FRAMEWORK]" 814 ::= { raqmonParticipantEntry 29 } 816 raqmonParticipantNetRTTMin OBJECT-TYPE 817 SYNTAX Integer32 (-1|0..2147483647) 818 UNITS "milliseconds" 819 MAX-ACCESS read-only 820 STATUS current 821 DESCRIPTION 822 "Minimum round trip end-to-end network delay 823 over the entire session. 824 If the value was not reported to the collector, 825 this object will have the value -1." 826 REFERENCE 827 "Section 5.11 of the [RAQMON-FRAMEWORK]" 828 ::= { raqmonParticipantEntry 30 } 830 raqmonParticipantNetRTTMax OBJECT-TYPE 831 SYNTAX Integer32 (-1|0..2147483647) 832 UNITS "milliseconds" 833 MAX-ACCESS read-only 834 STATUS current 835 DESCRIPTION 836 "Maximum round trip end-to-end network delay 837 over the entire session. 838 If the value was not reported to the collector, 839 this object will have the value -1." 840 REFERENCE 841 "Section 5.11 of the [RAQMON-FRAMEWORK]" 842 ::= { raqmonParticipantEntry 31 } 844 raqmonParticipantIAJitterMean OBJECT-TYPE 845 SYNTAX Integer32 (-1|0..2147483647) 846 UNITS "milliseconds" 847 MAX-ACCESS read-only 848 STATUS current 849 DESCRIPTION 850 "Mean inter-arrival jitter over the entire session. 851 If the value was not reported to the collector, 852 this object will have the value -1." 853 REFERENCE 854 "Section 5.14 of the [RAQMON-FRAMEWORK]" 855 ::= { raqmonParticipantEntry 32 } 857 raqmonParticipantIAJitterMin OBJECT-TYPE 858 SYNTAX Integer32 (-1|0..2147483647) 859 UNITS "milliseconds" 860 MAX-ACCESS read-only 861 STATUS current 862 DESCRIPTION 863 "Minimum inter-arrival jitter over the entire session. 864 If the value was not reported to the collector, 865 this object will have the value -1." 866 REFERENCE 867 "Section 5.14 of the [RAQMON-FRAMEWORK]" 868 ::= { raqmonParticipantEntry 33 } 870 raqmonParticipantIAJitterMax OBJECT-TYPE 871 SYNTAX Integer32 (-1|0..2147483647) 872 UNITS "milliseconds" 873 MAX-ACCESS read-only 874 STATUS current 875 DESCRIPTION 876 "Maximim inter-arrival jitter over the entire session. 877 If the value was not reported to the collector, 878 this object will have the value -1." 879 REFERENCE 880 "Section 5.14 of the [RAQMON-FRAMEWORK]" 881 ::= { raqmonParticipantEntry 34 } 883 raqmonParticipantIPDVMean OBJECT-TYPE 884 SYNTAX Integer32 (-1|0..2147483647) 885 UNITS "milliseconds" 886 MAX-ACCESS read-only 887 STATUS current 888 DESCRIPTION 889 "Mean IP packet delay variation over the entire session. 890 If the value was not reported to the collector, 891 this object will have the value -1." 892 REFERENCE 893 "Section 5.15 of the [RAQMON-FRAMEWORK]" 894 ::= { raqmonParticipantEntry 35 } 896 raqmonParticipantIPDVMin OBJECT-TYPE 897 SYNTAX Integer32 (-1|0..2147483647) 898 UNITS "milliseconds" 899 MAX-ACCESS read-only 900 STATUS current 901 DESCRIPTION 902 "Minimum IP packet delay variation over the entire 903 session. If the value was not reported to the collector, 904 this object will have the value -1." 905 REFERENCE 906 "Section 5.15 of the [RAQMON-FRAMEWORK]" 908 ::= { raqmonParticipantEntry 36 } 910 raqmonParticipantIPDVMax OBJECT-TYPE 911 SYNTAX Integer32 (-1|0..2147483647) 912 UNITS "milliseconds" 913 MAX-ACCESS read-only 914 STATUS current 915 DESCRIPTION 916 "Maximim IP packet delay variation over the entire 917 session. If the value was not reported to the collector, 918 this object will have the value -1." 919 REFERENCE 920 "Section 5.15 of the [RAQMON-FRAMEWORK]" 921 ::= { raqmonParticipantEntry 37 } 923 raqmonParticipantNetOwdMean OBJECT-TYPE 924 SYNTAX Integer32 (-1|0..2147483647) 925 UNITS "milliseconds" 926 MAX-ACCESS read-only 927 STATUS current 928 DESCRIPTION 929 "Mean Network one-way delay over the entire session. 930 If the value was not reported to the collector, 931 this object will have the value -1." 932 REFERENCE 933 "Section 5.12 of the [RAQMON-FRAMEWORK]" 934 ::= { raqmonParticipantEntry 38 } 936 raqmonParticipantNetOwdMin OBJECT-TYPE 937 SYNTAX Integer32 (-1|0..2147483647) 938 UNITS "milliseconds" 939 MAX-ACCESS read-only 940 STATUS current 941 DESCRIPTION 942 "Minimum Network one-way delay over the entire session. 943 If the value was not reported to the collector, 944 this object will have the value -1." 945 REFERENCE 946 "Section 5.12 of the [RAQMON-FRAMEWORK]" 947 ::= { raqmonParticipantEntry 39 } 949 raqmonParticipantNetOwdMax OBJECT-TYPE 950 SYNTAX Integer32 (-1|0..2147483647) 951 UNITS "milliseconds" 952 MAX-ACCESS read-only 953 STATUS current 954 DESCRIPTION 955 "Maximim Network one-way delay over the entire session. 957 If the value was not reported to the collector, 958 this object will have the value -1." 959 REFERENCE 960 "Section 5.1 of the [RAQMON-FRAMEWORK]" 961 ::= { raqmonParticipantEntry 40 } 963 raqmonParticipantAppDelayMean OBJECT-TYPE 964 SYNTAX Integer32 (-1|0..2147483647) 965 UNITS "milliseconds" 966 MAX-ACCESS read-only 967 STATUS current 968 DESCRIPTION 969 "Mean application delay over the entire session. 970 If the value was not reported to the collector, 971 this object will have the value -1." 972 REFERENCE 973 "Section 5.13 of the [RAQMON-FRAMEWORK]" 974 ::= { raqmonParticipantEntry 41 } 976 raqmonParticipantAppDelayMin OBJECT-TYPE 977 SYNTAX Integer32 (-1|0..2147483647) 978 UNITS "milliseconds" 979 MAX-ACCESS read-only 980 STATUS current 981 DESCRIPTION 982 "Minimum application delay over the entire session. 983 If the value was not reported to the collector, 984 this object will have the value -1." 985 REFERENCE 986 "Section 5.13 of the [RAQMON-FRAMEWORK]" 987 ::= { raqmonParticipantEntry 42 } 989 raqmonParticipantAppDelayMax OBJECT-TYPE 990 SYNTAX Integer32 (-1|0..2147483647) 991 UNITS "milliseconds" 992 MAX-ACCESS read-only 993 STATUS current 994 DESCRIPTION 995 "Maximum application delay over the entire session. 996 If the value was not reported to the collector, 997 this object will have the value -1." 998 REFERENCE 999 "Section 5.13 of the [RAQMON-FRAMEWORK]" 1000 ::= { raqmonParticipantEntry 43 } 1002 raqmonParticipantPacketsRcvd OBJECT-TYPE 1003 SYNTAX Integer32 (-1|0..2147483647) 1004 UNITS "packets" 1005 MAX-ACCESS read-only 1006 STATUS current 1007 DESCRIPTION 1008 "Count of packets received for the entire session. 1009 If the value was not reported to the collector, 1010 this object will have the value -1." 1011 REFERENCE 1012 "Section 5.16 of the [RAQMON-FRAMEWORK]" 1013 ::= { raqmonParticipantEntry 44 } 1015 raqmonParticipantPacketsSent OBJECT-TYPE 1016 SYNTAX Integer32 (-1|0..2147483647) 1017 UNITS "packets" 1018 MAX-ACCESS read-only 1019 STATUS current 1020 DESCRIPTION 1021 "Count of packets sent for the entire session. 1022 If the value was not reported to the collector, 1023 this object will have the value -1." 1024 REFERENCE 1025 "Section 5.17 of the [RAQMON-FRAMEWORK]" 1026 ::= { raqmonParticipantEntry 45 } 1028 raqmonParticipantOctetsRcvd OBJECT-TYPE 1029 SYNTAX Integer32 (-1|0..2147483647) 1030 UNITS "Octets" 1031 MAX-ACCESS read-only 1032 STATUS current 1033 DESCRIPTION 1034 "Count of Octets received for the entire session. 1035 If the value was not reported to the collector, 1036 this object will have the value -1." 1037 REFERENCE 1038 "Section 5.18 of the [RAQMON-FRAMEWORK]" 1039 ::= { raqmonParticipantEntry 46 } 1041 raqmonParticipantOctetsSent OBJECT-TYPE 1042 SYNTAX Integer32 (-1|0..2147483647) 1043 UNITS "Octets" 1044 MAX-ACCESS read-only 1045 STATUS current 1046 DESCRIPTION 1047 "Count of Octets sent for the entire session. 1048 If the value was not reported to the collector, 1049 this object will have the value -1." 1050 REFERENCE 1051 "Section 5.19 of the [RAQMON-FRAMEWORK]" 1052 ::= { raqmonParticipantEntry 47 } 1054 raqmonParticipantLostPackets OBJECT-TYPE 1055 SYNTAX Integer32 (-1|0..2147483647) 1056 UNITS "packets" 1057 MAX-ACCESS read-only 1058 STATUS current 1059 DESCRIPTION 1060 "Count of packets lost by this receiver for the entire 1061 session. 1062 If the value was not reported to the collector, 1063 this object will have the value -1." 1064 REFERENCE 1065 "Section 5.20 of the [RAQMON-FRAMEWORK]" 1066 ::= { raqmonParticipantEntry 48 } 1068 raqmonParticipantLostPacketsFrct OBJECT-TYPE 1069 SYNTAX Integer32 (-1|0..100) 1070 UNITS "percents" 1071 MAX-ACCESS read-only 1072 STATUS current 1073 DESCRIPTION 1074 "Fraction of lost packets out of total packets received. 1075 If the value was not reported to the collector, 1076 this object will have the value -1." 1077 REFERENCE 1078 "Section 5.21 of the [RAQMON-FRAMEWORK]" 1079 ::= { raqmonParticipantEntry 49 } 1081 raqmonParticipantDiscards OBJECT-TYPE 1082 SYNTAX Integer32 (-1|0..2147483647) 1083 UNITS "packets" 1084 MAX-ACCESS read-only 1085 STATUS current 1086 DESCRIPTION 1087 "Count of packets discarded by this receiver for the 1088 entire session. 1089 If the value was not reported to the collector, 1090 this object will have the value -1." 1091 REFERENCE 1092 "Section 5.22 of the [RAQMON-FRAMEWORK]" 1093 ::= { raqmonParticipantEntry 50 } 1095 raqmonParticipantDiscardsFrct OBJECT-TYPE 1096 SYNTAX Integer32 (-1|0..100) 1097 UNITS "percents" 1098 MAX-ACCESS read-only 1099 STATUS current 1100 DESCRIPTION 1101 "Fraction of discarded packets out of total packets 1102 received. If the value was not reported to the 1103 collector, this object will have the value -1." 1104 REFERENCE 1105 "Section 5.23 of the [RAQMON-FRAMEWORK]" 1106 ::= { raqmonParticipantEntry 51 } 1108 raqmonQosTable OBJECT-TYPE 1109 SYNTAX SEQUENCE OF RaqmonQosEntry 1110 MAX-ACCESS not-accessible 1111 STATUS current 1112 DESCRIPTION 1113 "Table of historical information about quality of service 1114 data during sessions." 1115 ::= { raqmonSession 2 } 1117 raqmonQosEntry OBJECT-TYPE 1118 SYNTAX RaqmonQosEntry 1119 MAX-ACCESS not-accessible 1120 STATUS current 1121 DESCRIPTION 1122 "Each entry contains information from a single RAQMON 1123 packet, related to a single session 1124 (application) run by one participant. 1125 Indexation by the start time of the session aims 1126 easing sorting by management applications. Agents MUST 1127 NOT report identical start time for any two sessions 1128 on the same host. 1129 Rows are removed for inactive sessions when 1130 implementation-specific time or space limits are 1131 reached." 1132 INDEX { raqmonParticipantStartDate, 1133 raqmonParticipantIndex, 1134 raqmonQosTime } 1135 ::= { raqmonQosTable 1 } 1137 RaqmonQosEntry ::= 1138 SEQUENCE { 1139 raqmonQosTime Unsigned32, 1140 raqmonQoSEnd2EndNetDelay Integer32, 1141 raqmonQoSInterArrivalJitter Integer32, 1142 raqmonQosRcvdPackets Integer32, 1143 raqmonQosRcvdOctets Integer32, 1144 raqmonQosSentPackets Integer32, 1145 raqmonQosSentOctets Integer32, 1146 raqmonQosLostPackets Integer32, 1147 raqmonQosSessionStatus SnmpAdminString 1148 } 1150 raqmonQosTime OBJECT-TYPE 1151 SYNTAX Unsigned32 (0..2147483647) 1152 UNITS "seconds" 1153 MAX-ACCESS not-accessible 1154 STATUS current 1155 DESCRIPTION 1156 "Time of this entry measured from the start of the 1157 corresponding participant session. 1158 " 1159 ::= { raqmonQosEntry 1 } 1161 raqmonQoSEnd2EndNetDelay OBJECT-TYPE 1162 SYNTAX Integer32 (-1 | 0..2147483647) 1163 UNITS "milliseconds" 1164 MAX-ACCESS read-only 1165 STATUS current 1166 DESCRIPTION 1167 "The round trip time. 1168 Will contain the previous value if there was no report 1169 for this time, or -1 if the value has never 1170 been reported. 1171 " 1172 REFERENCE 1173 "Section 5.11 of the [RAQMON-FRAMEWORK]" 1174 ::= { raqmonQosEntry 2 } 1176 raqmonQoSInterArrivalJitter OBJECT-TYPE 1177 SYNTAX Integer32 (-1 | 0..2147483647) 1178 UNITS "milliseconds" 1179 MAX-ACCESS read-only 1180 STATUS current 1181 DESCRIPTION 1182 "An estimate of delay variation as observed by this 1183 receiver. Will contain the previous value if there 1184 was no report for this time, or -1 if the value 1185 has never been reported. 1186 " 1187 REFERENCE 1188 "Section 5.14 of the [RAQMON-FRAMEWORK]" 1189 ::= { raqmonQosEntry 3 } 1191 raqmonQosRcvdPackets OBJECT-TYPE 1192 SYNTAX Integer32 (-1 | 0..2147483647) 1193 UNITS "packets" 1194 MAX-ACCESS read-only 1195 STATUS current 1196 DESCRIPTION 1197 "Count of packets received by this receiver since the 1198 previous entry. Will contain the previous value if there 1199 was no report for this time, or -1 if the value 1200 has never been reported. 1201 " 1202 REFERENCE 1203 "Section 5.16 of the [RAQMON-FRAMEWORK]" 1204 ::= { raqmonQosEntry 4 } 1206 raqmonQosRcvdOctets OBJECT-TYPE 1207 SYNTAX Integer32 (-1 | 0..2147483647) 1208 UNITS "octets" 1209 MAX-ACCESS read-only 1210 STATUS current 1211 DESCRIPTION 1212 "Count of octets received by this receiver since the 1213 previous report. Will contain the previous value if 1214 there was no report for this time, or -1 if the value 1215 has never been reported. 1216 " 1217 REFERENCE 1218 "Section 5.18 of the [RAQMON-FRAMEWORK]" 1219 ::= { raqmonQosEntry 5 } 1221 raqmonQosSentPackets OBJECT-TYPE 1222 SYNTAX Integer32 (-1 | 0..2147483647) 1223 UNITS "packets" 1224 MAX-ACCESS read-only 1225 STATUS current 1226 DESCRIPTION 1227 "Count of packets sent since the previous report. 1228 Will contain the previous value if there 1229 was no report for this time, or -1 if the value 1230 has never been reported. 1231 " 1232 REFERENCE 1233 "Section 5.17 of the [RAQMON-FRAMEWORK]" 1234 ::= { raqmonQosEntry 6 } 1236 raqmonQosSentOctets OBJECT-TYPE 1237 SYNTAX Integer32 (-1 | 0..2147483647) 1238 UNITS "octets" 1239 MAX-ACCESS read-only 1240 STATUS current 1241 DESCRIPTION 1242 "Count of octets sent since the previous report. 1244 Will contain the previous value if there 1245 was no report for this time, or -1 if the value 1246 has never been reported. 1247 " 1248 REFERENCE 1249 "Section 5.19 of the [RAQMON-FRAMEWORK]" 1250 ::= { raqmonQosEntry 7 } 1252 raqmonQosLostPackets OBJECT-TYPE 1253 SYNTAX Integer32 (-1 | 0..2147483647) 1254 UNITS "packets" 1255 MAX-ACCESS read-only 1256 STATUS current 1257 DESCRIPTION 1258 "A count of packets lost as observed by this receiver 1259 since the Will contain the previous value if there 1260 was no report for this time, or -1 if the value 1261 has never been reported. 1262 " 1263 REFERENCE 1264 "Section 5.20 of the [RAQMON-FRAMEWORK]" 1265 ::= { raqmonQosEntry 8 } 1267 raqmonQosSessionStatus OBJECT-TYPE 1268 SYNTAX SnmpAdminString 1269 MAX-ACCESS read-only 1270 STATUS current 1271 DESCRIPTION 1272 "The session status. Will contain the previous value 1273 if there was no report for this time or the zero length 1274 string if no value was ever reported." 1275 REFERENCE 1276 "Section 5.10 of the [RAQMON-FRAMEWORK]" 1277 ::= { raqmonQosEntry 9 } 1279 raqmonParticipantAddrTable OBJECT-TYPE 1280 SYNTAX SEQUENCE OF RaqmonParticipantAddrEntry 1281 MAX-ACCESS not-accessible 1282 STATUS current 1283 DESCRIPTION 1284 "Maps raqmonParticipantAddr to the index of the 1285 raqmonParticipantTable. This table allows 1286 management applications to find entries 1287 sorted by raqmonParticipantAddr rather than 1288 raqmonParticipantStartDate." 1289 ::= { raqmonSession 3 } 1291 raqmonParticipantAddrEntry OBJECT-TYPE 1292 SYNTAX RaqmonParticipantAddrEntry 1293 MAX-ACCESS not-accessible 1294 STATUS current 1295 DESCRIPTION 1296 "Each entry corresponds to exactly one entry in the 1297 raqmonParticipantEntry - the entry containing the 1298 index pair raqmonParticipantStartDate, 1299 raqmonParticipantIndex. 1301 Note that there is no concern about the indexation of 1302 this table exceeding the limits defined by RFC 2578 1303 Section 3.5. According to [RAQMON-FRAMEWORK], Section 1304 5.1, only IPv4 and IPv6 addresses can be reported as 1305 participant addresses." 1306 INDEX { raqmonParticipantAddrType, 1307 raqmonParticipantAddr, 1308 raqmonParticipantStartDate, 1309 raqmonParticipantIndex } 1310 ::= { raqmonParticipantAddrTable 1 } 1312 RaqmonParticipantAddrEntry ::= 1313 SEQUENCE { raqmonParticipantAddrEndDate DateAndTime } 1315 raqmonParticipantAddrEndDate OBJECT-TYPE 1316 SYNTAX DateAndTime 1317 MAX-ACCESS read-only 1318 STATUS current 1319 DESCRIPTION 1320 "The value of raqmonParticipantEndDate for the 1321 corresponding raqmonParticipantEntry." 1322 ::= { raqmonParticipantAddrEntry 1 } 1324 raqmonException OBJECT IDENTIFIER ::= { raqmonMIBObjects 2 } 1326 raqmonSessionExceptionTable OBJECT-TYPE 1327 SYNTAX SEQUENCE OF RaqmonSessionExceptionEntry 1328 MAX-ACCESS not-accessible 1329 STATUS current 1330 DESCRIPTION 1331 "This table defines thresholds for management 1332 station to get notifications about sessions that 1333 encountered poor quality of service. 1335 The information in this table MUST be persistent 1336 across agent reboots." 1337 ::= { raqmonException 2 } 1339 raqmonSessionExceptionEntry OBJECT-TYPE 1340 SYNTAX RaqmonSessionExceptionEntry 1341 MAX-ACCESS not-accessible 1342 STATUS current 1343 DESCRIPTION 1344 "A conceptual row in the raqmonSessionExceptionTable." 1345 INDEX { raqmonSessionExceptionIndex } 1346 ::= { raqmonSessionExceptionTable 1 } 1348 RaqmonSessionExceptionEntry ::= 1349 SEQUENCE { 1350 raqmonSessionExceptionIndex Unsigned32, 1351 raqmonSessionExceptionIAJitterThreshold Unsigned32, 1352 raqmonSessionExceptionNetRTTThreshold Unsigned32, 1353 raqmonSessionExceptionLostPacketsThreshold Unsigned32, 1354 raqmonSessionExceptionRowStatus RowStatus 1355 } 1357 raqmonSessionExceptionIndex OBJECT-TYPE 1358 SYNTAX Unsigned32 (1..65535) 1359 MAX-ACCESS not-accessible 1360 STATUS current 1361 DESCRIPTION 1362 "An index that uniquely identifies an 1363 entry in the raqmonSessionExceptionTable. 1364 Management applications can determine unused indices 1365 by performing GetNext or GetBulk operations on the 1366 Table." 1367 ::= { raqmonSessionExceptionEntry 2 } 1369 raqmonSessionExceptionIAJitterThreshold OBJECT-TYPE 1370 SYNTAX Unsigned32 1371 UNITS "milliseconds" 1372 MAX-ACCESS read-create 1373 STATUS current 1374 DESCRIPTION 1375 "Threshold for jitter. 1376 The value during a session must be greater than or 1377 equal to this value for an exception to be created." 1378 ::= { raqmonSessionExceptionEntry 3 } 1380 raqmonSessionExceptionNetRTTThreshold OBJECT-TYPE 1381 SYNTAX Unsigned32 1382 UNITS "milliseconds" 1383 MAX-ACCESS read-create 1384 STATUS current 1385 DESCRIPTION 1386 "Threshold for round trip time. 1388 The value during a session must be greater than or 1389 equal to this value for an exception to be created." 1390 ::= { raqmonSessionExceptionEntry 4 } 1392 raqmonSessionExceptionLostPacketsThreshold OBJECT-TYPE 1393 SYNTAX Unsigned32 (0..1000) 1394 UNITS "tenth of a percent" 1395 MAX-ACCESS read-create 1396 STATUS current 1397 DESCRIPTION 1398 "Threshold for lost packets in units of tenth 1399 of a percent. The value during a session must 1400 be greater than or equal to this value for an 1401 exception to be created." 1402 ::= { raqmonSessionExceptionEntry 5 } 1404 raqmonSessionExceptionRowStatus OBJECT-TYPE 1405 SYNTAX RowStatus 1406 MAX-ACCESS read-create 1407 STATUS current 1408 DESCRIPTION 1409 "This object has a value of 'active' when 1410 exceptions are being monitored by the system. 1411 A newly-created conceptual row must have all 1412 the read-create objects initialized before 1413 becoming 'active'. A conceptual row that is in 1414 the 'notReady' or 'notInService' state MAY be 1415 removed after 5 minutes. No writeable objects 1416 can be changed while the row is active." 1417 ::= { raqmonSessionExceptionEntry 7 } 1419 raqmonConfig OBJECT IDENTIFIER ::= { raqmonMIBObjects 3 } 1421 raqmonConfigPort OBJECT-TYPE 1422 SYNTAX InetPortNumber 1423 MAX-ACCESS read-write 1424 STATUS current 1425 DESCRIPTION 1426 "The UDP port to listen on for RAQMON reports, 1427 running on other transport protocols than SNMP. 1428 If the RAQMON PDU transport protocol is SNMP, 1429 a write operation on this object has no effect, as 1430 the standard port 162 is always used. 1431 The value of this object MUST be persistent across 1432 agent reboots." 1433 ::= { raqmonConfig 1 } 1435 raqmonConfigPduTransport OBJECT-TYPE 1436 SYNTAX BITS 1437 { 1438 other(0), 1439 tcp(1), 1440 snmp(2) 1441 } 1442 MAX-ACCESS read-only 1443 STATUS current 1444 DESCRIPTION 1445 "The PDU transport(s) used by this collector. 1446 If other(0) is set, the collector supports a 1447 transport other than SNMP or TCP. 1448 If tcp(1) is set, the collector supports TCP as a 1449 transport protocol. 1450 If snmp(2) is set, the collector supports SNMP as a 1451 transport protocol." 1452 ::= { raqmonConfig 2 } 1454 raqmonConfigRaqmonPdus OBJECT-TYPE 1455 SYNTAX Counter32 1456 UNITS "PDUs" 1457 MAX-ACCESS read-only 1458 STATUS current 1459 DESCRIPTION 1460 "Count of RAQMON PDUs received by the Collector." 1461 ::= { raqmonConfig 3 } 1463 raqmonConfigRDSTimeout OBJECT-TYPE 1464 SYNTAX Unsigned32 1465 MAX-ACCESS read-write 1466 STATUS current 1467 DESCRIPTION 1468 "The number of seconds since the reception of the 1469 last RAQMON PDU from a RDS after which a session 1470 between the respective RDS and the collector will be 1471 considered terminated. 1472 The value of this object MUST be persistent across 1473 agent reboots." 1474 ::= { raqmonConfig 4 } 1476 raqmonConformance OBJECT IDENTIFIER ::= { raqmonMIB 2 } 1477 raqmonCompliances OBJECT IDENTIFIER ::= { raqmonConformance 1 } 1478 raqmonGroups OBJECT IDENTIFIER ::= { raqmonConformance 2 } 1480 raqmonCompliance MODULE-COMPLIANCE 1481 STATUS current 1482 DESCRIPTION 1483 "Describes the requirements for conformance to the 1484 RAQMON MIB." 1485 MODULE -- this module 1486 MANDATORY-GROUPS { raqmonCollectorGroup, 1487 raqmonCollectorNotificationsGroup 1488 } 1490 OBJECT raqmonParticipantAddrType 1491 SYNTAX InetAddressType { ipv4(1), ipv6(2) } 1492 DESCRIPTION 1493 "Only IPv4 and IPv6 addresses need to be supported" 1495 OBJECT raqmonParticipantAddr 1496 SYNTAX InetAddress (SIZE(4|16)) 1497 DESCRIPTION 1498 "Only IPv4 and IPv6 addresses need to be supported" 1500 OBJECT raqmonParticipantPeerAddrType 1501 SYNTAX InetAddressType { ipv4(1), ipv6(2) } 1502 DESCRIPTION 1503 "Only IPv4 and IPv6 addresses need to be supported" 1505 OBJECT raqmonParticipantPeerAddr 1506 SYNTAX InetAddress (SIZE(4|16)) 1507 DESCRIPTION 1508 "Only IPv4 and IPv6 addresses need to be supported" 1510 ::= { raqmonCompliances 1 } 1512 raqmonCollectorGroup OBJECT-GROUP 1513 OBJECTS { 1514 raqmonParticipantReportCaps, 1515 raqmonParticipantAddrType, 1516 raqmonParticipantAddr, 1517 raqmonParticipantSendPort, 1518 raqmonParticipantRecvPort, 1519 raqmonParticipantSetupDelay, 1520 raqmonParticipantName, 1521 raqmonParticipantAppName, 1522 raqmonParticipantQosCount, 1523 raqmonParticipantEndDate, 1524 raqmonParticipantDestPayloadType, 1525 raqmonParticipantSrcPayloadType, 1526 raqmonParticipantActive, 1527 raqmonParticipantPeer, 1528 raqmonParticipantPeerAddrType, 1529 raqmonParticipantPeerAddr, 1530 raqmonParticipantSrcL2Priority, 1531 raqmonParticipantDestL2Priority, 1532 raqmonParticipantSrcDSCP, 1533 raqmonParticipantDestDSCP, 1534 raqmonParticipantCpuMean, 1535 raqmonParticipantCpuMin, 1536 raqmonParticipantCpuMax, 1537 raqmonParticipantMemoryMean, 1538 raqmonParticipantMemoryMin, 1539 raqmonParticipantMemoryMax, 1540 raqmonParticipantNetRTTMean, 1541 raqmonParticipantNetRTTMin, 1542 raqmonParticipantNetRTTMax, 1543 raqmonParticipantIAJitterMean, 1544 raqmonParticipantIAJitterMin, 1545 raqmonParticipantIAJitterMax, 1546 raqmonParticipantIPDVMean, 1547 raqmonParticipantIPDVMin, 1548 raqmonParticipantIPDVMax, 1549 raqmonParticipantNetOwdMean, 1550 raqmonParticipantNetOwdMin, 1551 raqmonParticipantNetOwdMax, 1552 raqmonParticipantAppDelayMean, 1553 raqmonParticipantAppDelayMin, 1554 raqmonParticipantAppDelayMax, 1555 raqmonParticipantPacketsRcvd, 1556 raqmonParticipantPacketsSent, 1557 raqmonParticipantOctetsRcvd, 1558 raqmonParticipantOctetsSent, 1559 raqmonParticipantLostPackets, 1560 raqmonParticipantLostPacketsFrct, 1561 raqmonParticipantDiscards, 1562 raqmonParticipantDiscardsFrct, 1563 raqmonQoSEnd2EndNetDelay, 1564 raqmonQoSInterArrivalJitter, 1565 raqmonQosRcvdPackets, 1566 raqmonQosRcvdOctets, 1567 raqmonQosSentPackets, 1568 raqmonQosSentOctets, 1569 raqmonQosLostPackets, 1570 raqmonQosSessionStatus, 1571 raqmonParticipantAddrEndDate, 1572 raqmonConfigPort, 1573 raqmonSessionExceptionIAJitterThreshold, 1574 raqmonSessionExceptionNetRTTThreshold, 1575 raqmonSessionExceptionLostPacketsThreshold, 1576 raqmonSessionExceptionRowStatus, 1577 raqmonConfigPduTransport, 1578 raqmonConfigRaqmonPdus, 1579 raqmonConfigRDSTimeout} 1580 STATUS current 1581 DESCRIPTION 1582 "Objects used in RAQMON by a Collector" 1584 ::= { raqmonGroups 1 } 1586 raqmonCollectorNotificationsGroup NOTIFICATION-GROUP 1587 NOTIFICATIONS { raqmonSessionAlarm } 1588 STATUS current 1589 DESCRIPTION 1590 "Notifications emitted by a RAQMON collector." 1591 ::= { raqmonGroups 2 } 1593 END 1595 6. Security Considerations 1597 There are a number of management objects defined in this MIB module 1598 with a MAX-ACCESS clause of read-write. Such objects may be 1599 considered sensitive or vulnerable in some network environments. 1600 The support for SET operations in a non-secure environment without 1601 proper protection can have a negative effect on network operations. 1603 Setting the value of the object raqmonRDSTimeout to a too low value 1604 would result in RDS sessions being terminated sooner than necessary, 1605 while setting at a too high value may result in terminated sessions 1606 continuing to be managed, with unnecessary memory allocations. 1608 Setting the following object to incorrect values can result in 1609 collectors either flooding the management applications with 1610 unnecessary notifications, or not sending notifications when the 1611 QoS in the network may be degraded. 1613 raqmonSessionExceptionIAJitterThreshold 1614 raqmonSessionExceptionRTTThreshold 1615 raqmonSessionExceptionLostPacketsThreshold 1617 Setting the raqmonConfigPort object to incorrect values can result in 1618 the collector not being able to receive RAQMON PDUs from the data 1619 sources. 1621 Some of the readable objects in this MIB module (i.e., objects with a 1622 MAX-ACCESS other than not-accessible) may be considered sensitive or 1623 vulnerable in some network environments. These are: 1625 raqmonParticipantTable 1626 raqmonQoSTable 1627 raqmonParticpantAddrTable 1629 Unauthorized exposure of these objects may lead to disclosure of the 1630 addresses of the participants in applications, or information about 1631 the traffic patents of the applications, which may be considered 1632 sensitive in certain environments. 1634 It is thus important to control even GET and/or NOTIFY access to 1635 these objects and possibly to even encrypt their values when sending 1636 them over the network via SNMP. 1638 The structure of the RAQMON tables limits what can be usefully done 1639 for access control configuration using VACM. For example, it would 1640 not be possible with these structures to provide a group, with access 1641 to performance data to a specific group of devices, since the index 1642 values for raqmonParticpantEntry cannot be known in advance. 1643 Likewise, raqmonSessionExceptionEntries apply to all entries in the 1644 raqmonQoSTable. 1646 SNMP versions prior to SNMPv3 did not include adequate security. 1647 Even if the network itself is secure (for example by using IPSec), 1648 even then, there is no control as to who on the secure network is 1649 allowed to access and GET/SET (read/change/create/delete) the objects 1650 in this MIB module. 1652 It is RECOMMENDED that implementers consider the security features as 1653 provided by the SNMPv3 framework (see [RFC3410], section 8), 1654 including full support for the SNMPv3 cryptographic mechanisms (for 1655 authentication and privacy). 1657 Further, deployment of SNMP versions prior to SNMPv3 is NOT 1658 RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to 1659 enable cryptographic security. It is then a customer/operator 1660 responsibility to ensure that the SNMP entity giving access to an 1661 instance of this MIB module is properly configured to give access to 1662 the objects only to those principals (users) that have legitimate 1663 rights to indeed GET or SET (change/create/delete) them. 1665 7. IANA Considerations 1667 No requirements from IANA are defined in this document. The root OID 1668 of the MIB module defined in this document belongs to the RMON 1669 subtree, as reserved in [RFC3737]. 1671 8. Acknowledgements 1673 Richard Smith created the first proprietary version of this MIB. 1675 The authors would also like to thank to all the participants in the 1676 Remote Monitoring MIB Working Group, and especially to Andy Bierman, 1677 Steven Waldbusser, Alan Clark, Itai Zilbershtein, and Robert Cole for 1678 interesting discussions, ideas, comments and direct contributions 1679 to this work. 1681 The authors would also like to thank Randy Presuhn for the precious 1682 technical comments, as well as for the laborious activity of 1683 reviewing the syntax and spelling of the document. 1685 The authors would like to thank Bert Wijnen for the review of the 1686 final versions of the document, as well as for the guidance provided 1687 during the whole period of editing. 1689 Normative References 1691 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 1692 Requirement Levels", BCP 14, RFC 2119, March 1997. 1694 [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., 1695 Rose, M., and S. Waldbusser, "Structure of Management 1696 Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1697 1999. 1699 [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., 1700 Rose, M., and S. Waldbusser, "Textual Conventions for 1701 SMIv2", STD 58, RFC 2579, April 1999. 1703 [RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., 1704 Rose, M., and S. Waldbusser, "Conformance Statements for 1705 SMIv2", STD 58, RFC 2580, April 1999. 1707 [RFC2819] Waldbusser, S., "Remote Network Monitoring Management 1708 Information Base", STD 59, RFC 2819, May 2000. 1710 [RFC3411] Harrington, D., Preshun, R. and B. Wijnen, "An 1711 Architecture for Describing Simple Network Management 1712 Protocol (SNMP) Management Frameworks", STD 62, RFC 3411, 1713 December 2002. 1715 [RFC4001] Daniele, M., Haberman, B., Routhier, S. and 1716 J. Schoenwalder, "Textual Conventions for Internet 1717 Network Addresses", RFC 4001, February 2005. 1719 [RAQMON-FRAMEWORK] A. Siddiqui, D.Romascanu, and Golovinsky, E., 1720 "Framework for Real-time Application Quality of 1721 Service Monitoring (RAQMON)", Internet-Draft, 1722 draft-ietf-rmonmib-raqmon-framework-15.txt, 1723 February 2006. 1725 Informative References 1727 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 1728 "Introduction and Applicability Statements for Internet- 1729 Standard Management Framework", RFC 3410, December 2002. 1731 [RAQMON-PDU] Siddiqui, A., Romascanu, D., Golovinsky, E., Ramhman, 1732 M.,and Y. Kim, "Transport Mappings for Real-time 1733 Application Quality of Service Monitoring (RAQMON) 1734 Protocol Data Unit (PDU)",Internet-Draft, 1735 draft-ietf-raqmon-pdu-13.txt, 1736 February 2006. 1738 [RFC3737] Wijnen B., and A.Bierman 1739 "IANA Guidelines for the Registry of Remote Monitoring 1740 (RMON) MIB modules", RFC 3737, April 2004. 1742 Authors' Addresses 1744 Anwar A. Siddiqui 1745 Avaya Labs 1746 307 Middletown Lincroft Road 1747 Lincroft, New Jersey 07738 1748 USA 1749 Tel: +1 732 852-3200 1750 Fax: +1 732 817-5922 1751 E-mail: anwars@avaya.com 1753 Dan Romascanu 1754 Avaya 1755 Atidim Technology Park, Bldg. #3 1756 Tel Aviv, 61131 1757 Israel 1758 Tel: +972 3-645-8414 1759 Email: dromasca@avaya.com 1761 Eugene Golovinsky 1762 BMC Software 1763 2101 CityWest Blvd. 1764 Houston, Texas 77042 1765 USA 1766 Tel: +1 713 918-1816 1767 Email: eugene_golovinsky@bmc.com 1769 Full Copyright Statement 1771 Copyright (C) The Internet Society (2006). This document is subject 1772 to the rights, licenses and restrictions contained in BCP 78, and 1773 except as set forth therein, the authors retain all their rights. 1775 This document and the information contained herein are provided on an 1776 "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS 1777 OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET 1778 ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, 1779 INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE 1780 INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED 1781 WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 1783 IPR Disclosure Acknowledgement 1785 The IETF takes no position regarding the validity or scope of any 1786 Intellectual Property Rights or other rights that might be claimed to 1787 pertain to the implementation or use of the technology described in 1788 this document or the extent to which any license under such rights 1789 might or might not be available; nor does it represent that it has 1790 made any independent effort to identify any such rights. Information 1791 on the procedures with respect to rights in RFC documents can be 1792 found in BCP 78 and BCP 79. 1794 Copies of IPR disclosures made to the IETF Secretariat and any 1795 assurances of licenses to be made available, or the result of an 1796 attempt made to obtain a general license or permission for the use of 1797 such proprietary rights by implementers or users of this 1798 specification can be obtained from the IETF on-line IPR repository at 1799 http://www.ietf.org/ipr. 1801 The IETF invites any interested party to bring to its attention any 1802 copyrights, patents or patent applications, or other proprietary 1803 rights that may cover technology that may be required to implement 1804 this standard. Please address the information to the IETF at ietf- 1805 ipr@ietf.org.