[Search] [txt|pdf|bibtex] [Tracker] [Email] [Nits]

Versions: 00 01                                                         
INTERNET DRAFT                                          Expires January 1999
                                                                   Albin Warth
                                                                   Jim McQuaid
                                                        NetScout Systems, Inc.


                    Applications Response Time MIB (ART MIB)
                     <draft-warth-rmon2-artmib-00.txt>

                                July 13, 1998


1.  Status of this Memo
This document is an Internet-Draft.  Internet-Drafts are working
documents of the Internet Engineering Task Force (IETF), its areas, and
its working groups.  Note that other groups may also distribute working
documents as Internet- Drafts.

Internet-Drafts are draft documents valid for a maximum of six months.
Internet-Drafts may be updated, replaced, or obsoleted by other
documents at any time.  It is not appropriate to use Internet-Drafts as
reference material or to cite them other than as a ``working draft'' or
``work in progress.''

To view the entire list of current Internet-Drafts, please check the
"1id- abstracts.txt" listing contained in the Internet-Drafts Shadow
Directories on ftp.is.co.za (Africa), ftp.nordu.net (Northern Europe),
ftp.nis.garr.it (Southern Europe), munnari.oz.au (Pacific Rim),
ftp.ietf.org (US East Coast), or ftp.isi.edu (US West Coast).


2.  Abstract
This memo defines a MIB for application response time, based on the RMON2 MIB
for use with the SNMP network management architecture.

This memo does not specify a standard for the Internet community.

3.      Introduction
RMON2 provides detailed information about the composition of network traffic.
Beyond utilization and related measures of bytes and packets seen, RMON2
provides no direct information about the performance of the network in support
of specific applications flowing through it.  The Application Response Time MIB
(ART MIB) is an extension of RMON2 which provides such performance information.

The basic model of network interaction measured by the ART MIB is the request-
response pair.  The procedure for determining the identity and pairing of
requests and responses is not part of the MIB structure and the MIB is only
dependent on some workable definition.  The NetScout Systems initial
implementation uses several protocol request-response pairs including general
TCP dialogs, identified as socket pairs, and individual data segments and their
acknowledgements as one primary example.  Dialog performance, then, consists of
packets exchanged by nodes operating in the role of client and a server for the
purposes of that exchange.  The client-server distinction will be clear in the
case of well-known protocols and arbitrary in the case of non-standard
protocols.

4.      Relation To RMON2
The ART MIB uses the RMON2 protocol directory structure to identify protocols
for which the agent can match requests and responses.  The protocol directory is
augmented by information in the protocolDir2ArtConfig object indicating whether
the protocol is supported and whether it is enabled.  [This version branches
from NetScout's private enterprise branch.  Presumably a final version would
branch from RMON2.]

5.      General Function
The ART MIB accumulates the elapsed times in milliseconds, for all request-
response pairs the agent observes during a specific user-controlled report
period.  Typical values for this report period might be 5 to 15 minutes.  At the
end of this time, the collection appears in the MIB and a new collection of
measurements begins.

5.1     Control Entries
The controls for the ART MIB consist of several items, most of them familiar
RMON2 constructs.  artControlDuration is the value of the time period over which
measurements are made and averaged.  The six (millisecond) values
artControlRspTime1 through artControlRspTime6 define seven buckets used to
report the distribution of measurements during the time period. The value
artControlRspTimeout effectively defines the upper boundary of the seventh
bucket.


5.2     Client Data
For each unique client-server dialog being measured, the MIB provides a row
containing the following information for the report interval:

o       The server and client addresses for identification
o       The average of all individual response time measurements made
o       The minimum and the maximum individual response time measurements
o       The total number of responses measured, that is, the total number of request-
response pairs that could be matched during this report interval
o       Seven buckets, each containing a count of individual response times falling
within the buckets time boundaries
o       Number of octets sent and received, expressed in both 32-bit and HC 64-bit
notations
o       The number of retries and the number of timeouts. Timeouts correspond to
requests whose matching response was not seen within the timeout interval

