idnits 2.17.1 draft-warth-rmon2-artmib-00.txt: ** The Abstract section seems to be numbered Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** Cannot find the required boilerplate sections (Copyright, IPR, etc.) in this document. Expected boilerplate is as follows today (2024-04-26) according to https://trustee.ietf.org/license-info : IETF Trust Legal Provisions of 28-dec-2009, Section 6.a: This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. IETF Trust Legal Provisions of 28-dec-2009, Section 6.b(i), paragraph 2: Copyright (c) 2024 IETF Trust and the persons identified as the document authors. All rights reserved. IETF Trust Legal Provisions of 28-dec-2009, Section 6.b(i), paragraph 3: This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- ** Missing expiration date. The document expiration date should appear on the first and last page. ** The document seems to lack a 1id_guidelines paragraph about Internet-Drafts being working documents. ** The document seems to lack a 1id_guidelines paragraph about 6 months document validity -- however, there's a paragraph with a matching beginning. Boilerplate error? ** The document seems to lack a 1id_guidelines paragraph about the list of current Internet-Drafts. ** The document seems to lack a 1id_guidelines paragraph about the list of Shadow Directories. ** The document is more than 15 pages and seems to lack a Table of Contents. == No 'Intended status' indicated for this document; assuming Proposed Standard == The page length should not exceed 58 lines per page, but there was 1 longer page, the longest (page 1) being 1285 lines Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The document seems to lack an Introduction section. ** The document seems to lack a Security Considerations section. ** The document seems to lack an IANA Considerations section. (See Section 2.2 of https://www.ietf.org/id-info/checklist for how to handle the case when there are no actions for IANA.) ** There are 55 instances of too long lines in the document, the longest one being 8 characters in excess of 72. ** There are 19 instances of lines with control characters in the document. Miscellaneous warnings: ---------------------------------------------------------------------------- == The "Author's Address" (or "Authors' Addresses") section title is misspelled. -- 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 (January 1999) is 9233 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) No issues found here. Summary: 13 errors (**), 0 flaws (~~), 3 warnings (==), 2 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 1 INTERNET DRAFT Expires January 1999 2 Albin Warth 3 Jim McQuaid 4 NetScout Systems, Inc. 6 Applications Response Time MIB (ART MIB) 7 9 July 13, 1998 11 1. Status of this Memo 12 This document is an Internet-Draft. Internet-Drafts are working 13 documents of the Internet Engineering Task Force (IETF), its areas, and 14 its working groups. Note that other groups may also distribute working 15 documents as Internet- Drafts. 17 Internet-Drafts are draft documents valid for a maximum of six months. 18 Internet-Drafts may be updated, replaced, or obsoleted by other 19 documents at any time. It is not appropriate to use Internet-Drafts as 20 reference material or to cite them other than as a ``working draft'' or 21 ``work in progress.'' 23 To view the entire list of current Internet-Drafts, please check the 24 "1id- abstracts.txt" listing contained in the Internet-Drafts Shadow 25 Directories on ftp.is.co.za (Africa), ftp.nordu.net (Northern Europe), 26 ftp.nis.garr.it (Southern Europe), munnari.oz.au (Pacific Rim), 27 ftp.ietf.org (US East Coast), or ftp.isi.edu (US West Coast). 29 2. Abstract 30 This memo defines a MIB for application response time, based on the RMON2 MIB 31 for use with the SNMP network management architecture. 33 This memo does not specify a standard for the Internet community. 35 3. Introduction 36 RMON2 provides detailed information about the composition of network traffic. 37 Beyond utilization and related measures of bytes and packets seen, RMON2 38 provides no direct information about the performance of the network in support 39 of specific applications flowing through it. The Application Response Time MIB 40 (ART MIB) is an extension of RMON2 which provides such performance information. 42 The basic model of network interaction measured by the ART MIB is the request- 43 response pair. The procedure for determining the identity and pairing of 44 requests and responses is not part of the MIB structure and the MIB is only 45 dependent on some workable definition. The NetScout Systems initial 46 implementation uses several protocol request-response pairs including general 47 TCP dialogs, identified as socket pairs, and individual data segments and their 48 acknowledgements as one primary example. Dialog performance, then, consists of 49 packets exchanged by nodes operating in the role of client and a server for the 50 purposes of that exchange. The client-server distinction will be clear in the 51 case of well-known protocols and arbitrary in the case of non-standard 52 protocols. 54 4. Relation To RMON2 55 The ART MIB uses the RMON2 protocol directory structure to identify protocols 56 for which the agent can match requests and responses. The protocol directory is 57 augmented by information in the protocolDir2ArtConfig object indicating whether 58 the protocol is supported and whether it is enabled. [This version branches 59 from NetScout's private enterprise branch. Presumably a final version would 60 branch from RMON2.] 62 5. General Function 63 The ART MIB accumulates the elapsed times in milliseconds, for all request- 64 response pairs the agent observes during a specific user-controlled report 65 period. Typical values for this report period might be 5 to 15 minutes. At the 66 end of this time, the collection appears in the MIB and a new collection of 67 measurements begins. 69 5.1 Control Entries 70 The controls for the ART MIB consist of several items, most of them familiar 71 RMON2 constructs. artControlDuration is the value of the time period over which 72 measurements are made and averaged. The six (millisecond) values 73 artControlRspTime1 through artControlRspTime6 define seven buckets used to 74 report the distribution of measurements during the time period. The value 75 artControlRspTimeout effectively defines the upper boundary of the seventh 76 bucket. 78 5.2 Client Data 79 For each unique client-server dialog being measured, the MIB provides a row 80 containing the following information for the report interval: 82 o The server and client addresses for identification 83 o The average of all individual response time measurements made 84 o The minimum and the maximum individual response time measurements 85 o The total number of responses measured, that is, the total number of request- 86 response pairs that could be matched during this report interval 87 o Seven buckets, each containing a count of individual response times falling 88 within the buckets time boundaries 89 o Number of octets sent and received, expressed in both 32-bit and HC 64-bit 90 notations 91 o The number of retries and the number of timeouts. Timeouts correspond to 92 requests whose matching response was not seen within the timeout interval 94 5.3 Server Summary Data 95 The ART MIB also provides a summary of all the clients talking to an individual 96 server. This contains identical data to the individual client-server rows, but 97 the values reflect the aggregate of all clients seen to be talking with any 98 common server. 100 The summary data provides a way to retrieve representative data about a 101 potentially large group of conversations in a compact way. 103 6. Authors Addresses 105 Albin Warth 106 NetScout Systems, Inc. 107 4 Technology Park Drive 108 Westford, MA 01886 109 1 978 614 4306 110 albin@netscout.com 112 Jim McQuaid 113 NetScout Systems, Inc. 114 4 Technology Park Drive 115 Westford, MA 01886 116 1 978 614 4116 117 mcquaidj@netscout.com 119 6. The ART MIB 121 -- ART MIB definitions (SMIv2 syntax) 122 -- 123 -- 125 ART-MIB DEFINITIONS ::= BEGIN 126 IMPORTS 127 -- netscout2 FROM NETSCOUT-MIB 128 MODULE-IDENTITY, OBJECT-TYPE, enterprises, Counter32, Integer32, 129 Counter64 FROM SNMPv2-SMI 130 RowStatus, TimeStamp 131 FROM SNMPv2-TC 132 MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF 133 OwnerString FROM RMON-MIB 134 DataSource, protocolDirEntry, protocolDirLocalIndex FROM RMON2-MIB; 136 art MODULE-IDENTITY 137 LAST-UPDATED "9804210000Z" 138 ORGANIZATION "NetScout Systems, Inc." 139 CONTACT-INFO 140 "Albin Warth 141 Postal: NetScout Systems, Inc. 142 4 Technology Park Drive 143 Westford, MA 01886 144 Phone: +1 978 614 4306 145 Email: albin@netscout.com" 146 DESCRIPTION 147 "The MIB module for Application Response Time measurement." 148 ::= { netscout2 5 } 150 -- 151 -- ART extends Enterprise RMON by creating a new branch... 152 -- 153 -- (Can also do this by importing netscout2 FROM NETSCOUT-MIB) 154 -- 156 frontier OBJECT IDENTIFIER ::= { enterprises 141 } 157 mibdoc2 OBJECT IDENTIFIER ::= { frontier 2 } 158 netscout2 OBJECT IDENTIFIER ::= { mibdoc2 1 } 160 -- 161 -- The ART augmentation of the RMON-2 Protocol Directory. 162 -- This defines (in effect) an additional column in the protocolDirTable. 163 -- 165 protocolDir2Table OBJECT-TYPE 166 SYNTAX SEQUENCE OF ProtocolDir2Entry 167 MAX-ACCESS not-accessible 168 STATUS current 169 DESCRIPTION 170 "Contains the ART augmentations to RMON-2." 171 ::= { art 1 } 173 protocolDir2Entry OBJECT-TYPE 174 SYNTAX ProtocolDir2Entry 175 MAX-ACCESS not-accessible 176 STATUS current 177 DESCRIPTION 178 "Contains the ART augmentations to RMON-2." 179 AUGMENTS { protocolDirEntry } 180 ::= { protocolDir2Table 1 } 182 ProtocolDir2Entry ::= SEQUENCE { 183 protocolDir2ArtConfig INTEGER 184 } 186 protocolDir2ArtConfig OBJECT-TYPE 187 SYNTAX INTEGER { 188 notSupported(1), 189 supportedOff(2), 190 supportedOn(3) 191 } 192 MAX-ACCESS read-create 193 STATUS current 194 DESCRIPTION 195 "This object describes and configures the probe's support for 196 application response time monitoring for the protocol. 198 When the probe creates entries in this table for 199 all protocols that it understands, it will set the entry to 200 notSupported(1) if it doesn't have the capability to track 201 application response time for this protocol. 203 If the value of this object is supportedOff(2), the probe 204 supports tracking of application response time, but is 205 configured to not track response time for any control 206 entries or data sources. 208 If the value of this object is supportedOn(3), the probe 209 supports tracking of application response time for this 210 protocol, and will allow creation of entries in the 211 artControlTable for the associated protocol. 213 Whenever this value changes from supportedOn(3) to 214 supportedOff(2), the probe shall delete all related entries in 215 the artTable and artSummaryTable." 216 ::= { protocolDir2Entry 1 } 218 -- 219 -- The ART Report Control Table 220 -- 222 artControlTable OBJECT-TYPE 223 SYNTAX SEQUENCE OF ArtControlEntry 224 MAX-ACCESS not-accessible 225 STATUS current 226 DESCRIPTION 227 "This table lists the data sources (typically, probe interfaces) 228 for which application response time collection is enabled, 229 and additionally controls the generation of ART reports in 230 the artTable and artSummaryTable." 231 ::= { art 2 } 233 artControlEntry OBJECT-TYPE 234 SYNTAX ArtControlEntry 235 MAX-ACCESS not-accessible 236 STATUS current 237 DESCRIPTION 238 "A conceptual row in the artControlTable. 240 Creation of a row enables ART collection and report generation 241 for the corresponding data source. 243 The artControlRspTime{1..6} objects are used to categorize the 244 request-response pairs observed during an ART sample interval. 246 The NMS is responsible to ensure that: 247 artControlRspTime1 <= artControlRspTime2 248 artControlRspTime2 <= artControlRspTime3 249 artControlRspTime3 <= artControlRspTime4 250 artControlRspTime4 <= artControlRspTime5 251 artControlRspTime5 <= artControlRspTime6 253 and that: 254 artControlRspTime6 <= artControlRspTimeout 256 If these relationships do not hold, the probe rejects any 257 attempt to set the artControlStatus object to active(1). 259 Suggested default values for the time ranges are: 260 artControlRspTime1 25 milliseconds 261 artControlRspTime2 50 milliseconds 262 artControlRspTime3 100 milliseconds 263 artControlRspTime4 200 milliseconds 264 artControlRspTime5 400 milliseconds 265 artControlRspTime6 800 milliseconds 267 The table is implicitly indexed by data source, 268 using the DataSource identifier corresponding to 269 the data source." 270 INDEX { artControlIndex } 271 ::= { artControlTable 1 } 273 ArtControlEntry ::= SEQUENCE { 274 artControlIndex Integer32, 275 artControlDataSource DataSource, 276 artControlTimeRemaining Integer32, 277 artControlDuration Integer32, 278 artControlRspTime1 Integer32, 279 artControlRspTime2 Integer32, 280 artControlRspTime3 Integer32, 281 artControlRspTime4 Integer32, 282 artControlRspTime5 Integer32, 283 artControlRspTime6 Integer32, 284 artControlRspTimeout Integer32, 285 artControlRptStartTime TimeStamp, 286 artControlRequestedSize Integer32, 287 artControlGrantedSize Integer32, 288 artControlGeneratedRpts Integer32, 289 artControlDroppedFrames Counter32, 290 artControlOwner OwnerString, 291 artControlStatus RowStatus 292 } 294 artControlIndex OBJECT-TYPE 295 SYNTAX Integer32 (1..65535) 296 MAX-ACCESS not-accessible 297 STATUS current 298 DESCRIPTION 299 "A unique index for this artControlEntry." 300 ::= { artControlEntry 1 } 302 artControlDataSource OBJECT-TYPE 303 SYNTAX DataSource 304 MAX-ACCESS read-create 305 STATUS current 306 DESCRIPTION 307 "The source of data for application response-time collection, 308 i.e., the data source (typically, a probe interface) for which 309 ART statistics are to be collected and reports generated. 311 This object shall not be modified if the associated 312 artControlStatus is equal to active(1)." 313 ::= { artControlEntry 2 } 315 artControlTimeRemaining OBJECT-TYPE 316 SYNTAX Integer32 (0..86400) -- 24 hours 317 UNITS "seconds" 318 MAX-ACCESS read-create 319 STATUS current 320 DESCRIPTION 321 "The number of seconds remaining in the current report 322 interval. When this value reaches zero, the probe deletes 323 any existing reports for the associated data source, creates 324 a new report corresponding to the just-expired interval, 325 copies the current value of artControlDuration to this object, 326 and starts a new collection interval. 328 The value of this object is latched in artControlDuration 329 whenever it is written to using SNMP, allowing automatic 330 restart of collection using the same duration. 332 If this object is overwritten while the associated 333 artStatus is equal to active(1), the current collection 334 for the associated data source is abandoned, and a new 335 collection started using the new interval. 337 Setting this value to 0 abandons current collection and 338 disables report generation for the associated data source. 339 (This is not recommended -- better to delete the row.) 341 The probe should delay the initial countdown of this 342 object in order to align report intervals to 12:00 AM UTC." 343 ::= { artControlEntry 3 } 345 artControlDuration OBJECT-TYPE 346 SYNTAX Integer32 (0..86400) -- 24 hours 347 UNITS "seconds" 348 MAX-ACCESS read-only 349 STATUS current 350 DESCRIPTION 351 "This object is used to latch the value of artTimeRemaining 352 for automatic collection restart at the end of a collection 353 interval." 355 ::= { artControlEntry 4 } 357 artControlRspTime1 OBJECT-TYPE 358 SYNTAX Integer32 (0..2147483647) 359 UNITS "milliseconds" 360 MAX-ACCESS read-create 361 STATUS current 362 DESCRIPTION 363 "The first of six time values used to categorize the response 364 times observed during the report interval. 366 This object may not be changed while artControlStatus is set 367 to active(1)." 368 ::= { artControlEntry 5 } 370 artControlRspTime2 OBJECT-TYPE 371 SYNTAX Integer32 (0..2147483647) 372 UNITS "milliseconds" 373 MAX-ACCESS read-create 374 STATUS current 375 DESCRIPTION 376 "The second of six time values used to categorize the response 377 times observed during the report interval. 379 This object may not be changed while artControlStatus is set 380 to active(1)." 381 ::= { artControlEntry 6 } 383 artControlRspTime3 OBJECT-TYPE 384 SYNTAX Integer32 (0..2147483647) 385 UNITS "milliseconds" 386 MAX-ACCESS read-create 387 STATUS current 388 DESCRIPTION 389 "The third of six time values used to categorize the response 390 times observed during the report interval. 392 This object may not be changed while artControlStatus is set 393 to active(1)." 394 ::= { artControlEntry 7 } 396 artControlRspTime4 OBJECT-TYPE 397 SYNTAX Integer32 (0..2147483647) 398 UNITS "milliseconds" 399 MAX-ACCESS read-create 400 STATUS current 401 DESCRIPTION 402 "The fourth of six time values used to categorize the response 403 times observed during the report interval. 405 This object may not be changed while artControlStatus is set 406 to active(1)." 407 ::= { artControlEntry 8 } 409 artControlRspTime5 OBJECT-TYPE 410 SYNTAX Integer32 (0..2147483647) 411 UNITS "milliseconds" 412 MAX-ACCESS read-create 413 STATUS current 414 DESCRIPTION 415 "The fifth of six time values used to categorize the response 416 times observed during the report interval. 418 This object may not be changed while artControlStatus is set 419 to active(1)." 420 ::= { artControlEntry 9 } 422 artControlRspTime6 OBJECT-TYPE 423 SYNTAX Integer32 (0..2147483647) 424 UNITS "milliseconds" 425 MAX-ACCESS read-create 426 STATUS current 427 DESCRIPTION 428 "The sixth of six time values used to categorize the response 429 times observed during the report interval. 431 This object may not be changed while artControlStatus is set 432 to active(1)." 433 ::= { artControlEntry 10 } 435 artControlRspTimeout OBJECT-TYPE 436 SYNTAX Integer32 (0..2147483647) 437 UNITS "milliseconds" 438 MAX-ACCESS read-create 439 STATUS current 440 DESCRIPTION 441 "The maximum interval that the probe will wait for a server response 442 to a client request. Requests older than this value are 443 abandoned, and counted as artTimeouts in the artTable and 444 as artSummaryTimeouts in the artSummaryTable. 446 This object may not be changed while artControlStatus is set 447 to active(1)." 448 ::= { artControlEntry 11 } 450 artControlRptStartTime OBJECT-TYPE 451 SYNTAX TimeStamp 452 MAX-ACCESS read-only 453 STATUS current 454 DESCRIPTION 455 "The time at which collection of the currently available 456 reports was started." 457 ::= { artControlEntry 12 } 459 artControlRequestedSize OBJECT-TYPE 460 SYNTAX Integer32 (-1..65535) 461 MAX-ACCESS read-create 462 STATUS current 463 DESCRIPTION 464 "The maximum number of report rows to be generated in the 465 artTable for the associated data source. If set to -1, the 466 maximum number of report rows shall be determined by the probe 467 based on available resources." 468 ::= { artControlEntry 13 } 470 artControlGrantedSize OBJECT-TYPE 471 SYNTAX Integer32 (0..65535) 472 MAX-ACCESS read-only 473 STATUS current 474 DESCRIPTION 475 "The maximum number of report rows in the artTable granted by 476 the probe for the associated data source. The value of this 477 object may be less than the requested size." 478 ::= { artControlEntry 14 } 480 artControlGeneratedRpts OBJECT-TYPE 481 SYNTAX Integer32 (0..65535) 482 MAX-ACCESS read-only 483 STATUS current 484 DESCRIPTION 485 "The number of report sets that have been generated by this entry. 487 The NMS may use this value to poll for the availability of 488 a new report set. It may also sample this value before and after 489 a sweep of the artTable or artSummaryTable in order to verify 490 that a new report set was not generated during the sweep." 491 ::= { artControlEntry 15 } 493 artControlDroppedFrames OBJECT-TYPE 494 SYNTAX Counter32 495 MAX-ACCESS read-only 496 STATUS current 497 DESCRIPTION 498 "The total number of frames which were received by the probe 499 and therefore not accounted for in the *StatsDropEvents, but 500 for which the probe chose not to count for this entry for 501 whatever reason. Most often, this event occurs when the probe 502 is out of some resources and decides to shed load from this 503 collection. 505 This count does not include packets that were not counted 506 because they had MAC-layer errors. 508 Note that, unlike the dropEvents counter, this number is the 509 exact number of frames dropped." 510 ::= { artControlEntry 16 } 512 artControlOwner OBJECT-TYPE 513 SYNTAX OwnerString 514 MAX-ACCESS read-create 515 STATUS current 516 DESCRIPTION 517 "The entity that configured this entry and is therefore using 518 the resources assigned to it." 519 ::= { artControlEntry 17 } 521 artControlStatus OBJECT-TYPE 522 SYNTAX RowStatus 523 MAX-ACCESS read-create 524 STATUS current 525 DESCRIPTION 526 "The status of this control table entry. 528 An entry must not exist in the active state unless all 529 objects in the entry have an appropriate value. 531 If this object is not equal to active(1), all associated 532 entries in the artTable and artSummaryTable shall be deleted." 533 ::= { artControlEntry 18 } 535 -- 536 -- The ART Report Table 537 -- 539 artTable OBJECT-TYPE 540 SYNTAX SEQUENCE OF ArtEntry 541 MAX-ACCESS not-accessible 542 STATUS current 543 DESCRIPTION 544 "This table provides sets of application response time 545 reports. Each row of the table corresponds to a report. 546 Existing reports are deleted by the probe at the expiration 547 of each sampling period, and replaced with new reports for 548 the just-ended period. Generation of reports is controlled 549 using the objects in the artControlTable. 551 The maximum number of report rows in this table is the sum 552 of each of the artControlGrantedSize object values in 553 the artControlTable. 555 Note that this table is shared by all data sources, 556 although reports are generated independently for each 557 data source." 558 ::= { art 3 } 560 artEntry OBJECT-TYPE 561 SYNTAX ArtEntry 562 MAX-ACCESS not-accessible 563 STATUS current 564 DESCRIPTION 565 "A conceptual row in the artTable. 567 Each row corresponds to an application response time 568 report for an individual {data source, application-protocol, 569 client, server} quadruple. 571 Rows are created and deleted by the probe, and all objects are 572 read-only to the NMS. 574 Rows are indexed (in effect) by data source, application 575 protocol identifier, server address, and client address. 577 Note that only the client and server address index 578 components correspond to objects in the table." 579 INDEX { 580 artControlIndex, -- identifies data source 581 protocolDirLocalIndex, -- identifies application protocol 582 artServerAddress, -- identifies server 583 artClientAddress -- identifies client 584 } 585 ::= { artTable 1 } 587 ArtEntry ::= SEQUENCE { 588 artServerAddress OCTET STRING, 589 artClientAddress OCTET STRING, 590 artAvgRspTime Integer32, 591 artMinRspTime Integer32, 592 artMaxRspTime Integer32, 593 artTotalResponses Counter32, 594 artRsps1 Counter32, 595 artRsps2 Counter32, 596 artRsps3 Counter32, 597 artRsps4 Counter32, 598 artRsps5 Counter32, 599 artRsps6 Counter32, 600 artRsps7 Counter32, 601 artClientOctets Counter32, 602 artClientOverflowOctets Counter32, 603 artClientHCOctets Counter64, 604 artServerOctets Counter32, 605 artServerOverflowOctets Counter32, 606 artServerHCOctets Counter64, 607 artRetries Counter32, 608 artTimeouts Counter32 609 } 611 artServerAddress OBJECT-TYPE 612 SYNTAX OCTET STRING 613 MAX-ACCESS not-accessible 614 STATUS current 615 DESCRIPTION 616 "The address of the server. 618 This is identified as an octet string with specific 619 semantics and length as identified by the 620 protocolDirLocalIndex component of the index." 621 ::= { artEntry 1 } 623 artClientAddress OBJECT-TYPE 624 SYNTAX OCTET STRING 625 MAX-ACCESS not-accessible 626 STATUS current 627 DESCRIPTION 628 "The address of the client. 630 This is identified as an octet string with specific 631 semantics and length as identified by the 632 protocolDirLocalIndex component of the index." 633 ::= { artEntry 2 } 635 artAvgRspTime OBJECT-TYPE 636 SYNTAX Integer32 (0..2147483647) 637 UNITS "milliseconds" 638 MAX-ACCESS read-only 639 STATUS current 640 DESCRIPTION 641 "The average response time, in milliseconds, observed 642 during the report interval. Specification of milliseconds 643 as the time units does not require the probe to maintain 644 one-millisecond time granularity. 646 Response time is measured as the number of milliseconds, 647 as observed by the probe, between the final packet 648 of an application-layer request PDU from client to 649 server and the first packet of a response PDU from 650 server client. 652 This object is the arithmetical mean of the individual 653 response times observed during the interval. Only server 654 responses that the probe has successfully paired with 655 client requests are included in the calculation. 657 Additional semantics of 'response time' may depend on 658 the application being monitored." 659 ::= { artEntry 3 } 661 artMinRspTime OBJECT-TYPE 662 SYNTAX Integer32 (0..2147483647) 663 UNITS "milliseconds" 664 MAX-ACCESS read-only 665 STATUS current 666 DESCRIPTION 667 "The minimum response time, in milliseconds, observed 668 during the report interval. 670 This object is the minimum value of the individual 671 response times observed during the interval. Only server 672 responses that the probe has successfully paired with 673 client requests are included in the calculation." 674 ::= { artEntry 4 } 676 artMaxRspTime OBJECT-TYPE 677 SYNTAX Integer32 (0..2147483647) 678 UNITS "milliseconds" 679 MAX-ACCESS read-only 680 STATUS current 681 DESCRIPTION 682 "The maximum response time, in milliseconds, observed 683 during the report interval. 685 This object is the minimum value of the individual 686 response times observed during the interval. Only server 687 responses that the probe has successfully paired with 688 client requests are included in the calculation. 690 The probe should use wait for for artControlRspTimeout 691 milliseconds before abandoning the wait for a server 692 response." 693 ::= { artEntry 5 } 695 artTotalResponses OBJECT-TYPE 696 SYNTAX Counter32 697 MAX-ACCESS read-only 698 STATUS current 699 DESCRIPTION 700 "The total number of client requests that have been 701 successfully paired with a corresponding server response 702 during the report interval. 704 Requests that have been timed-out by the probe are not 705 counted by this object." 706 ::= { artEntry 6 } 708 artRsps1 OBJECT-TYPE 709 SYNTAX Counter32 710 MAX-ACCESS read-only 711 STATUS current 712 DESCRIPTION 713 "The first of seven counters used to categorize the response 714 times observed during the report interval. This object is a count 715 of responses that required less than artRspTime1 milliseconds." 716 ::= { artEntry 7 } 718 artRsps2 OBJECT-TYPE 719 SYNTAX Counter32 720 MAX-ACCESS read-only 721 STATUS current 722 DESCRIPTION 723 "The second of seven counters used to categorize the response 724 times observed during the report interval. This object 725 is a count of responses that required at least artRspTime1 726 milliseconds but less than artRspTime2 milliseconds." 727 ::= { artEntry 8 } 729 artRsps3 OBJECT-TYPE 730 SYNTAX Counter32 731 MAX-ACCESS read-only 732 STATUS current 733 DESCRIPTION 734 "The third of seven counters used to categorize the response 735 times observed during the report interval. This object 736 is a count of responses that required at least artRspTime2 737 milliseconds but less than artRspTime3 milliseconds." 738 ::= { artEntry 9 } 740 artRsps4 OBJECT-TYPE 741 SYNTAX Counter32 742 MAX-ACCESS read-only 743 STATUS current 744 DESCRIPTION 745 "The fourth of seven counters used to categorize the response 746 times observed during the report interval. This object 747 is a count of responses that required at least artRspTime3 748 milliseconds but less than artRspTime4 milliseconds." 749 ::= { artEntry 10 } 751 artRsps5 OBJECT-TYPE 752 SYNTAX Counter32 753 MAX-ACCESS read-only 754 STATUS current 755 DESCRIPTION 756 "The fifth of seven counters used to categorize the response 757 times observed during the report interval. This object 758 is a count of responses that required at least artRspTime4 759 milliseconds but less than artRspTime5 milliseconds." 761 ::= { artEntry 11 } 763 artRsps6 OBJECT-TYPE 764 SYNTAX Counter32 765 MAX-ACCESS read-only 766 STATUS current 767 DESCRIPTION 768 "The sixth of seven counters used to categorize the response 769 times observed during the report interval. This object 770 is a count of responses that required at least artRspTime5 771 milliseconds but less than artRspTime6 milliseconds." 772 ::= { artEntry 12 } 774 artRsps7 OBJECT-TYPE 775 SYNTAX Counter32 776 MAX-ACCESS read-only 777 STATUS current 778 DESCRIPTION 779 "The seventh of seven counters used to categorize the response 780 times observed during the report interval. This object 781 is a count of responses that required at least artRspTime6" 782 ::= { artEntry 13 } 784 artClientOctets OBJECT-TYPE 785 SYNTAX Counter32 786 MAX-ACCESS read-only 787 STATUS current 788 DESCRIPTION 789 "The total number of octets observed in client requests 790 during the report interval. If the application-layer PDU has 791 been fragmented into multiple packets, all octets in each of 792 the packets are included in this count." 793 ::= { artEntry 14 } 795 artClientOverflowOctets OBJECT-TYPE 796 SYNTAX Counter32 797 MAX-ACCESS read-only 798 STATUS current 799 DESCRIPTION 800 "The number of times the associated artClientOctets counter 801 has overflowed." 802 ::= { artEntry 15 } 804 artClientHCOctets OBJECT-TYPE 805 SYNTAX Counter64 806 MAX-ACCESS read-only 807 STATUS current 808 DESCRIPTION 809 "The high-capacity version of artClientOctets." 810 ::= { artEntry 16 } 812 artServerOctets OBJECT-TYPE 813 SYNTAX Counter32 814 MAX-ACCESS read-only 815 STATUS current 816 DESCRIPTION 817 "The total number of octets in server responses 818 during the report interval. If the application-layer PDU 819 has been fragmented into multiple packets, all octets in each 820 of the packets are included in this count." 821 ::= { artEntry 17 } 823 artServerOverflowOctets OBJECT-TYPE 824 SYNTAX Counter32 825 MAX-ACCESS read-only 826 STATUS current 827 DESCRIPTION 828 "The number of times the associated artServerOctets counter 829 has overflowed." 830 ::= { artEntry 18 } 832 artServerHCOctets OBJECT-TYPE 833 SYNTAX Counter64 834 MAX-ACCESS read-only 835 STATUS current 836 DESCRIPTION 837 "The high-capacity version of artServerOctets." 838 ::= { artEntry 19 } 840 artRetries OBJECT-TYPE 841 SYNTAX Counter32 842 MAX-ACCESS read-only 843 STATUS current 844 DESCRIPTION 845 "This total number of application-layer client retries 846 observed during the report interval." 847 ::= { artEntry 20 } 849 artTimeouts OBJECT-TYPE 850 SYNTAX Counter32 851 MAX-ACCESS read-only 852 STATUS current 853 DESCRIPTION 854 "The number of times the probe has timed-out a client 855 request while waiting for a server response during the 856 report interval. Timeouts may occur due to server 857 congestion or failure, network congestion or failure, 858 or probe congestion." 859 ::= { artEntry 21 } 861 -- 862 -- The ART Summary Report Table 863 -- 865 artSummaryTable OBJECT-TYPE 866 SYNTAX SEQUENCE OF ArtSummaryEntry 867 MAX-ACCESS not-accessible 868 STATUS current 869 DESCRIPTION 870 "This table provides sets of application response time 871 summary reports. Each row of the table corresponds to a report. 872 Existing reports are deleted by the probe at the expiration 873 of each sampling period, and replaced with new reports for 874 the just-ended period. Generation of reports is controlled 875 using the objects in the artControlTable. 877 Note that this table is shared by all probe data sources, 878 although reports are generated independently for each 879 data source." 880 ::= { art 5 } 882 artSummaryEntry OBJECT-TYPE 883 SYNTAX ArtSummaryEntry 884 MAX-ACCESS not-accessible 885 STATUS current 886 DESCRIPTION 887 "A conceptual row in the artSummaryTable. 889 Each row corresponds to an application response time 890 report for an individual {data source, application-protocol, 891 server} triple. Values in the each row correspond to the 892 summary of response time information of all clients of 893 the associated server, whereas the rows in the artTable 894 contain detailed information for {data source, application- 895 protocol, client, server} quadruples. 897 Rows are created and deleted by the probe, and all objects are 898 read-only to the NMS. 900 Rows are indexed (in effect) by data source, application 901 protocol identifier, and server address. 903 Note that only the server address index component 904 corresponds to an object in the table." 905 INDEX { 906 artControlIndex, -- identifies data source 907 protocolDirLocalIndex, -- identifies application protocol 908 artSummaryServerAddress -- identifies server 909 } 910 ::= { artSummaryTable 1 } 912 ArtSummaryEntry ::= SEQUENCE { 913 artSummaryServerAddress OCTET STRING, 914 artSummaryClients Integer32, 915 artSummaryAvgRspTime Integer32, 916 artSummaryMinRspTime Integer32, 917 artSummaryMaxRspTime Integer32, 918 artSummaryTotalResponses Counter32, 919 artSummaryRsps1 Counter32, 920 artSummaryRsps2 Counter32, 921 artSummaryRsps3 Counter32, 922 artSummaryRsps4 Counter32, 923 artSummaryRsps5 Counter32, 924 artSummaryRsps6 Counter32, 925 artSummaryRsps7 Counter32, 926 artSummaryClientOctets Counter32, 927 artSummaryClientOverflowOctets Counter32, 928 artSummaryClientHCOctets Counter64, 929 artSummaryServerOctets Counter32, 930 artSummaryServerOverflowOctets Counter32, 931 artSummaryServerHCOctets Counter64, 932 artSummaryRetries Counter32, 933 artSummaryTimeouts Counter32 934 } 936 artSummaryServerAddress OBJECT-TYPE 937 SYNTAX OCTET STRING 938 MAX-ACCESS not-accessible 939 STATUS current 940 DESCRIPTION 941 "The address of the server. 943 This is identified as an octet string with specific 944 semantics and length as identified by the 945 protocolDirLocalIndex component of the index." 946 ::= { artSummaryEntry 1 } 948 artSummaryClients OBJECT-TYPE 949 SYNTAX Integer32 (0..2147483647) 950 MAX-ACCESS read-only 951 STATUS current 952 DESCRIPTION 953 "The number of clients of this server for which requests 954 were successfully paired with server responses during 955 the report interval." 956 ::= { artSummaryEntry 2 } 958 artSummaryAvgRspTime OBJECT-TYPE 959 SYNTAX Integer32 (0..2147483647) 960 UNITS "milliseconds" 961 MAX-ACCESS read-only 962 STATUS current 963 DESCRIPTION 964 "The average response time, in milliseconds, observed 965 during the report interval. Specification of milliseconds 966 as the time units does not require the probe to maintain 967 one-millisecond time granularity. 969 Response time is measured as the number of milliseconds, 970 as observed by the probe, between the final packet 971 of an application-layer request PDU from client to 972 server and the first packet of a response PDU from 973 server client. 975 This object is the arithmetical mean of the individual 976 response times observed during the interval. Only server 977 responses that the probe has successfully paired with 978 client requests are included in the calculation. 980 Additional semantics of 'response time' may depend on 981 the application being monitored." 982 ::= { artSummaryEntry 3 } 984 artSummaryMinRspTime OBJECT-TYPE 985 SYNTAX Integer32 (0..2147483647) 986 UNITS "milliseconds" 987 MAX-ACCESS read-only 988 STATUS current 989 DESCRIPTION 990 "The minimum response time, in milliseconds, observed 991 during the report interval. 993 This object is the minimum value of the individual 994 response times observed during the interval. Only server 995 responses that the probe has successfully paired with 996 client requests are included in the calculation." 997 ::= { artSummaryEntry 4 } 999 artSummaryMaxRspTime OBJECT-TYPE 1000 SYNTAX Integer32 (0..2147483647) 1001 UNITS "milliseconds" 1002 MAX-ACCESS read-only 1003 STATUS current 1004 DESCRIPTION 1005 "The maximum response time, in milliseconds, observed 1006 during the report interval. 1008 This object is the minimum value of the individual 1009 response times observed during the interval. Only server 1010 responses that the probe has successfully paired with 1011 client requests are included in the calculation. 1013 The probe should use a reasonable timeout period before 1014 abandoning the wait for a server response." 1015 ::= { artSummaryEntry 5 } 1017 artSummaryTotalResponses OBJECT-TYPE 1018 SYNTAX Counter32 1019 MAX-ACCESS read-only 1020 STATUS current 1021 DESCRIPTION 1022 "The total number of client requests that have been 1023 successfully paired with a corresponding server response 1024 during the report interval. 1026 Requests that have been timed-out by the probe are not 1027 counted by this object." 1028 ::= { artSummaryEntry 6 } 1030 artSummaryRsps1 OBJECT-TYPE 1031 SYNTAX Counter32 1032 MAX-ACCESS read-only 1033 STATUS current 1034 DESCRIPTION 1035 "The first of seven counters used to categorize the response 1036 times observed during the report interval. This object is a count 1037 of responses that required less than artControlRspTime1 milliseconds." 1038 ::= { artSummaryEntry 7 } 1040 artSummaryRsps2 OBJECT-TYPE 1041 SYNTAX Counter32 1042 MAX-ACCESS read-only 1043 STATUS current 1044 DESCRIPTION 1045 "The second of seven counters used to categorize the response 1046 times observed during the report interval. This object 1047 is a count of responses that required at least artControlRspTime1 1048 milliseconds but less than artControlRspTime2 milliseconds." 1049 ::= { artSummaryEntry 8 } 1051 artSummaryRsps3 OBJECT-TYPE 1052 SYNTAX Counter32 1053 MAX-ACCESS read-only 1054 STATUS current 1055 DESCRIPTION 1056 "The third of seven counters used to categorize the response 1057 times observed during the report interval. This object 1058 is a count of responses that required at least artControlRspTime2 1059 milliseconds but less than artControlRspTime3 milliseconds." 1060 ::= { artSummaryEntry 9 } 1062 artSummaryRsps4 OBJECT-TYPE 1063 SYNTAX Counter32 1064 MAX-ACCESS read-only 1065 STATUS current 1066 DESCRIPTION 1067 "The fourth of seven counters used to categorize the response 1068 times observed during the report interval. This object 1069 is a count of responses that required at least artControlRspTime3 1070 milliseconds but less than artControlRspTime4 milliseconds." 1071 ::= { artSummaryEntry 10 } 1073 artSummaryRsps5 OBJECT-TYPE 1074 SYNTAX Counter32 1075 MAX-ACCESS read-only 1076 STATUS current 1077 DESCRIPTION 1078 "The fifth of seven counters used to categorize the response 1079 times observed during the report interval. This object 1080 is a count of responses that required at least artControlRspTime4 1081 milliseconds but less than artControlRspTime5 milliseconds." 1083 ::= { artSummaryEntry 11 } 1085 artSummaryRsps6 OBJECT-TYPE 1086 SYNTAX Counter32 1087 MAX-ACCESS read-only 1088 STATUS current 1089 DESCRIPTION 1090 "The sixth of seven counters used to categorize the response 1091 times observed during the report interval. This object 1092 is a count of responses that required at least artControlRspTime5 1093 milliseconds but less than artControlRspTime6 milliseconds." 1094 ::= { artSummaryEntry 12 } 1096 artSummaryRsps7 OBJECT-TYPE 1097 SYNTAX Counter32 1098 MAX-ACCESS read-only 1099 STATUS current 1100 DESCRIPTION 1101 "The seventh of seven counters used to categorize the response 1102 times observed during the report interval. This object 1103 is a count of responses that required at least artControlRspTime6" 1104 ::= { artSummaryEntry 13 } 1106 artSummaryClientOctets OBJECT-TYPE 1107 SYNTAX Counter32 1108 MAX-ACCESS read-only 1109 STATUS current 1110 DESCRIPTION 1111 "The total number of octets observed in client requests 1112 during the report interval. If the application-layer PDU has 1113 been fragmented into multiple packets, all octets in each of 1114 the packets are included in this count." 1115 ::= { artSummaryEntry 14 } 1117 artSummaryClientOverflowOctets OBJECT-TYPE 1118 SYNTAX Counter32 1119 MAX-ACCESS read-only 1120 STATUS current 1121 DESCRIPTION 1122 "The number of times the associated artClientOctets counter 1123 has overflowed." 1124 ::= { artSummaryEntry 15 } 1126 artSummaryClientHCOctets OBJECT-TYPE 1127 SYNTAX Counter64 1128 MAX-ACCESS read-only 1129 STATUS current 1130 DESCRIPTION 1131 "The high-capacity version of artSummaryClientOctets." 1132 ::= { artSummaryEntry 16 } 1134 artSummaryServerOctets OBJECT-TYPE 1135 SYNTAX Counter32 1136 MAX-ACCESS read-only 1137 STATUS current 1138 DESCRIPTION 1139 "The total number of octets in server responses 1140 during the report interval. If the application-layer PDU 1141 has been fragmented into multiple packets, all octets in each 1142 of the packets are included in this count." 1143 ::= { artSummaryEntry 17 } 1145 artSummaryServerOverflowOctets OBJECT-TYPE 1146 SYNTAX Counter32 1147 MAX-ACCESS read-only 1148 STATUS current 1149 DESCRIPTION 1150 "The number of times the associated artSummaryServerOctets counter 1151 has overflowed." 1152 ::= { artSummaryEntry 18 } 1154 artSummaryServerHCOctets OBJECT-TYPE 1155 SYNTAX Counter64 1156 MAX-ACCESS read-only 1157 STATUS current 1158 DESCRIPTION 1159 "The high-capacity version of artSummaryServerOctets." 1160 ::= { artSummaryEntry 19 } 1162 artSummaryRetries OBJECT-TYPE 1163 SYNTAX Counter32 1164 MAX-ACCESS read-only 1165 STATUS current 1166 DESCRIPTION 1167 "This total number of application-layer client retries 1168 observed during the report interval." 1169 ::= { artSummaryEntry 20 } 1171 artSummaryTimeouts OBJECT-TYPE 1172 SYNTAX Counter32 1173 MAX-ACCESS read-only 1174 STATUS current 1175 DESCRIPTION 1176 "The number of times the probe has timed-out a client 1177 request while waiting for a server response during the 1178 report interval. Timeouts may occur due to server 1179 congestion or failure, network congestion or failure, 1180 or probe congestion." 1181 ::= { artSummaryEntry 21 } 1183 -- 1184 -- ART Groups and conformance. 1185 -- 1187 artConformance OBJECT IDENTIFIER ::= { art 4 } 1189 artMIBCompliances OBJECT IDENTIFIER ::= { artConformance 1 } 1190 artMIBGroups OBJECT IDENTIFIER ::= { artConformance 2 } 1192 artMIBCompliance MODULE-COMPLIANCE 1193 STATUS current 1194 DESCRIPTION 1195 "Describes the requirements for conformance to 1196 the ART MIB." 1197 MODULE -- this module 1198 MANDATORY-GROUPS { artGroup } 1199 ::= { artMIBCompliances 1 } 1201 artGroup OBJECT-GROUP 1202 OBJECTS { 1203 protocolDir2ArtConfig, 1204 artControlDataSource, 1205 artControlTimeRemaining, 1206 artControlDuration, 1207 artControlRspTime1, 1208 artControlRspTime2, 1209 artControlRspTime3, 1210 artControlRspTime4, 1211 artControlRspTime5, 1212 artControlRspTime6, 1213 artControlRspTimeout, 1214 artControlRptStartTime, 1215 artControlRequestedSize, 1216 artControlGrantedSize, 1217 artControlGeneratedRpts, 1218 artControlDroppedFrames, 1219 artControlOwner, 1220 artControlStatus, 1221 artAvgRspTime, 1222 artMinRspTime, 1223 artMaxRspTime, 1224 artTotalResponses, 1225 artRsps1, 1226 artRsps2, 1227 artRsps3, 1228 artRsps4, 1229 artRsps5, 1230 artRsps6, 1231 artRsps7, 1232 artClientOctets, 1233 artClientOverflowOctets, 1234 artClientHCOctets, 1235 artServerOctets, 1236 artServerOverflowOctets, 1237 artServerHCOctets, 1238 artRetries, 1239 artTimeouts, 1240 artSummaryClients, 1241 artSummaryAvgRspTime, 1242 artSummaryMinRspTime, 1243 artSummaryMaxRspTime, 1244 artSummaryTotalResponses, 1245 artSummaryRsps1, 1246 artSummaryRsps2, 1247 artSummaryRsps3, 1248 artSummaryRsps4, 1249 artSummaryRsps5, 1250 artSummaryRsps6, 1251 artSummaryRsps7, 1252 artSummaryClientOctets, 1253 artSummaryClientOverflowOctets, 1254 artSummaryClientHCOctets, 1255 artSummaryServerOctets, 1256 artSummaryServerOverflowOctets, 1257 artSummaryServerHCOctets, 1258 artSummaryRetries, 1259 artSummaryTimeouts 1260 } 1261 STATUS current 1262 DESCRIPTION 1263 "This group adds application response time measurement to RMON2." 1264 ::= { artMIBGroups 1 } 1266 END 1268 Applications Response Time MIB (ART MIB) June 1998 1270 Company Confidential Page 2 Printed on June 30, 1998 1271 Filename: draft-ietf-rmon2-artmib-00 (c)1998 NetScout Systems, Inc.