5.3     Server Summary Data
The ART MIB also provides a summary of all the clients talking to an individual
server.  This contains identical data to the individual client-server rows, but
the values reflect the aggregate of all clients seen to be talking with any
common server.

The summary data provides a way to retrieve representative data about a
potentially large group of conversations in a compact way.

6.      Authors Addresses

Albin Warth
NetScout Systems, Inc.
4 Technology Park Drive
Westford, MA 01886
1 978 614 4306
albin@netscout.com

Jim McQuaid
NetScout Systems, Inc.
4 Technology Park Drive
Westford, MA 01886
1 978 614 4116
mcquaidj@netscout.com



6.      The ART MIB

-- ART MIB definitions (SMIv2 syntax)
--
--

ART-MIB DEFINITIONS ::= BEGIN
IMPORTS
--  netscout2 FROM NETSCOUT-MIB
    MODULE-IDENTITY, OBJECT-TYPE, enterprises, Counter32, Integer32,
        Counter64 FROM SNMPv2-SMI
    RowStatus, TimeStamp
        FROM SNMPv2-TC
    MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF
    OwnerString FROM RMON-MIB
    DataSource, protocolDirEntry, protocolDirLocalIndex FROM RMON2-MIB;

art MODULE-IDENTITY
    LAST-UPDATED "9804210000Z"
    ORGANIZATION "NetScout Systems, Inc."
    CONTACT-INFO
        "Albin Warth
         Postal: NetScout Systems, Inc.
         4 Technology Park Drive
         Westford, MA 01886
         Phone: +1 978 614 4306
         Email: albin@netscout.com"
    DESCRIPTION
        "The MIB module for Application Response Time measurement."
    ::= { netscout2 5 }

--
-- ART extends Enterprise RMON by creating a new branch...
--
-- (Can also do this by importing netscout2 FROM NETSCOUT-MIB)
--

frontier  OBJECT IDENTIFIER ::= { enterprises 141 }
mibdoc2   OBJECT IDENTIFIER ::= { frontier 2 }
netscout2 OBJECT IDENTIFIER ::= { mibdoc2 1 }


--
-- The ART augmentation of the RMON-2 Protocol Directory.
-- This defines (in effect) an additional column in the protocolDirTable.
--

protocolDir2Table  OBJECT-TYPE
    SYNTAX     SEQUENCE OF ProtocolDir2Entry
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
        "Contains the ART augmentations to RMON-2."
    ::= { art 1 }

protocolDir2Entry  OBJECT-TYPE
    SYNTAX     ProtocolDir2Entry
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
        "Contains the ART augmentations to RMON-2."
    AUGMENTS { protocolDirEntry }
    ::= { protocolDir2Table 1 }

ProtocolDir2Entry ::= SEQUENCE {
    protocolDir2ArtConfig INTEGER
}

protocolDir2ArtConfig OBJECT-TYPE
    SYNTAX INTEGER {
          notSupported(1),
          supportedOff(2),
          supportedOn(3)
    }
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "This object describes and configures the probe's support for
        application response time monitoring for the protocol.

        When the probe creates entries in this table for
        all protocols that it understands, it will set the entry to
        notSupported(1) if it doesn't have the capability to track
        application response time for this protocol.

        If the value of this object is supportedOff(2), the probe
        supports tracking of application response time, but is
        configured to not track response time for any control
        entries or data sources.

        If the value of this object is supportedOn(3), the probe
        supports tracking of application response time for this
        protocol, and will allow creation of entries in the
        artControlTable for the associated protocol.

        Whenever this value changes from supportedOn(3) to
        supportedOff(2), the probe shall delete all related entries in
        the artTable and artSummaryTable."
    ::= { protocolDir2Entry 1 }

--
-- The ART Report Control Table
--

artControlTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF ArtControlEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "This table lists the data sources (typically, probe interfaces)
        for which application response time collection is enabled,
        and additionally controls the generation of ART reports in
        the artTable and artSummaryTable."
    ::= { art 2 }

artControlEntry OBJECT-TYPE
    SYNTAX      ArtControlEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "A conceptual row in the artControlTable.

        Creation of a row enables ART collection and report generation
        for the corresponding data source.

        The artControlRspTime{1..6} objects are used to categorize the
        request-response pairs observed during an ART sample interval.


        The NMS is responsible to ensure that:
          artControlRspTime1 <= artControlRspTime2
          artControlRspTime2 <= artControlRspTime3
          artControlRspTime3 <= artControlRspTime4
          artControlRspTime4 <= artControlRspTime5
          artControlRspTime5 <= artControlRspTime6

        and that:
          artControlRspTime6 <= artControlRspTimeout

        If these relationships do not hold, the probe rejects any
        attempt to set the artControlStatus object to active(1).

        Suggested default values for the time ranges are:
          artControlRspTime1     25 milliseconds
          artControlRspTime2     50 milliseconds
          artControlRspTime3    100 milliseconds
          artControlRspTime4    200 milliseconds
          artControlRspTime5    400 milliseconds
          artControlRspTime6    800 milliseconds

        The table is implicitly indexed by data source,
        using the DataSource identifier corresponding to
        the data source."
    INDEX { artControlIndex }
    ::= { artControlTable 1 }

ArtControlEntry ::= SEQUENCE {
    artControlIndex               Integer32,
    artControlDataSource          DataSource,
    artControlTimeRemaining       Integer32,
    artControlDuration            Integer32,
    artControlRspTime1            Integer32,
    artControlRspTime2            Integer32,
    artControlRspTime3            Integer32,
    artControlRspTime4            Integer32,
    artControlRspTime5            Integer32,
    artControlRspTime6            Integer32,
    artControlRspTimeout          Integer32,
    artControlRptStartTime        TimeStamp,
    artControlRequestedSize       Integer32,
    artControlGrantedSize         Integer32,
    artControlGeneratedRpts       Integer32,
    artControlDroppedFrames       Counter32,
    artControlOwner               OwnerString,
    artControlStatus              RowStatus
}

artControlIndex OBJECT-TYPE
    SYNTAX      Integer32 (1..65535)
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "A unique index for this artControlEntry."
    ::= { artControlEntry 1 }

artControlDataSource OBJECT-TYPE
    SYNTAX      DataSource
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "The source of data for application response-time collection,
        i.e., the data source (typically, a probe interface) for which
        ART statistics are to be collected and reports generated.

        This object shall not be modified if the associated
        artControlStatus is equal to active(1)."
    ::= { artControlEntry 2 }

artControlTimeRemaining OBJECT-TYPE
    SYNTAX      Integer32 (0..86400)    -- 24 hours
    UNITS       "seconds"
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "The number of seconds remaining in the current report
        interval.  When this value reaches zero, the probe deletes
        any existing reports for the associated data source, creates
        a new report corresponding to the just-expired interval,
        copies the current value of artControlDuration to this object,
        and starts a new collection interval.

        The value of this object is latched in artControlDuration
        whenever it is written to using SNMP, allowing automatic
        restart of collection using the same duration.

        If this object is overwritten while the associated
        artStatus is equal to active(1), the current collection
        for the associated data source is abandoned, and a new
        collection started using the new interval.

        Setting this value to 0 abandons current collection and
        disables report generation for the associated data source.
        (This is not recommended -- better to delete the row.)

        The probe should delay the initial countdown of this
        object in order to align report intervals to 12:00 AM UTC."
    ::= { artControlEntry 3 }

artControlDuration OBJECT-TYPE
    SYNTAX      Integer32 (0..86400)    -- 24 hours
    UNITS       "seconds"
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "This object is used to latch the value of artTimeRemaining
        for automatic collection restart at the end of a collection
        interval."

    ::= { artControlEntry 4 }

artControlRspTime1 OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "The first of six time values used to categorize the response
        times observed during the report interval.

        This object may not be changed while artControlStatus is set
        to active(1)."
    ::= { artControlEntry 5 }

artControlRspTime2 OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "The second of six time values used to categorize the response
        times observed during the report interval.

        This object may not be changed while artControlStatus is set
        to active(1)."
    ::= { artControlEntry 6 }

artControlRspTime3 OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "The third of six time values used to categorize the response
        times observed during the report interval.

        This object may not be changed while artControlStatus is set
        to active(1)."
    ::= { artControlEntry 7 }

artControlRspTime4 OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "The fourth of six time values used to categorize the response
        times observed during the report interval.

        This object may not be changed while artControlStatus is set
        to active(1)."
    ::= { artControlEntry 8 }

artControlRspTime5 OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "The fifth of six time values used to categorize the response
        times observed during the report interval.

        This object may not be changed while artControlStatus is set
        to active(1)."
    ::= { artControlEntry 9 }

artControlRspTime6 OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "The sixth of six time values used to categorize the response
        times observed during the report interval.

        This object may not be changed while artControlStatus is set
        to active(1)."
    ::= { artControlEntry 10 }

artControlRspTimeout OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "The maximum interval that the probe will wait for a server response
        to a client request.  Requests older than this value are
        abandoned, and counted as artTimeouts in the artTable and
        as artSummaryTimeouts in the artSummaryTable.

        This object may not be changed while artControlStatus is set
        to active(1)."
    ::= { artControlEntry 11 }

artControlRptStartTime OBJECT-TYPE
    SYNTAX      TimeStamp
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The time at which collection of the currently available
        reports was started."
    ::= { artControlEntry 12 }

artControlRequestedSize OBJECT-TYPE
    SYNTAX     Integer32 (-1..65535)
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "The maximum number of report rows to be generated in the
        artTable for the associated data source.  If set to -1, the
        maximum number of report rows shall be determined by the probe
        based on available resources."
    ::= { artControlEntry 13 }

artControlGrantedSize OBJECT-TYPE
    SYNTAX     Integer32 (0..65535)
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The maximum number of report rows in the artTable granted by
        the probe for the associated data source.  The value of this
        object may be less than the requested size."
    ::= { artControlEntry 14 }

artControlGeneratedRpts OBJECT-TYPE
    SYNTAX      Integer32 (0..65535)
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of report sets that have been generated by this entry.

        The NMS may use this value to poll for the availability of
        a new report set.  It may also sample this value before and after
        a sweep of the artTable or artSummaryTable in order to verify
        that a new report set was not generated during the sweep."
    ::= { artControlEntry 15 }

artControlDroppedFrames OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
       "The total number of frames which were received by the probe
        and therefore not accounted for in the *StatsDropEvents, but
        for which the probe chose not to count for this entry for
        whatever reason.  Most often, this event occurs when the probe
        is out of some resources and decides to shed load from this
        collection.

        This count does not include packets that were not counted
        because they had MAC-layer errors.

        Note that, unlike the dropEvents counter, this number is the
        exact number of frames dropped."
    ::= { artControlEntry 16 }

artControlOwner OBJECT-TYPE
    SYNTAX      OwnerString
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "The entity that configured this entry and is therefore using
        the resources assigned to it."
    ::= { artControlEntry 17 }

artControlStatus OBJECT-TYPE
    SYNTAX      RowStatus
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "The status of this control table entry.

        An entry must not exist in the active state unless all
        objects in the entry have an appropriate value.

        If this object is not equal to active(1), all associated
        entries in the artTable and artSummaryTable shall be deleted."
    ::= { artControlEntry 18 }



--
-- The ART Report Table
--

artTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF ArtEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "This table provides sets of application response time
        reports.  Each row of the table corresponds to a report.
        Existing reports are deleted by the probe at the expiration
        of each sampling period, and replaced with new reports for
        the just-ended period.  Generation of reports is controlled
        using the objects in the artControlTable.

        The maximum number of report rows in this table is the sum
        of each of the artControlGrantedSize object values in
        the artControlTable.

        Note that this table is shared by all data sources,
        although reports are generated independently for each
        data source."
    ::= { art 3 }

artEntry OBJECT-TYPE
    SYNTAX      ArtEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "A conceptual row in the artTable.

        Each row corresponds to an application response time
        report for an individual {data source, application-protocol,
        client, server} quadruple.

        Rows are created and deleted by the probe, and all objects are
        read-only to the NMS.

        Rows are indexed (in effect) by data source, application
        protocol identifier, server address, and client address.

        Note that only the client and server address index
        components correspond to objects in the table."
    INDEX   {
            artControlIndex,        -- identifies data source
            protocolDirLocalIndex,  -- identifies application protocol
            artServerAddress,       -- identifies server
            artClientAddress        -- identifies client
            }
    ::= { artTable 1 }

ArtEntry ::= SEQUENCE {
    artServerAddress         OCTET STRING,
    artClientAddress         OCTET STRING,
    artAvgRspTime            Integer32,
    artMinRspTime            Integer32,
    artMaxRspTime            Integer32,
    artTotalResponses        Counter32,
    artRsps1                 Counter32,
    artRsps2                 Counter32,
    artRsps3                 Counter32,
    artRsps4                 Counter32,
    artRsps5                 Counter32,
    artRsps6                 Counter32,
    artRsps7                 Counter32,
    artClientOctets          Counter32,
    artClientOverflowOctets  Counter32,
    artClientHCOctets        Counter64,
    artServerOctets          Counter32,
    artServerOverflowOctets  Counter32,
    artServerHCOctets        Counter64,
    artRetries               Counter32,
    artTimeouts              Counter32
}

artServerAddress OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The address of the server.

        This is identified as an octet string with specific
        semantics and length as identified by the
        protocolDirLocalIndex component of the index."
    ::= { artEntry 1 }

artClientAddress OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The address of the client.

        This is identified as an octet string with specific
        semantics and length as identified by the
        protocolDirLocalIndex component of the index."
    ::= { artEntry 2 }

artAvgRspTime OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The average response time, in milliseconds, observed
        during the report interval.  Specification of milliseconds
        as the time units does not require the probe to maintain
        one-millisecond time granularity.

        Response time is measured as the number of milliseconds,
        as observed by the probe, between the final packet
        of an application-layer request PDU from client to
        server and the first packet of a response PDU from
        server client.

        This object is the arithmetical mean of the individual
        response times observed during the interval.  Only server
        responses that the probe has successfully paired with
        client requests are included in the calculation.

        Additional semantics of 'response time' may depend on
        the application being monitored."
    ::= { artEntry 3 }

artMinRspTime OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The minimum response time, in milliseconds, observed
        during the report interval.

        This object is the minimum value of the individual
        response times observed during the interval.  Only server
        responses that the probe has successfully paired with
        client requests are included in the calculation."
    ::= { artEntry 4 }

artMaxRspTime OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The maximum response time, in milliseconds, observed
        during the report interval.

        This object is the minimum value of the individual
        response times observed during the interval.  Only server
        responses that the probe has successfully paired with
        client requests are included in the calculation.

        The probe should use wait for for artControlRspTimeout
        milliseconds before abandoning the wait for a server
        response."
    ::= { artEntry 5 }

artTotalResponses OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The total number of client requests that have been
        successfully paired with a corresponding server response
        during the report interval.

        Requests that have been timed-out by the probe are not
        counted by this object."
    ::= { artEntry 6 }

artRsps1 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The first of seven counters used to categorize the response
        times observed during the report interval.  This object is a count
        of responses that required less than artRspTime1 milliseconds."
    ::= { artEntry 7 }

artRsps2 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The second of seven counters used to categorize the response
        times observed during the report interval.  This object
        is a count of responses that required at least artRspTime1
        milliseconds but less than artRspTime2 milliseconds."
    ::= { artEntry 8 }

artRsps3 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The third of seven counters used to categorize the response
        times observed during the report interval.  This object
        is a count of responses that required at least artRspTime2
        milliseconds but less than artRspTime3 milliseconds."
    ::= { artEntry 9 }

artRsps4 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The fourth of seven counters used to categorize the response
        times observed during the report interval.  This object
        is a count of responses that required at least artRspTime3
        milliseconds but less than artRspTime4 milliseconds."
    ::= { artEntry 10 }

artRsps5 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The fifth of seven counters used to categorize the response
        times observed during the report interval.  This object
        is a count of responses that required at least artRspTime4
        milliseconds but less than artRspTime5 milliseconds."

    ::= { artEntry 11 }

artRsps6 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The sixth of seven counters used to categorize the response
        times observed during the report interval.  This object
        is a count of responses that required at least artRspTime5
        milliseconds but less than artRspTime6 milliseconds."
    ::= { artEntry 12 }

artRsps7 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The seventh of seven counters used to categorize the response
        times observed during the report interval.  This object
        is a count of responses that required at least artRspTime6"
    ::= { artEntry 13 }

artClientOctets OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The total number of octets observed in client requests
        during the report interval.  If the application-layer PDU has
        been fragmented into multiple packets, all octets in each of
        the packets are included in this count."
    ::= { artEntry 14 }

artClientOverflowOctets OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of times the associated artClientOctets counter
        has overflowed."
    ::= { artEntry 15 }

artClientHCOctets OBJECT-TYPE
    SYNTAX      Counter64
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The high-capacity version of artClientOctets."
    ::= { artEntry 16 }

artServerOctets OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The total number of octets in server responses
        during the report interval.  If the application-layer PDU
        has been fragmented into multiple packets, all octets in each
        of the packets are included in this count."
    ::= { artEntry 17 }

artServerOverflowOctets OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of times the associated artServerOctets counter
        has overflowed."
    ::= { artEntry 18 }

artServerHCOctets OBJECT-TYPE
    SYNTAX      Counter64
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The high-capacity version of artServerOctets."
    ::= { artEntry 19 }

artRetries OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "This total number of application-layer client retries
        observed during the report interval."
    ::= { artEntry 20 }

artTimeouts OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of times the probe has timed-out a client
        request while waiting for a server response during the
        report interval.  Timeouts may occur due to server
        congestion or failure, network congestion or failure,
        or probe congestion."
    ::= { artEntry 21 }


--
-- The ART Summary Report Table
--

artSummaryTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF ArtSummaryEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "This table provides sets of application response time
        summary reports.  Each row of the table corresponds to a report.
        Existing reports are deleted by the probe at the expiration
        of each sampling period, and replaced with new reports for
        the just-ended period.  Generation of reports is controlled
        using the objects in the artControlTable.

        Note that this table is shared by all probe data sources,
        although reports are generated independently for each
        data source."
    ::= { art 5 }

artSummaryEntry OBJECT-TYPE
    SYNTAX      ArtSummaryEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "A conceptual row in the artSummaryTable.

        Each row corresponds to an application response time
        report for an individual {data source, application-protocol,
        server} triple.  Values in the each row correspond to the
        summary of response time information of all clients of
        the associated server, whereas the rows in the artTable
        contain detailed information for {data source, application-
        protocol, client, server} quadruples.

        Rows are created and deleted by the probe, and all objects are
        read-only to the NMS.

        Rows are indexed (in effect) by data source, application
        protocol identifier, and server address.

        Note that only the server address index component
        corresponds to an object in the table."
    INDEX   {
            artControlIndex,         -- identifies data source
            protocolDirLocalIndex,   -- identifies application protocol
            artSummaryServerAddress  -- identifies server
            }
    ::= { artSummaryTable 1 }

ArtSummaryEntry ::= SEQUENCE {
    artSummaryServerAddress         OCTET STRING,
    artSummaryClients               Integer32,
    artSummaryAvgRspTime            Integer32,
    artSummaryMinRspTime            Integer32,
    artSummaryMaxRspTime            Integer32,
    artSummaryTotalResponses        Counter32,
    artSummaryRsps1                 Counter32,
    artSummaryRsps2                 Counter32,
    artSummaryRsps3                 Counter32,
    artSummaryRsps4                 Counter32,
    artSummaryRsps5                 Counter32,
    artSummaryRsps6                 Counter32,
    artSummaryRsps7                 Counter32,
    artSummaryClientOctets          Counter32,
    artSummaryClientOverflowOctets  Counter32,
    artSummaryClientHCOctets        Counter64,
    artSummaryServerOctets          Counter32,
    artSummaryServerOverflowOctets  Counter32,
    artSummaryServerHCOctets        Counter64,
    artSummaryRetries               Counter32,
    artSummaryTimeouts              Counter32
}


artSummaryServerAddress OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The address of the server.

        This is identified as an octet string with specific
        semantics and length as identified by the
        protocolDirLocalIndex component of the index."
    ::= { artSummaryEntry 1 }

artSummaryClients OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of clients of this server for which requests
        were successfully paired with server responses during
        the report interval."
    ::= { artSummaryEntry 2 }

artSummaryAvgRspTime OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The average response time, in milliseconds, observed
        during the report interval.  Specification of milliseconds
        as the time units does not require the probe to maintain
        one-millisecond time granularity.

        Response time is measured as the number of milliseconds,
        as observed by the probe, between the final packet
        of an application-layer request PDU from client to
        server and the first packet of a response PDU from
        server client.

        This object is the arithmetical mean of the individual
        response times observed during the interval.  Only server
        responses that the probe has successfully paired with
        client requests are included in the calculation.

        Additional semantics of 'response time' may depend on
        the application being monitored."
    ::= { artSummaryEntry 3 }

artSummaryMinRspTime OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The minimum response time, in milliseconds, observed
        during the report interval.

        This object is the minimum value of the individual
        response times observed during the interval.  Only server
        responses that the probe has successfully paired with
        client requests are included in the calculation."
    ::= { artSummaryEntry 4 }

artSummaryMaxRspTime OBJECT-TYPE
    SYNTAX      Integer32 (0..2147483647)
    UNITS       "milliseconds"
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The maximum response time, in milliseconds, observed
        during the report interval.

        This object is the minimum value of the individual
        response times observed during the interval.  Only server
        responses that the probe has successfully paired with
        client requests are included in the calculation.

        The probe should use a reasonable timeout period before
        abandoning the wait for a server response."
    ::= { artSummaryEntry 5 }

artSummaryTotalResponses OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The total number of client requests that have been
        successfully paired with a corresponding server response
        during the report interval.

        Requests that have been timed-out by the probe are not
        counted by this object."
    ::= { artSummaryEntry 6 }

artSummaryRsps1 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The first of seven counters used to categorize the response
        times observed during the report interval.  This object is a count
        of responses that required less than artControlRspTime1 milliseconds."
    ::= { artSummaryEntry 7 }

artSummaryRsps2 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The second of seven counters used to categorize the response
        times observed during the report interval.  This object
        is a count of responses that required at least artControlRspTime1
        milliseconds but less than artControlRspTime2 milliseconds."
    ::= { artSummaryEntry 8 }

artSummaryRsps3 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The third of seven counters used to categorize the response
        times observed during the report interval.  This object
        is a count of responses that required at least artControlRspTime2
        milliseconds but less than artControlRspTime3 milliseconds."
    ::= { artSummaryEntry 9 }

artSummaryRsps4 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The fourth of seven counters used to categorize the response
        times observed during the report interval.  This object
        is a count of responses that required at least artControlRspTime3
        milliseconds but less than artControlRspTime4 milliseconds."
    ::= { artSummaryEntry 10 }

artSummaryRsps5 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The fifth of seven counters used to categorize the response
        times observed during the report interval.  This object
        is a count of responses that required at least artControlRspTime4
        milliseconds but less than artControlRspTime5 milliseconds."

    ::= { artSummaryEntry 11 }

artSummaryRsps6 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The sixth of seven counters used to categorize the response
        times observed during the report interval.  This object
        is a count of responses that required at least artControlRspTime5
        milliseconds but less than artControlRspTime6 milliseconds."
    ::= { artSummaryEntry 12 }

artSummaryRsps7 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The seventh of seven counters used to categorize the response
        times observed during the report interval.  This object
        is a count of responses that required at least artControlRspTime6"
    ::= { artSummaryEntry 13 }

artSummaryClientOctets OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The total number of octets observed in client requests
        during the report interval.  If the application-layer PDU has
        been fragmented into multiple packets, all octets in each of
        the packets are included in this count."
    ::= { artSummaryEntry 14 }

artSummaryClientOverflowOctets OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of times the associated artClientOctets counter
        has overflowed."
    ::= { artSummaryEntry 15 }

artSummaryClientHCOctets OBJECT-TYPE
    SYNTAX      Counter64
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The high-capacity version of artSummaryClientOctets."
    ::= { artSummaryEntry 16 }

artSummaryServerOctets OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The total number of octets in server responses
        during the report interval.  If the application-layer PDU
        has been fragmented into multiple packets, all octets in each
        of the packets are included in this count."
    ::= { artSummaryEntry 17 }

artSummaryServerOverflowOctets OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of times the associated artSummaryServerOctets counter
        has overflowed."
    ::= { artSummaryEntry 18 }

artSummaryServerHCOctets OBJECT-TYPE
    SYNTAX      Counter64
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The high-capacity version of artSummaryServerOctets."
    ::= { artSummaryEntry 19 }

artSummaryRetries OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "This total number of application-layer client retries
        observed during the report interval."
    ::= { artSummaryEntry 20 }

artSummaryTimeouts OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of times the probe has timed-out a client
        request while waiting for a server response during the
        report interval.  Timeouts may occur due to server
        congestion or failure, network congestion or failure,
        or probe congestion."
    ::= { artSummaryEntry 21 }


--
-- ART Groups and conformance.
--

artConformance OBJECT IDENTIFIER ::= { art 4 }

artMIBCompliances OBJECT IDENTIFIER ::= { artConformance 1 }
artMIBGroups      OBJECT IDENTIFIER ::= { artConformance 2 }

artMIBCompliance MODULE-COMPLIANCE
    STATUS  current
    DESCRIPTION
        "Describes the requirements for conformance to
        the ART MIB."
    MODULE  -- this module
        MANDATORY-GROUPS { artGroup }
    ::= { artMIBCompliances 1 }

artGroup OBJECT-GROUP
    OBJECTS {
        protocolDir2ArtConfig,
        artControlDataSource,
        artControlTimeRemaining,
        artControlDuration,
        artControlRspTime1,
        artControlRspTime2,
        artControlRspTime3,
        artControlRspTime4,
        artControlRspTime5,
        artControlRspTime6,
        artControlRspTimeout,
        artControlRptStartTime,
        artControlRequestedSize,
        artControlGrantedSize,
        artControlGeneratedRpts,
        artControlDroppedFrames,
        artControlOwner,
        artControlStatus,
        artAvgRspTime,
        artMinRspTime,
        artMaxRspTime,
        artTotalResponses,
        artRsps1,
        artRsps2,
        artRsps3,
        artRsps4,
        artRsps5,
        artRsps6,
        artRsps7,
        artClientOctets,
        artClientOverflowOctets,
        artClientHCOctets,
        artServerOctets,
        artServerOverflowOctets,
        artServerHCOctets,
        artRetries,
        artTimeouts,
        artSummaryClients,
        artSummaryAvgRspTime,
        artSummaryMinRspTime,
        artSummaryMaxRspTime,
        artSummaryTotalResponses,
        artSummaryRsps1,
        artSummaryRsps2,
        artSummaryRsps3,
        artSummaryRsps4,
        artSummaryRsps5,
        artSummaryRsps6,
        artSummaryRsps7,
        artSummaryClientOctets,
        artSummaryClientOverflowOctets,
        artSummaryClientHCOctets,
        artSummaryServerOctets,
        artSummaryServerOverflowOctets,
        artSummaryServerHCOctets,
        artSummaryRetries,
        artSummaryTimeouts
    }
    STATUS  current
    DESCRIPTION
        "This group adds application response time measurement to RMON2."
    ::= { artMIBGroups 1 }

END

Applications Response Time MIB (ART MIB)        June 1998

Company Confidential    Page 2  Printed on June 30, 1998
Filename: draft-ietf-rmon2-artmib-00    (c)1998 NetScout Systems, Inc.