Blame mibs/ietf/APM-MIB

Packit 022b05
APM-MIB DEFINITIONS ::= BEGIN
Packit 022b05
IMPORTS
Packit 022b05
    MODULE-IDENTITY, OBJECT-TYPE,
Packit 022b05
    NOTIFICATION-TYPE,
Packit 022b05
    Counter32, Unsigned32                        FROM SNMPv2-SMI
Packit 022b05
    TEXTUAL-CONVENTION, RowStatus, TimeStamp,
Packit 022b05
    TimeInterval, TruthValue, DateAndTime,
Packit 022b05
    StorageType                                  FROM SNMPv2-TC
Packit 022b05
    MODULE-COMPLIANCE, OBJECT-GROUP,
Packit 022b05
    NOTIFICATION-GROUP                           FROM SNMPv2-CONF
Packit 022b05
    SnmpAdminString                              FROM SNMP-FRAMEWORK-MIB
Packit 022b05
    rmon, OwnerString                            FROM RMON-MIB
Packit 022b05
    protocolDirLocalIndex                        FROM RMON2-MIB;
Packit 022b05
Packit 022b05
--  Application Performance Measurement MIB
Packit 022b05
Packit 022b05
apm MODULE-IDENTITY
Packit 022b05
    LAST-UPDATED "200402190000Z"  -- February 19, 2004
Packit 022b05
    ORGANIZATION "IETF RMON MIB Working Group"
Packit 022b05
    CONTACT-INFO
Packit 022b05
        "Author:
Packit 022b05
                     Steve Waldbusser
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
             Phone:  +1-650-948-6500
Packit 022b05
             Fax :   +1-650-745-0671
Packit 022b05
             Email:  waldbusser@nextbeacon.com
Packit 022b05
Packit 022b05
         Working Group Chair:
Packit 022b05
                     Andy Bierman
Packit 022b05
                     Cisco Systems, Inc.
Packit 022b05
             Postal: 170 West Tasman Drive
Packit 022b05
                     San Jose, CA USA 95134
Packit 022b05
                Tel: +1 408 527-3711
Packit 022b05
             E-mail: abierman@cisco.com
Packit 022b05
Packit 022b05
         Working Group Mailing List: <rmonmib@ietf.org>
Packit 022b05
         To subscribe send email to: <rmonmib-request@ietf.org>
Packit 022b05
        "
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The MIB module for measuring application performance
Packit 022b05
        as experienced by end-users.
Packit 022b05
Packit 022b05
        Copyright (C) The Internet Society (2004). This version of
Packit 022b05
        this MIB module is part of RFC 3729; see the RFC itself for
Packit 022b05
        full legal notices."
Packit 022b05
Packit 022b05
    REVISION "200402190000Z"    -- February 19, 2004
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The original version of this MIB Module, published as
Packit 022b05
        RFC3729."
Packit 022b05
Packit 022b05
    ::= { rmon 23 }
Packit 022b05
Packit 022b05
apmMibObjects OBJECT IDENTIFIER ::= { apm 1 }
Packit 022b05
apmConformance OBJECT IDENTIFIER ::= { apm 2 }
Packit 022b05
apmCompliances    OBJECT IDENTIFIER ::= { apmConformance 1 }
Packit 022b05
apmGroups         OBJECT IDENTIFIER ::= { apmConformance 2 }
Packit 022b05
Packit 022b05
Packit 022b05
AppLocalIndex ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS       current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A locally arbitrary unique identifier associated with an
Packit 022b05
        application or application verb.
Packit 022b05
Packit 022b05
        All objects of type AppLocalIndex are assigned by the agent
Packit 022b05
        out of a common number space. In other words, AppLocalIndex
Packit 022b05
        values assigned to entries in one table must not overlap with
Packit 022b05
        AppLocalIndex values assigned to entries in another
Packit 022b05
        table. Further, every protocolDirLocalIndex value registered
Packit 022b05
        by the agent automatically assigns the same value out of the
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        AppLocalIndex number space.
Packit 022b05
Packit 022b05
        For example, if the protocolDirLocalIndex values { 1, 3, 5, 7 }
Packit 022b05
        have been assigned, and the apmHttpFilterAppLocalIndex values
Packit 022b05
        { 6, 8, 9 } have been assigned:
Packit 022b05
Packit 022b05
            - Assignment of new AppLocalIndex values must not use the
Packit 022b05
              values { 1, 3, 5, 6, 7, 8, 9 }.
Packit 022b05
            - AppLocalIndex values { 1, 3, 5, 7 } are automatically
Packit 022b05
              assigned and are associated with the identical value of
Packit 022b05
              protocolDirLocalIndex. In particular, an entry in the
Packit 022b05
              apmAppDirTable indexed by a value provides further
Packit 022b05
              information about a protocol indexed by the same value
Packit 022b05
              in the protocolDirTable of RMON2.
Packit 022b05
Packit 022b05
        The value for each supported application must remain constant
Packit 022b05
        at least from one re-initialization of the entity's network
Packit 022b05
        management system to the next re-initialization, except that
Packit 022b05
        if an application is deleted and re-created, it must be
Packit 022b05
        re-created with a new value that has not been used since the
Packit 022b05
        last re-initialization.
Packit 022b05
Packit 022b05
        The specific value is meaningful only within a given SNMP
Packit 022b05
        entity. An AppLocalIndex value must not be re-used until the
Packit 022b05
        next agent restart."
Packit 022b05
    SYNTAX       Unsigned32 (1..2147483647)
Packit 022b05
Packit 022b05
ProtocolDirNetworkAddress ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS       current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A network level address whose semantics and encoding are
Packit 022b05
        specified by an associated protocolDirLocalIndex
Packit 022b05
        value. Objects of this type must specify which
Packit 022b05
        protocolDirLocalIndex value is used. This value is encoded
Packit 022b05
        according to the encoding rules for the identified
Packit 022b05
        protocolDirectory entry.
Packit 022b05
Packit 022b05
        For example, if the associated protocolDirLocalIndex indicates
Packit 022b05
        an encapsulation of ip, this object is encoded as a length
Packit 022b05
        octet of 4, followed by the 4 octets of the ip address,
Packit 022b05
        in network byte order.
Packit 022b05
Packit 022b05
        Objects of this type may allow this value to be the zero
Packit 022b05
        length string. If so, they must identify they meaning of this
Packit 022b05
        value."
Packit 022b05
    SYNTAX        OCTET STRING (SIZE(0..255))
Packit 022b05
Packit 022b05
DataSourceOrZero ::= TEXTUAL-CONVENTION
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    STATUS       current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Identifies the source of the data that the associated
Packit 022b05
        function is configured to analyze. This source can be any
Packit 022b05
        interface on this device.
Packit 022b05
Packit 022b05
        In order to identify a particular interface, this
Packit 022b05
        object shall identify the instance of the ifIndex
Packit 022b05
        object, defined in [4], for the desired interface.
Packit 022b05
Packit 022b05
        For example, if an entry were to receive data from
Packit 022b05
        interface #1, this object would be set to ifIndex.1.
Packit 022b05
Packit 022b05
        If the source of the data isn't an interface or cannot be
Packit 022b05
        localized to an interface, this object would be set to 0.0"
Packit 022b05
Packit 022b05
    REFERENCE    "The DataSource textual convention is defined in
Packit 022b05
                 RFC 2021 [5]."
Packit 022b05
    SYNTAX       OBJECT IDENTIFIER
Packit 022b05
Packit 022b05
RmonClientID ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
         "A long-lived unique ID assigned to an end-system. This ID is
Packit 022b05
         assigned by the agent using an implementation-specific
Packit 022b05
         algorithm.
Packit 022b05
Packit 022b05
         Because a client machine may be assigned multiple addresses
Packit 022b05
         over any time period it can be difficult to attribute
Packit 022b05
         behavior to a particular client based solely on its
Packit 022b05
         address. A ClientID may be assigned to provide a more
Packit 022b05
         stable handle for referencing that client. The entity that
Packit 022b05
         assigns the ClientID may use various implementation
Packit 022b05
         techniques to keep track of a client but if the assigning
Packit 022b05
         entity is unable to track client address mappings, it may map
Packit 022b05
         client identifiers to client addresses rather than to
Packit 022b05
         distinct client machines.
Packit 022b05
Packit 022b05
         This is named ClientID because it helps to solve a problem
Packit 022b05
         seen in network clients (servers usually have well-known,
Packit 022b05
         long-lived addresses). However, ClientID's may be assigned to
Packit 022b05
         any end-system regardless of its role on the network."
Packit 022b05
    SYNTAX      Unsigned32 (0..4294967295)
Packit 022b05
Packit 022b05
Packit 022b05
TransactionAggregationType ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        "Specifies one of 4 different techniques for aggregating
Packit 022b05
        transactions.
Packit 022b05
Packit 022b05
        The metrics for a single transaction are the responsiveness of
Packit 022b05
        the transaction and whether the transaction succeeded (a
Packit 022b05
        boolean). When such metrics are aggregated in this MIB Module,
Packit 022b05
        these metrics are replaced by averages and distributions of
Packit 022b05
        responsiveness and availability. The metrics describing
Packit 022b05
        aggregates are constant no matter which type of aggregation is
Packit 022b05
        being performed. These metrics may be found in the
Packit 022b05
        apmReportTable.
Packit 022b05
Packit 022b05
        The flows(1) aggregation is the simplest. All transactions
Packit 022b05
        that share common application/server/client 3-tuples are
Packit 022b05
        aggregated together, resulting in a set of metrics for all
Packit 022b05
        such unique 3-tuples.
Packit 022b05
Packit 022b05
        The clients(2) aggregation results in somewhat more
Packit 022b05
        aggregation (i.e., fewer resulting records). All transactions
Packit 022b05
        that share common application/client tuples are aggregated
Packit 022b05
        together, resulting in a set of metrics for all such unique
Packit 022b05
        tuples.
Packit 022b05
Packit 022b05
        The servers(3) aggregation usually results in still more
Packit 022b05
        aggregation (i.e., fewer resulting records). All transactions
Packit 022b05
        that share common application/server tuples are aggregated
Packit 022b05
        together, resulting in a set of metrics for all such unique
Packit 022b05
        tuples.
Packit 022b05
Packit 022b05
        The applications(4) aggregation results in the most
Packit 022b05
        aggregation (i.e., the fewest resulting records). All
Packit 022b05
        transactions that share a common application are aggregated
Packit 022b05
        together, resulting in a set of metrics for all such unique
Packit 022b05
        applications.
Packit 022b05
Packit 022b05
        Note that it is not meaningful to aggregate applications, as
Packit 022b05
        different applications have widely varying characteristics. As a
Packit 022b05
        result, this set of aggregations is complete."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
                  flows(1),    -- Least Aggregation
Packit 022b05
                  clients(2),
Packit 022b05
                  servers(3),
Packit 022b05
                  applications(4) -- Most Aggregation
Packit 022b05
                }
Packit 022b05
Packit 022b05
-- The APM Application Directory Group
Packit 022b05
Packit 022b05
-- The Application Directory Table contains a record for every
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
-- application monitored by this agent. This table is also used to
Packit 022b05
-- configure whether or not an application will be measured and which
Packit 022b05
-- bucket boundaries will be used for the application.
Packit 022b05
--
Packit 022b05
-- The bucket boundaries define the break-points between bins of a
Packit 022b05
-- histogram analysis for that application. As an example of how this
Packit 022b05
-- works, consider an entry representing response-time for http.
Packit 022b05
-- If the boundaries are set as follows:
Packit 022b05
-- Boundary1: 500 milliseconds
Packit 022b05
-- Boundary2: 1 second
Packit 022b05
-- Boundary3: 2 seconds
Packit 022b05
-- Boundary4: 5
Packit 022b05
-- Boundary5: 15
Packit 022b05
-- Boundary6: 60
Packit 022b05
--
Packit 022b05
-- If the following measurements are made (all in milliseconds):
Packit 022b05
-- 377, 8645, 1300, 487, 1405, 775, 1115, 850, 945, 1054, 7745, 9380
Packit 022b05
--
Packit 022b05
-- A report run during this interval would report the following
Packit 022b05
-- counts:
Packit 022b05
-- Bucket1: 2
Packit 022b05
-- Bucket2: 3
Packit 022b05
-- Bucket3: 4
Packit 022b05
-- Bucket4: 0
Packit 022b05
-- Bucket5: 3
Packit 022b05
-- Bucket6: 0
Packit 022b05
-- Bucket7: 0
Packit 022b05
Packit 022b05
apmAppDirTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF ApmAppDirEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The APM MIB directory of applications and application
Packit 022b05
        verbs. The agent will populate this table with all
Packit 022b05
        applications/verbs of any responsivenessType it has the
Packit 022b05
        capability to monitor. Since the agent populates this table
Packit 022b05
        with every entry it has the capability to monitor, the
Packit 022b05
        entries in this table are read-write, allowing the management
Packit 022b05
        station to modify parameters in this table but not to add new
Packit 022b05
        entries or delete entries (however, entries may be
Packit 022b05
        disabled). If new entries are added to the apmHttpFilterTable
Packit 022b05
        or the apmUserDefinedAppTable, the agent will add the
Packit 022b05
        corresponding entries to this table.
Packit 022b05
Packit 022b05
        It is an implementation-dependent matter as to how the agent
Packit 022b05
        sets these default parameters. For example, it may leave
Packit 022b05
        certain entries in this table 'off(0)' if the agent developer
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        believes that combination will be infrequently used, allowing
Packit 022b05
        a manager that needs that capability to set it to 'on(1)'.
Packit 022b05
Packit 022b05
        Some applications are registered in the RMON2 protocol
Packit 022b05
        directory and some are registered in other tables in this
Packit 022b05
        MIB Module. Regardless of where an application is originally
Packit 022b05
        registered, it is assigned an AppLocalIndex value that is the
Packit 022b05
        primary index for this table.
Packit 022b05
Packit 022b05
        The contents of this table affect all reports and exceptions
Packit 022b05
        generated by this agent. Accordingly, modification of this
Packit 022b05
        table should be performed by a manager acting in the role of
Packit 022b05
        administrator. In particular, management software should not
Packit 022b05
        require or enforce particular configuration of this table - it
Packit 022b05
        should reflect the preferences of the site administrator, not
Packit 022b05
        the software author. As a practical matter, this requires
Packit 022b05
        management software to allow the administrator to configure
Packit 022b05
        the values it will use so that it can be adapted to the site
Packit 022b05
        policy."
Packit 022b05
    ::= { apmMibObjects 1 }
Packit 022b05
Packit 022b05
apmAppDirEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      ApmAppDirEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The APM MIB directory of applications and application
Packit 022b05
        verbs. An entry will exist in this table for all applications
Packit 022b05
        for which application performance measurement is supported."
Packit 022b05
    INDEX { apmAppDirAppLocalIndex,
Packit 022b05
            apmAppDirResponsivenessType }
Packit 022b05
    ::= { apmAppDirTable 1 }
Packit 022b05
Packit 022b05
ApmAppDirEntry ::= SEQUENCE {
Packit 022b05
    apmAppDirAppLocalIndex            AppLocalIndex,
Packit 022b05
    apmAppDirResponsivenessType       INTEGER,
Packit 022b05
    apmAppDirConfig                   INTEGER,
Packit 022b05
    apmAppDirResponsivenessBoundary1  Unsigned32,
Packit 022b05
    apmAppDirResponsivenessBoundary2  Unsigned32,
Packit 022b05
    apmAppDirResponsivenessBoundary3  Unsigned32,
Packit 022b05
    apmAppDirResponsivenessBoundary4  Unsigned32,
Packit 022b05
    apmAppDirResponsivenessBoundary5  Unsigned32,
Packit 022b05
    apmAppDirResponsivenessBoundary6  Unsigned32
Packit 022b05
}
Packit 022b05
Packit 022b05
apmAppDirAppLocalIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      AppLocalIndex
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The AppLocalIndex assigned for this application Directory
Packit 022b05
        entry."
Packit 022b05
    ::= { apmAppDirEntry 1 }
Packit 022b05
Packit 022b05
apmAppDirResponsivenessType OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
                  transactionOriented(1),
Packit 022b05
                  throughputOriented(2),
Packit 022b05
                  streamingOriented(3)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object describes and configures the agent's support for
Packit 022b05
        application performance measurement for this application.
Packit 022b05
        There are 3 types of measurements for different types of
Packit 022b05
        applications:
Packit 022b05
Packit 022b05
        Transaction-Oriented applications have a fairly constant
Packit 022b05
        workload to perform for all transactions. The responsiveness
Packit 022b05
        metric for transaction-oriented applications is application
Packit 022b05
        response time (from first request to final delivery of
Packit 022b05
        service) and is measured in milliseconds. This is
Packit 022b05
        commonly referred to as end-user response time.
Packit 022b05
Packit 022b05
        Throughput-Oriented applications have widely varying workloads
Packit 022b05
        based on the nature of the client request. In particular,
Packit 022b05
        throughput-oriented applications vary widely in the amount of
Packit 022b05
        data that must be transported to satisfy the request. The
Packit 022b05
        responsiveness metric for throughput-oriented applications is
Packit 022b05
        kilobits per second.
Packit 022b05
Packit 022b05
        Streaming-Oriented applications deliver data at a constant
Packit 022b05
        metered rate of speed regardless of the responsiveness of the
Packit 022b05
        networking and computing infrastructure. This constant rate of
Packit 022b05
        speed is generally specified to be below (sometimes well
Packit 022b05
        below) the nominal capability of the infrastructure. However,
Packit 022b05
        when the infrastructures cannot deliver data at this speed,
Packit 022b05
        interruption of service or degradation of service can
Packit 022b05
        result. The responsiveness metric for streaming-oriented
Packit 022b05
        applications is the ratio of time that the service is degraded
Packit 022b05
        or interrupted to the total service time. This metric is
Packit 022b05
        measured in parts per million.
Packit 022b05
Packit 022b05
        Note that for some applications, measuring more than one
Packit 022b05
        responsiveness type may be interesting. For agents that wish
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        to support more than one measurement for a application, they
Packit 022b05
        will populate this table with multiple entries for that
Packit 022b05
        application, one for each type."
Packit 022b05
    ::= { apmAppDirEntry 2 }
Packit 022b05
Packit 022b05
apmAppDirConfig OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
                  off(1),
Packit 022b05
                  on(2)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object describes and configures support for application
Packit 022b05
        performance measurement for this application.
Packit 022b05
Packit 022b05
        If the value of this object is on(2), the agent supports
Packit 022b05
        measurement of application performance metrics for this
Packit 022b05
        application and is configured to measure such metrics for all
Packit 022b05
        APM MIB functions and all interfaces.  If the value of this
Packit 022b05
        object is off(1), the agent supports measurement of
Packit 022b05
        application performance for this application but is configured
Packit 022b05
        to not measure these metrics for any APM MIB functions or
Packit 022b05
        interfaces.  Whenever this value changes from on(2) to off(1),
Packit 022b05
        the agent shall delete all related entries in all tables in
Packit 022b05
        this MIB Module.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
    ::= { apmAppDirEntry 3 }
Packit 022b05
Packit 022b05
apmAppDirResponsivenessBoundary1 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The boundary value between bucket1 and bucket 2. If this
Packit 022b05
        value is modified, all entries in the apmReportTable must be
Packit 022b05
        deleted by the agent.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
    ::= { apmAppDirEntry 4 }
Packit 022b05
Packit 022b05
apmAppDirResponsivenessBoundary2 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The boundary value between bucket2 and bucket 3. If this
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        value is modified, all entries in the apmReportTable must be
Packit 022b05
        deleted by the agent.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
    ::= { apmAppDirEntry 5 }
Packit 022b05
Packit 022b05
apmAppDirResponsivenessBoundary3 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The boundary value between bucket3 and bucket 4. If this
Packit 022b05
        value is modified, all entries in the apmReportTable must be
Packit 022b05
        deleted by the agent.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
    ::= { apmAppDirEntry 6 }
Packit 022b05
Packit 022b05
apmAppDirResponsivenessBoundary4 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The boundary value between bucket4 and bucket 5. If this
Packit 022b05
        value is modified, all entries in the apmReportTable must be
Packit 022b05
        deleted by the agent.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
    ::= { apmAppDirEntry 7 }
Packit 022b05
Packit 022b05
apmAppDirResponsivenessBoundary5 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The boundary value between bucket5 and bucket 6. If this
Packit 022b05
        value is modified, all entries in the apmReportTable must be
Packit 022b05
        deleted by the agent.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
    ::= { apmAppDirEntry 8 }
Packit 022b05
Packit 022b05
apmAppDirResponsivenessBoundary6 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The boundary value between bucket6 and bucket 7. If this
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        value is modified, all entries in the apmReportTable must be
Packit 022b05
        deleted by the agent.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
    ::= { apmAppDirEntry 9 }
Packit 022b05
Packit 022b05
-- Scalars related to the Application Directory table
Packit 022b05
Packit 022b05
apmBucketBoundaryLastChange OBJECT-TYPE
Packit 022b05
    SYNTAX     TimeStamp
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime the last time that any bucket boundary
Packit 022b05
        in any appDirEntry was changed. This object can help to
Packit 022b05
        determine if two managers are both trying to enforce different
Packit 022b05
        configurations of this table."
Packit 022b05
    ::= { apmMibObjects 2 }
Packit 022b05
Packit 022b05
apmAppDirID OBJECT-TYPE
Packit 022b05
    SYNTAX     OBJECT IDENTIFIER
Packit 022b05
    MAX-ACCESS read-write
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object allows managers to avoid downloading application
Packit 022b05
        directory information when the directory is set to a known
Packit 022b05
        (usually fixed) configuration.
Packit 022b05
Packit 022b05
        If the value of this object isn't 0.0, it signifies
Packit 022b05
        that the entire contents of the apmAppDirTable,
Packit 022b05
        apmHttpFilterTable, apmUserDefinedAppTable and
Packit 022b05
        protocolDirTable are equal to a known state identified
Packit 022b05
        by the value of this object. If a manager recognizes this
Packit 022b05
        value as identifying a directory configuration it has a local
Packit 022b05
        copy of, it may use this local copy rather than downloading
Packit 022b05
        these tables. Note that it may have downloaded this local copy
Packit 022b05
        (and the ID) from another agent and used this copy for all
Packit 022b05
        other agents that advertised the same ID.
Packit 022b05
Packit 022b05
        If an agent recognizes that the entire contents of the
Packit 022b05
        apmAppDirTable, apmHttpFilterTable,
Packit 022b05
        apmUserDefinedAppTable and protocolDirTable are equal to
Packit 022b05
        a known state to which an ID has been assigned, it should set
Packit 022b05
        this object to that ID.
Packit 022b05
Packit 022b05
        In many cases when this feature is used, the application
Packit 022b05
        directory information will be in read-only memory and thus the
Packit 022b05
        tables may not be modified via SNMP requests. In the event
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        that the tables are writable and a modification is made, the
Packit 022b05
        agent is responsible for setting this object to 0.0 if it
Packit 022b05
        cannot determine that the state is equal to a known state.
Packit 022b05
Packit 022b05
        An agent is not obligated to recognize and advertise all such
Packit 022b05
        registered states as it may not have knowledge of all states.
Packit 022b05
        Thus, a manager may encounter agents whose DirectoryID value
Packit 022b05
        is 0.0 even though the contents of the directory were equal to
Packit 022b05
        a registered state.
Packit 022b05
Packit 022b05
        Note that the contents of those tables includes the
Packit 022b05
        protocolDirLocalIndex and appLocalIndex values. In other
Packit 022b05
        words, these values can't be assigned randomly on each agent,
Packit 022b05
        but must be equal to values that are part of the known
Packit 022b05
        state. While it is possible for a manager to download
Packit 022b05
        application directory details using SNMP and to set the
Packit 022b05
        appropriate directoryID, the manager would need to have some
Packit 022b05
        scheme to ensure consistent values of LocalIndex variables
Packit 022b05
        from agent to agent. Such schemes are outside the scope of
Packit 022b05
        this specification.
Packit 022b05
Packit 022b05
        Application directory registrations are unique within an
Packit 022b05
        administrative domain.
Packit 022b05
Packit 022b05
        Typically these registrations will be made by an agent
Packit 022b05
        software developer who will set the application directory
Packit 022b05
        tables to a read-only state and assign a DirectoryID to that
Packit 022b05
        state. Thus, all agents running this software would share the
Packit 022b05
        same DirectoryID. As the application directory might change
Packit 022b05
        from one software release to the next, the developer may
Packit 022b05
        register different DirectoryID's for each software release.
Packit 022b05
Packit 022b05
        A customer could also create a site-wide application directory
Packit 022b05
        configuration and assign a DirectoryID to that configuration
Packit 022b05
        as long as consistent values of LocalIndex variables can be
Packit 022b05
        ensured.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
     ::= { apmMibObjects 3 }
Packit 022b05
Packit 022b05
-- APM HTTP Filter Table
Packit 022b05
Packit 022b05
-- The HTTP Filter Table creates virtual applications which measure the
Packit 022b05
-- performance of certain web pages  or sets of web pages. Some
Packit 022b05
-- circumstances where this is particularly useful are:
Packit 022b05
--
Packit 022b05
--      - An Intranet or ASP scenario where a business application is
Packit 022b05
--        running on one or more web pages or scripts.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
--        (i.e., /expense/submit.cgi?employeeID=3426&...)
Packit 022b05
--      - A web-hosting scenario where one wants to measure the
Packit 022b05
--        service level for a particular customer
Packit 022b05
--      - An e-commerce scenario where the performance of certain
Packit 022b05
--        pages needs to be monitored more closely.
Packit 022b05
--        (i.e., shopping cart, shipping, credit card authorization)
Packit 022b05
Packit 022b05
apmHttpFilterTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF ApmHttpFilterEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A table that creates virtual applications which measure the
Packit 022b05
        performance of certain web pages or sets of web pages.
Packit 022b05
Packit 022b05
        When an entry is added to this table, the agent will
Packit 022b05
        automatically create one or more entries in the
Packit 022b05
        apmAppDirTable (one for each responsivenessType it is
Packit 022b05
        capable of measuring).
Packit 022b05
Packit 022b05
        Note that when entries exist in this table some HTTP
Packit 022b05
        transactions will be summarized twice: in applications
Packit 022b05
        represented here as well as the HTTP application. If entries
Packit 022b05
        in this table overlap, these transactions may be summarized
Packit 022b05
        additional times.
Packit 022b05
Packit 022b05
        The contents of this table affect all reports and exceptions
Packit 022b05
        generated by this agent. Accordingly, modification of this
Packit 022b05
        table should be performed by a manager acting in the role of
Packit 022b05
        administrator. In particular, management software should not
Packit 022b05
        require or enforce particular configuration of this table - it
Packit 022b05
        should reflect the preferences of the site administrator, not
Packit 022b05
        the software author."
Packit 022b05
    ::= { apmMibObjects 4 }
Packit 022b05
Packit 022b05
apmHttpFilterEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      ApmHttpFilterEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A virtual application which measure the performance of certain
Packit 022b05
        web pages or sets of web pages."
Packit 022b05
    INDEX { apmHttpFilterIndex }
Packit 022b05
    ::= { apmHttpFilterTable 1 }
Packit 022b05
Packit 022b05
ApmHttpFilterEntry ::= SEQUENCE {
Packit 022b05
    apmHttpFilterIndex              Unsigned32,
Packit 022b05
    apmHttpFilterAppLocalIndex      AppLocalIndex,
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    apmHttpFilterServerProtocol     Unsigned32,
Packit 022b05
    apmHttpFilterServerAddress      ProtocolDirNetworkAddress,
Packit 022b05
    apmHttpFilterURLPath            OCTET STRING,
Packit 022b05
    apmHttpFilterMatchType          INTEGER,
Packit 022b05
    apmHttpFilterOwner              OwnerString,
Packit 022b05
    apmHttpFilterStorageType        StorageType,
Packit 022b05
    apmHttpFilterRowStatus          RowStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
apmHttpFilterIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (0..65535)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry in the
Packit 022b05
        apmHttpFilterTable."
Packit 022b05
    ::= { apmHttpFilterEntry 1 }
Packit 022b05
Packit 022b05
apmHttpFilterAppLocalIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      AppLocalIndex
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The AppLocalIndex that represents HTTP transactions
Packit 022b05
        that match this entry.
Packit 022b05
Packit 022b05
        This object is read-only. A value is created by the agent from
Packit 022b05
        an unused AppLocalIndex value when this apmHttpFilterEntry is
Packit 022b05
        created."
Packit 022b05
    ::= { apmHttpFilterEntry 2 }
Packit 022b05
Packit 022b05
apmHttpFilterServerProtocol OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (1..2147483647)
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The protocolDirLocalIndex value of the network level protocol
Packit 022b05
        of the apmHttpFilterServerAddress."
Packit 022b05
    ::= { apmHttpFilterEntry 3 }
Packit 022b05
Packit 022b05
apmHttpFilterServerAddress OBJECT-TYPE
Packit 022b05
    SYNTAX      ProtocolDirNetworkAddress
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This entry will only represent transactions coming from the
Packit 022b05
        network address specified in this object.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        This is represented as an octet string with
Packit 022b05
        specific semantics and length as identified
Packit 022b05
        by the associated apmHttpFilterServerProtocol object.
Packit 022b05
Packit 022b05
        If this object is the zero-length string, then this entry will
Packit 022b05
        match one of the addresses represented by the 'host' component
Packit 022b05
        of the associated apmHttpFilterURLPath object, where the
Packit 022b05
        format if a URL [9] is
Packit 022b05
        http://<host>:<port>/<path>?<searchpart>."
Packit 022b05
    ::= { apmHttpFilterEntry 4 }
Packit 022b05
Packit 022b05
apmHttpFilterURLPath OBJECT-TYPE
Packit 022b05
    SYNTAX      OCTET STRING (SIZE(0..65535))
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This entry will only represent HTTP transactions
Packit 022b05
        where the URL path component in the request matches this
Packit 022b05
        value. This value represents the requested path regardless of
Packit 022b05
        any substitution that the server might perform.
Packit 022b05
Packit 022b05
        Prior to the matching, the URL is stripped of any server
Packit 022b05
        address or DNS name and consists solely of the path name on
Packit 022b05
        that server.
Packit 022b05
Packit 022b05
        If the length of this object is zero, then this entry will
Packit 022b05
        match if the associated apmHttpFilterServerAddress match. If
Packit 022b05
        the length of that object is also zero, then this entry will
Packit 022b05
        match nothing.
Packit 022b05
Packit 022b05
        The value of the associated apmHttpFilterMatchType dictates
Packit 022b05
        the type of matching that will be attempted."
Packit 022b05
    ::= { apmHttpFilterEntry 5 }
Packit 022b05
Packit 022b05
apmHttpFilterMatchType OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
                    exact(1),
Packit 022b05
                    stripTrailingSlash(2),
Packit 022b05
                    prefix(3)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The matching algorithm used to compare the URL pathname.
Packit 022b05
Packit 022b05
        If the value is exact(1), then the pathname component will be
Packit 022b05
        compared with the associated apmHttpFilterURLPath and
Packit 022b05
        will only be associated with this entry if it matches exactly.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        If the value is stripTrailingSlash(2), then the pathname
Packit 022b05
        component will be compared with the associated
Packit 022b05
        apmHttpFilterURLPath and will only be associated with this
Packit 022b05
        entry if it matches exactly or if the pathname ends with a '/'
Packit 022b05
        symbol and matches apmHttpFilterURLPath if the '/' symbol is
Packit 022b05
        removed from the pathname. This option exists for those paths
Packit 022b05
        where an optional trailing slash is possible but for which a
Packit 022b05
        prefix match would be too broad.
Packit 022b05
Packit 022b05
        If the value is prefix(3), then the pathname component will be
Packit 022b05
        compared with the associated apmHttpFilterURLPath and will
Packit 022b05
        only be associated with this entry if the beginning of the
Packit 022b05
        pathname matches every octet of this value. Octets that extend
Packit 022b05
        beyond the length of this value are ignored."
Packit 022b05
    ::= { apmHttpFilterEntry 6 }
Packit 022b05
Packit 022b05
apmHttpFilterOwner OBJECT-TYPE
Packit 022b05
    SYNTAX      OwnerString
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is
Packit 022b05
        therefore using the resources assigned to it."
Packit 022b05
    ::= { apmHttpFilterEntry 7 }
Packit 022b05
Packit 022b05
apmHttpFilterStorageType OBJECT-TYPE
Packit 022b05
    SYNTAX      StorageType
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The storage type of this apmHttpFilterEntry. If the value of
Packit 022b05
        this object is 'permanent', no objects in this row need to be
Packit 022b05
        writable."
Packit 022b05
    ::= { apmHttpFilterEntry 8 }
Packit 022b05
Packit 022b05
apmHttpFilterRowStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      RowStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this apmHttpFilterEntry. No objects in this row
Packit 022b05
        may be modified while the row's status is 'active'."
Packit 022b05
    ::= { apmHttpFilterEntry 9 }
Packit 022b05
Packit 022b05
apmHttpIgnoreUnregisteredURLs OBJECT-TYPE
Packit 022b05
    SYNTAX      TruthValue
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    DESCRIPTION
Packit 022b05
        "When true, APM measurements of HTTP transactions will only
Packit 022b05
        measure transactions relating to URLs that match a filter in
Packit 022b05
        the apmHttpFilterTable. Thus, measurements for the HTTP
Packit 022b05
        application will present aggregated statistics for
Packit 022b05
        URL-matching HTTP transactions and measurements for the HTTP
Packit 022b05
        GET application verb will present aggregated statistics for
Packit 022b05
        URL-matching HTTP GET transactions.
Packit 022b05
Packit 022b05
        This will be used in environments that wish to monitor only
Packit 022b05
        targeted URLs and to ignore large volumes of internet web
Packit 022b05
        browsing traffic.
Packit 022b05
Packit 022b05
        This object affects all APM reports and exceptions generated
Packit 022b05
        by this agent. Accordingly, modification of this object should
Packit 022b05
        be performed by a manager acting in the role of
Packit 022b05
        administrator. In particular, management software should not
Packit 022b05
        require or enforce particular configuration of this object -
Packit 022b05
        it should reflect the preferences of the site administrator,
Packit 022b05
        not the software author.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
    ::= { apmMibObjects 5 }
Packit 022b05
Packit 022b05
apmHttp4xxIsFailure OBJECT-TYPE
Packit 022b05
    SYNTAX      TruthValue
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "When true, this agent will recognize HTTP errors in the range
Packit 022b05
        of 400 through 499 and will treat them as unavailable
Packit 022b05
        transactions. When false or when this object isn't supported,
Packit 022b05
        they will be treated as successful transactions.
Packit 022b05
Packit 022b05
        This object allows such error pages to be tracked at the
Packit 022b05
        possible expense of having user typos treated as poor service
Packit 022b05
        on the part of the web server.
Packit 022b05
Packit 022b05
        This object affects all reports and exceptions generated by
Packit 022b05
        this agent. Accordingly, modification of this object should be
Packit 022b05
        performed by a manager acting in the role of administrator. In
Packit 022b05
        particular, management software should not require or enforce
Packit 022b05
        particular configuration of this object - it should reflect
Packit 022b05
        the preferences of the site administrator, not the software
Packit 022b05
        author.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
    ::= { apmMibObjects 6 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
-- The APM User-Defined Application Table
Packit 022b05
Packit 022b05
-- Many application protocols will never be registered with a
Packit 022b05
-- standards body (and thus included in a protocol directory standard)
Packit 022b05
-- because they are custom, in-house or proprietary
Packit 022b05
-- applications. Nevertheless, implementation strategies exist for
Packit 022b05
-- monitoring the end-user experience of these applications.
Packit 022b05
--
Packit 022b05
-- This read-only table provides a means for the agent to advertise
Packit 022b05
-- which user-defined applications it is monitoring and to associate
Packit 022b05
-- each with an AppLocalIndex value. It is an implementation-dependent
Packit 022b05
-- matter as to how the agent learns how to monitor these
Packit 022b05
-- applications.
Packit 022b05
Packit 022b05
apmUserDefinedAppTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF ApmUserDefinedAppEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A table that advertises user-defined applications that the
Packit 022b05
        agent is measuring.
Packit 022b05
Packit 022b05
        The agent will automatically create one or more entries in the
Packit 022b05
        apmAppDirTable (one for each responsivenessType it is
Packit 022b05
        capable of measuring) for each entry in this table.
Packit 022b05
Packit 022b05
        Note that when entries exist in this table some
Packit 022b05
        transactions can be summarized more than once if there is
Packit 022b05
        overlap between applications defined here and applications
Packit 022b05
        defined in the protocol directory or in the httpFilter table."
Packit 022b05
    ::= { apmMibObjects 7 }
Packit 022b05
Packit 022b05
apmUserDefinedAppEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      ApmUserDefinedAppEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A user-defined application that the agent is measuring, along
Packit 022b05
        with its AppLocalIndex assignment.
Packit 022b05
Packit 022b05
        The apmAppDirAppLocalIndex value in the index identifies
Packit 022b05
        the agent-assigned AppLocalIndex value for this user-defined
Packit 022b05
        application."
Packit 022b05
    INDEX { apmAppDirAppLocalIndex }
Packit 022b05
    ::= { apmUserDefinedAppTable 1 }
Packit 022b05
Packit 022b05
ApmUserDefinedAppEntry ::= SEQUENCE {
Packit 022b05
    apmUserDefinedAppParentIndex    Unsigned32,
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    apmUserDefinedAppApplication    SnmpAdminString
Packit 022b05
}
Packit 022b05
Packit 022b05
apmUserDefinedAppParentIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (1..2147483647)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The protocolDirLocalIndex value of the highest-layer
Packit 022b05
        protocol defined in the protocolDirTable that this
Packit 022b05
        application is a child of."
Packit 022b05
    ::= { apmUserDefinedAppEntry 1 }
Packit 022b05
Packit 022b05
apmUserDefinedAppApplication OBJECT-TYPE
Packit 022b05
    SYNTAX      SnmpAdminString
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A human readable descriptive tag for this application."
Packit 022b05
    ::= { apmUserDefinedAppEntry 2 }
Packit 022b05
Packit 022b05
-- The APM Name Table
Packit 022b05
Packit 022b05
apmNameTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF ApmNameEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A client machine may have multiple addresses during a period
Packit 022b05
        of monitoring. The apmNameTable assigns a long-lived
Packit 022b05
        identifier to a client and records what addresses were
Packit 022b05
        assigned to that client for periods of time. Various
Packit 022b05
        implementation techniques exist for tracking this mapping but
Packit 022b05
        if an agent is unable to track client address mappings, it may
Packit 022b05
        map client identifiers to client addresses rather than to
Packit 022b05
        distinct client machines.
Packit 022b05
Packit 022b05
        A particular apmNameClientID should be a constant attribute of
Packit 022b05
        a particular client. When available, the agent may also record
Packit 022b05
        the machine name and/or user name which may be valuable for
Packit 022b05
        displaying to humans. The apmNameMachineName and
Packit 022b05
        apmNameUserName are relatively constant, changing only if
Packit 022b05
        these attributes actually change on the client.
Packit 022b05
Packit 022b05
        The agent will store a historical log of these entries, aging
Packit 022b05
        out old entries as the log becomes too large. Since this table
Packit 022b05
        contains information vital to the interpretation of other
Packit 022b05
        tables (e.g., the apmReportTable), the agent should ensure that
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        the log doesn't age out entries that would be referenced by
Packit 022b05
        data in those tables.
Packit 022b05
Packit 022b05
        Note that an entry for a clientID is active from its
Packit 022b05
        StartTime until the StartTime of another entry (for the same
Packit 022b05
        clientID) that supersedes it, or 'now' if none supersede
Packit 022b05
        it. Therefore, if a clientID only has a single entry, it is by
Packit 022b05
        definition very new and should never be aged out. No entry for
Packit 022b05
        a clientID should be aged out unless it has been updated by a
Packit 022b05
        new entry for the client (i.e., with an updated address) and
Packit 022b05
        only if the new entry is 'old' enough.
Packit 022b05
Packit 022b05
        To determine how old is old enough, compute the maximum value
Packit 022b05
        of Interval * (NumReports + 1) of all entries in the
Packit 022b05
        apmReportControlTable (the '+ 1' is to allow a reasonable
Packit 022b05
        period of time for the report to be downloaded). Then take the
Packit 022b05
        larger of this value and the age in seconds of the oldest
Packit 022b05
        entry in the current transaction table. If an entry for a
Packit 022b05
        clientID is superseded by another entry whose StartTime is
Packit 022b05
        more than this many seconds ago, then the older entry may be
Packit 022b05
        deleted."
Packit 022b05
    ::= { apmMibObjects 8 }
Packit 022b05
Packit 022b05
apmNameEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      ApmNameEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An entry in the APM name table. An entry exists for each
Packit 022b05
        period of time that a client has been associated with a
Packit 022b05
        particular address.
Packit 022b05
Packit 022b05
        The protocolDirLocalIndex value in the index identifies
Packit 022b05
        the network layer protocol for the ClientAddress for this
Packit 022b05
        entry.
Packit 022b05
Packit 022b05
        Note that some combinations of index values may result in an
Packit 022b05
        index that exceeds 128 sub-identifiers in length which exceeds
Packit 022b05
        the maximum for the SNMP protocol. Implementations should take
Packit 022b05
        care to avoid such combinations."
Packit 022b05
    INDEX { apmNameClientID,
Packit 022b05
            protocolDirLocalIndex, apmNameClientAddress,
Packit 022b05
            apmNameMappingStartTime }
Packit 022b05
    ::= { apmNameTable 1 }
Packit 022b05
Packit 022b05
ApmNameEntry ::= SEQUENCE {
Packit 022b05
    apmNameClientID                  RmonClientID,
Packit 022b05
    apmNameClientAddress             ProtocolDirNetworkAddress,
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    apmNameMappingStartTime          DateAndTime,
Packit 022b05
    apmNameMachineName               SnmpAdminString,
Packit 022b05
    apmNameUserName                  SnmpAdminString
Packit 022b05
}
Packit 022b05
Packit 022b05
apmNameClientID OBJECT-TYPE
Packit 022b05
    SYNTAX      RmonClientID
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
         "A unique ID assigned to the machine represented by this
Packit 022b05
         mapping. This ID is assigned by the agent using an
Packit 022b05
         implementation-specific algorithm."
Packit 022b05
    ::= { apmNameEntry 1 }
Packit 022b05
Packit 022b05
apmNameClientAddress OBJECT-TYPE
Packit 022b05
    SYNTAX      ProtocolDirNetworkAddress (SIZE(1..255))
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The network client address for this client when this mapping
Packit 022b05
        was active.
Packit 022b05
Packit 022b05
        This is represented as an octet string with specific semantics
Packit 022b05
        and length as identified by the protocolDirLocalIndex
Packit 022b05
        component of the index. This object may not be the zero length
Packit 022b05
        string.
Packit 022b05
Packit 022b05
        Since this object is an index variable, it is encoded in the
Packit 022b05
        index according to the index encoding rules.  For example, if
Packit 022b05
        the protocolDirLocalIndex component of the index indicates an
Packit 022b05
        encapsulation of ip, this object is encoded as a length octet
Packit 022b05
        of 4, followed by the 4 octets of the ip address, in network
Packit 022b05
        byte order. Care should be taken to avoid values of this
Packit 022b05
        object that, in conjunction with the other index variables,
Packit 022b05
        would result in an index longer than SNMP's maximum of 128
Packit 022b05
        subidentifiers."
Packit 022b05
    ::= { apmNameEntry 2 }
Packit 022b05
Packit 022b05
apmNameMappingStartTime OBJECT-TYPE
Packit 022b05
    SYNTAX      DateAndTime
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The time that the agent first discovered this mapping
Packit 022b05
        as active."
Packit 022b05
    ::= { apmNameEntry 3 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
apmNameMachineName OBJECT-TYPE
Packit 022b05
    SYNTAX      SnmpAdminString
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The human readable name of the client machine.
Packit 022b05
Packit 022b05
        If the client has no machine name or the agent is
Packit 022b05
        unable to learn the machine name, this object will be
Packit 022b05
        a zero-length string."
Packit 022b05
    ::= { apmNameEntry 4 }
Packit 022b05
Packit 022b05
apmNameUserName OBJECT-TYPE
Packit 022b05
    SYNTAX      SnmpAdminString
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The human readable name of a human user using the client
Packit 022b05
        machine. If more than one user name are available
Packit 022b05
        simultaneously, it is an implementation-dependent matter as to
Packit 022b05
        which is used here. However, if the user name changes, this
Packit 022b05
        object should change to reflect that change.
Packit 022b05
Packit 022b05
        Non-human user names like 'root' or 'administrator' aren't
Packit 022b05
        intended as values for this object. If the client has no
Packit 022b05
        recorded user name or the agent is unable to learn a user
Packit 022b05
        name, this object will be a zero-length string."
Packit 022b05
    ::= { apmNameEntry 5 }
Packit 022b05
Packit 022b05
-- The APM Report Group
Packit 022b05
Packit 022b05
apmReportControlTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF ApmReportControlEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Parameters that control the creation of a set of reports that
Packit 022b05
        aggregate application performance."
Packit 022b05
    ::= { apmMibObjects 9 }
Packit 022b05
Packit 022b05
apmReportControlEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      ApmReportControlEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the apmReportControlTable.
Packit 022b05
Packit 022b05
        An example of the indexing of this table is
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        apmReportControlInterval.3"
Packit 022b05
    INDEX { apmReportControlIndex }
Packit 022b05
    ::= { apmReportControlTable 1 }
Packit 022b05
Packit 022b05
ApmReportControlEntry ::= SEQUENCE {
Packit 022b05
    apmReportControlIndex            Unsigned32,
Packit 022b05
    apmReportControlDataSource       DataSourceOrZero,
Packit 022b05
    apmReportControlAggregationType  TransactionAggregationType,
Packit 022b05
    apmReportControlInterval         Unsigned32,
Packit 022b05
    apmReportControlRequestedSize    Unsigned32,
Packit 022b05
    apmReportControlGrantedSize      Unsigned32,
Packit 022b05
    apmReportControlRequestedReports Unsigned32,
Packit 022b05
    apmReportControlGrantedReports   Unsigned32,
Packit 022b05
    apmReportControlStartTime        TimeStamp,
Packit 022b05
    apmReportControlReportNumber     Unsigned32,
Packit 022b05
    apmReportControlDeniedInserts    Counter32,
Packit 022b05
    apmReportControlDroppedFrames    Counter32,
Packit 022b05
    apmReportControlOwner            OwnerString,
Packit 022b05
    apmReportControlStorageType      StorageType,
Packit 022b05
    apmReportControlStatus           RowStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
Packit 022b05
apmReportControlIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (1..65535)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry in the
Packit 022b05
        apmReportControlTable.  Each such entry defines a unique
Packit 022b05
        report whose results are placed in the apmReportTable on
Packit 022b05
        behalf of this apmReportControlEntry."
Packit 022b05
    ::= { apmReportControlEntry 1 }
Packit 022b05
Packit 022b05
apmReportControlDataSource OBJECT-TYPE
Packit 022b05
    SYNTAX      DataSourceOrZero
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The source of the data for APM Reports generated on
Packit 022b05
        behalf of this apmReportControlEntry.
Packit 022b05
Packit 022b05
        If the measurement is being performed by a probe, this should
Packit 022b05
        be set to interface or port where data was received for
Packit 022b05
        analysis. If the measurement isn't being performed by a probe,
Packit 022b05
        this should be set to the primary interface over which the
Packit 022b05
        measurement is being performed. If the measurement isn't being
Packit 022b05
        performed by a probe and there is no primary interface or this
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        information isn't known, this object should be set to 0.0.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        apmReportControlStatus object is equal to active(1)."
Packit 022b05
    ::= { apmReportControlEntry 2 }
Packit 022b05
Packit 022b05
apmReportControlAggregationType OBJECT-TYPE
Packit 022b05
    SYNTAX      TransactionAggregationType
Packit 022b05
            --    INTEGER {
Packit 022b05
            --      flows(1),
Packit 022b05
            --      clients(2),
Packit 022b05
            --      servers(3),
Packit 022b05
            --      applications(4)
Packit 022b05
            --    }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The type of aggregation being performed for this set of
Packit 022b05
        reports.
Packit 022b05
Packit 022b05
        The metrics for a single transaction are the responsiveness of
Packit 022b05
        the transaction and whether the transaction succeeded (a
Packit 022b05
        boolean). When such metrics are aggregated in this MIB Module,
Packit 022b05
        these metrics are replaced by averages and distributions of
Packit 022b05
        responsiveness and availability. The metrics describing
Packit 022b05
        aggregates are constant no matter which type of aggregation is
Packit 022b05
        being performed. These metrics may be found in the
Packit 022b05
        apmReportTable.
Packit 022b05
Packit 022b05
        The flows(1) aggregation is the simplest. All transactions
Packit 022b05
        that share common application/server/client 3-tuples are
Packit 022b05
        aggregated together, resulting in a set of metrics for all
Packit 022b05
        such unique 3-tuples.
Packit 022b05
Packit 022b05
        The clients(2) aggregation results in somewhat more
Packit 022b05
        aggregation (i.e., fewer resulting records). All transactions
Packit 022b05
        that share common application/client tuples are aggregated
Packit 022b05
        together, resulting in a set of metrics for all such unique
Packit 022b05
        tuples.
Packit 022b05
Packit 022b05
        The servers(3) aggregation usually results in still more
Packit 022b05
        aggregation (i.e., fewer resulting records). All transactions
Packit 022b05
        that share common application/server tuples are aggregated
Packit 022b05
        together, resulting in a set of metrics for all such unique
Packit 022b05
        tuples.
Packit 022b05
Packit 022b05
        The applications(4) aggregation results in the most
Packit 022b05
        aggregation (i.e., the fewest resulting records). All
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        transactions that share a common application are aggregated
Packit 022b05
        together, resulting in a set of metrics for all such unique
Packit 022b05
        applications.
Packit 022b05
Packit 022b05
        Note that it is not meaningful to aggregate applications, as
Packit 022b05
        different applications have widely varying characteristics.
Packit 022b05
        As a result, this set of aggregations is complete.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        apmReportControlStatus object is equal to active(1)."
Packit 022b05
    ::= { apmReportControlEntry 3 }
Packit 022b05
Packit 022b05
apmReportControlInterval OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    UNITS       "Seconds"
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The interval in seconds over which data is accumulated before
Packit 022b05
        being aggregated into a report in the apmReportTable.  All
Packit 022b05
        reports with the same apmReportControlIndex will be based on
Packit 022b05
        the same interval. This object must be greater than zero.
Packit 022b05
Packit 022b05
        Many users desire that these reports be synchronized to within
Packit 022b05
        seconds of the beginning of the hour because the results may
Packit 022b05
        be correlated more meaningfully to business behavior and so
Packit 022b05
        that data from multiple agents is aggregated over the same
Packit 022b05
        time periods. Thus management software may take extra effort
Packit 022b05
        to synchronize reports to the beginning of the hour and to one
Packit 022b05
        another. However, the agent must not allow reports to 'drift'
Packit 022b05
        over time as they will quickly become unsynchronized. In
Packit 022b05
        particular, if there is any fixed processing delay between
Packit 022b05
        reports, the reports should deduct this time from the interval
Packit 022b05
        so that reports don't drift.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        apmReportControlStatus object is equal to active(1)."
Packit 022b05
    DEFVAL { 3600 }
Packit 022b05
    ::= { apmReportControlEntry 4 }
Packit 022b05
Packit 022b05
apmReportControlRequestedSize OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of entries requested to be allocated for each
Packit 022b05
        report generated on behalf of this entry."
Packit 022b05
    ::= { apmReportControlEntry 5 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
apmReportControlGrantedSize OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of entries per report the agent has allocated
Packit 022b05
        based on the requested amount in apmReportControlRequestedSize.
Packit 022b05
        Since multiple reports are saved, the total number of entries
Packit 022b05
        allocated will be this number multiplied by the value of
Packit 022b05
        apmReportControlGrantedReports, or 1 if that object doesn't
Packit 022b05
        exist.
Packit 022b05
Packit 022b05
        When the associated apmReportControlRequestedSize object is
Packit 022b05
        created or modified, the agent should set this object as
Packit 022b05
        closely to the requested value as is possible for the
Packit 022b05
        particular implementation and available resources. When
Packit 022b05
        considering resources available, the agent must consider its
Packit 022b05
        ability to allocate this many entries for all reports.
Packit 022b05
Packit 022b05
        Note that while the actual number of entries stored in the
Packit 022b05
        reports may fluctuate due to changing conditions, the agent
Packit 022b05
        must continue to have storage available to satisfy the full
Packit 022b05
        report size for all reports when necessary. Further, the agent
Packit 022b05
        must not lower this value except as a result of a set to the
Packit 022b05
        associated apmReportControlRequestedSize object."
Packit 022b05
    ::= { apmReportControlEntry 6 }
Packit 022b05
Packit 022b05
apmReportControlRequestedReports OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (0..65535)
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of saved reports requested to be allocated on
Packit 022b05
        behalf of this entry."
Packit 022b05
    ::= { apmReportControlEntry 7 }
Packit 022b05
Packit 022b05
apmReportControlGrantedReports OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (0..65535)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of saved reports the agent has allocated
Packit 022b05
        based on the requested amount in
Packit 022b05
        apmReportControlRequestedReports. Since each report can have
Packit 022b05
        many entries, the total number of entries allocated will be
Packit 022b05
        this number multiplied by the value of
Packit 022b05
        apmReportControlGrantedSize, or 1 if that object doesn't
Packit 022b05
        exist.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        When the associated apmReportControlRequestedReports object is
Packit 022b05
        created or modified, the agent should set this object as
Packit 022b05
        closely to the requested value as is possible for the
Packit 022b05
        particular implementation and available resources. When
Packit 022b05
        considering resources available, the agent must consider its
Packit 022b05
        ability to allocate this many reports each with the number of
Packit 022b05
        entries represented by apmReportControlGrantedSize, or 1 if
Packit 022b05
        that object doesn't exist.
Packit 022b05
Packit 022b05
        Note that while the storage required for each report may
Packit 022b05
        fluctuate due to changing conditions, the agent must continue
Packit 022b05
        to have storage available to satisfy the full report size for
Packit 022b05
        all reports when necessary. Further, the agent must not lower
Packit 022b05
        this value except as a result of a set to the associated
Packit 022b05
        apmReportControlRequestedSize object."
Packit 022b05
    ::= { apmReportControlEntry 8 }
Packit 022b05
Packit 022b05
apmReportControlStartTime OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeStamp
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime when the system began processing the
Packit 022b05
        report in progress. Note that the report in progress is not
Packit 022b05
        available.
Packit 022b05
Packit 022b05
        This object may be used by the management station to figure
Packit 022b05
        out the start time for all previous reports saved for this
Packit 022b05
        apmReportControlEntry, as reports are started at fixed
Packit 022b05
        intervals."
Packit 022b05
    ::= { apmReportControlEntry 9 }
Packit 022b05
Packit 022b05
apmReportControlReportNumber OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (1..4294967295)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of the report in progress. When an
Packit 022b05
        apmReportControlEntry is activated, the first report will be
Packit 022b05
        numbered one."
Packit 022b05
    ::= { apmReportControlEntry 10 }
Packit 022b05
Packit 022b05
apmReportControlDeniedInserts OBJECT-TYPE
Packit 022b05
    SYNTAX      Counter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of failed attempts to add an entry to reports for
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        this apmReportControlEntry because the number of entries
Packit 022b05
        would have exceeded apmReportControlGrantedSize.
Packit 022b05
Packit 022b05
        This number is valuable in determining if enough entries have
Packit 022b05
        been allocated for reports in light of fluctuating network
Packit 022b05
        usage. Note that since an entry that is denied will often be
Packit 022b05
        attempted again, this number will not predict the exact number
Packit 022b05
        of additional entries needed, but can be used to understand
Packit 022b05
        the relative magnitude of the problem.
Packit 022b05
Packit 022b05
        Also note that there is no ordering specified for the entries
Packit 022b05
        in the report, thus there are no rules for which entries will
Packit 022b05
        be omitted when not enough entries are available. As a
Packit 022b05
        consequence, the agent is not required to delete 'least
Packit 022b05
        valuable' entries first."
Packit 022b05
    ::= { apmReportControlEntry 11 }
Packit 022b05
Packit 022b05
apmReportControlDroppedFrames OBJECT-TYPE
Packit 022b05
    SYNTAX      Counter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The total number of frames which were received by the agent
Packit 022b05
        and therefore not accounted for in the *StatsDropEvents, but
Packit 022b05
        for which the agent chose not to count for this entry for
Packit 022b05
        whatever reason.  Most often, this event occurs when the agent
Packit 022b05
        is out of some resources and decides to shed load from this
Packit 022b05
        collection.
Packit 022b05
Packit 022b05
        This count does not include packets that were not counted
Packit 022b05
        because they had MAC-layer errors.
Packit 022b05
Packit 022b05
        This counter is only relevant if this apm report is based on
Packit 022b05
        a data source whose collection methodology is based on
Packit 022b05
        analyzing network traffic.
Packit 022b05
Packit 022b05
        Note that if the apmReportTables are inactive because no
Packit 022b05
        applications are enabled in the application directory, this
Packit 022b05
        value should be 0.
Packit 022b05
Packit 022b05
        Note that, unlike the dropEvents counter, this number is the
Packit 022b05
        exact number of frames dropped."
Packit 022b05
    ::= { apmReportControlEntry 12 }
Packit 022b05
Packit 022b05
apmReportControlOwner OBJECT-TYPE
Packit 022b05
    SYNTAX      OwnerString
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is
Packit 022b05
        therefore using the resources assigned to it."
Packit 022b05
    ::= { apmReportControlEntry 13 }
Packit 022b05
Packit 022b05
apmReportControlStorageType OBJECT-TYPE
Packit 022b05
    SYNTAX      StorageType
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The storage type of this apmReportControlEntry. If the value
Packit 022b05
        of this object is 'permanent', no objects in this row need to
Packit 022b05
        be writable."
Packit 022b05
    ::= { apmReportControlEntry 14 }
Packit 022b05
Packit 022b05
apmReportControlStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      RowStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this apmReportControlEntry.
Packit 022b05
Packit 022b05
        An entry may not exist in the active state unless all
Packit 022b05
        objects in the entry have an appropriate value. The only
Packit 022b05
        objects in the entry that may be modified while the entry is
Packit 022b05
        in the active state are apmReportControlRequestedSize and
Packit 022b05
        apmReportControlRequestedReports.
Packit 022b05
Packit 022b05
        If this object is not equal to active(1), all
Packit 022b05
        associated entries in the apmReportTable shall be deleted
Packit 022b05
        by the agent."
Packit 022b05
    ::= { apmReportControlEntry 15 }
Packit 022b05
Packit 022b05
-- The APM Report Table
Packit 022b05
Packit 022b05
apmReportTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF ApmReportEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The data resulting from aggregated APM reports. Consult the
Packit 022b05
        definition of apmReportControlAggregationType for the
Packit 022b05
        definition of the various types of aggregations."
Packit 022b05
    ::= { apmMibObjects 10 }
Packit 022b05
Packit 022b05
apmReportEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      ApmReportEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the apmReportTable.
Packit 022b05
        The apmReportControlIndex value in the index identifies the
Packit 022b05
        apmReportControlEntry on whose behalf this entry was created.
Packit 022b05
        The apmReportIndex value in the index identifies which report
Packit 022b05
        (in the series of reports) this entry is a part of.
Packit 022b05
        The apmAppDirAppLocalIndex value in the index identifies
Packit 022b05
        the common application of the transactions aggregated in this
Packit 022b05
        entry.
Packit 022b05
        The apmAppDirResponsivenessType value in the index
Packit 022b05
        identifies the type of responsiveness metric reported by
Packit 022b05
        this entry and uniquely identifies this entry when more
Packit 022b05
        than one responsiveness metric is measured for a flow.
Packit 022b05
        Entries will only exist in this table for those
Packit 022b05
        combinations of AppLocalIndex and ResponsivenessType
Packit 022b05
        that are configured 'on(1)'.
Packit 022b05
        The protocolDirLocalIndex value in the index identifies
Packit 022b05
        the network layer protocol of the apmReportServerAddress.
Packit 022b05
        When the associated apmReportControlAggregationType value is
Packit 022b05
        equal to applications(4) or clients(2), this
Packit 022b05
        protocolDirLocalIndex value will equal 0.
Packit 022b05
        The apmReportServerAddress value in the index identifies the
Packit 022b05
        network layer address of the server in transactions aggregated
Packit 022b05
        in this entry.
Packit 022b05
        The apmNameClientID value in the index identifies the
Packit 022b05
        client in transactions aggregated in this entry. If the
Packit 022b05
        associated apmReportControlAggregationType is equal to
Packit 022b05
        applications(4) or servers(3), then this protocolDirLocalIndex
Packit 022b05
        value will equal 0.
Packit 022b05
Packit 022b05
        An example of the indexing of this entry is
Packit 022b05
        apmReportTransactionCount.3.15.3.1.8.4.192.168.1.2.3232235788
Packit 022b05
Packit 022b05
        Note that some combinations of index values may result in an
Packit 022b05
        index that exceeds 128 sub-identifiers in length which exceeds
Packit 022b05
        the maximum for the SNMP protocol. Implementations should take
Packit 022b05
        care to avoid such combinations."
Packit 022b05
    INDEX { apmReportControlIndex, apmReportIndex,
Packit 022b05
            apmAppDirAppLocalIndex,
Packit 022b05
            apmAppDirResponsivenessType,
Packit 022b05
            protocolDirLocalIndex, apmReportServerAddress,
Packit 022b05
            apmNameClientID }
Packit 022b05
    ::= { apmReportTable 1 }
Packit 022b05
Packit 022b05
ApmReportEntry ::= SEQUENCE {
Packit 022b05
    apmReportIndex                  Unsigned32,
Packit 022b05
    apmReportServerAddress          ProtocolDirNetworkAddress,
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    apmReportTransactionCount       Unsigned32,
Packit 022b05
    apmReportSuccessfulTransactions Unsigned32,
Packit 022b05
    apmReportResponsivenessMean     Unsigned32,
Packit 022b05
    apmReportResponsivenessMin      Unsigned32,
Packit 022b05
    apmReportResponsivenessMax      Unsigned32,
Packit 022b05
    apmReportResponsivenessB1       Unsigned32,
Packit 022b05
    apmReportResponsivenessB2       Unsigned32,
Packit 022b05
    apmReportResponsivenessB3       Unsigned32,
Packit 022b05
    apmReportResponsivenessB4       Unsigned32,
Packit 022b05
    apmReportResponsivenessB5       Unsigned32,
Packit 022b05
    apmReportResponsivenessB6       Unsigned32,
Packit 022b05
    apmReportResponsivenessB7       Unsigned32
Packit 022b05
}
Packit 022b05
Packit 022b05
apmReportIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (1..4294967295)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of apmReportControlReportNumber for the report to
Packit 022b05
        which this entry belongs."
Packit 022b05
    ::= { apmReportEntry 1 }
Packit 022b05
Packit 022b05
apmReportServerAddress OBJECT-TYPE
Packit 022b05
    SYNTAX      ProtocolDirNetworkAddress
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The network server address for this apmReportEntry.
Packit 022b05
Packit 022b05
        This is represented as an octet string with
Packit 022b05
        specific semantics and length as identified
Packit 022b05
        by the protocolDirLocalIndex component of the index.
Packit 022b05
Packit 022b05
        Since this object is an index variable, it is encoded in the
Packit 022b05
        index according to the index encoding rules.  For example, if
Packit 022b05
        the protocolDirLocalIndex indicates an encapsulation of ip,
Packit 022b05
        this object is encoded as a length octet of 4, followed by the
Packit 022b05
        4 octets of the ip address, in network byte order. Care
Packit 022b05
        should be taken to avoid values of this object that, in
Packit 022b05
        conjunction with the other index variables, would result in an
Packit 022b05
        index longer than SNMP's maximum of 128 subidentifiers.
Packit 022b05
Packit 022b05
        If the associated apmReportControlAggregationType is equal to
Packit 022b05
        applications(4) or clients(2), then this object will be a null
Packit 022b05
        string and will be encoded simply as a length octet of 0."
Packit 022b05
    ::= { apmReportEntry 2 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
apmReportTransactionCount OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of transactions aggregated into this record."
Packit 022b05
    ::= { apmReportEntry 3 }
Packit 022b05
Packit 022b05
apmReportSuccessfulTransactions OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of successful transactions aggregated into
Packit 022b05
        this record."
Packit 022b05
    ::= { apmReportEntry 4 }
Packit 022b05
Packit 022b05
apmReportResponsivenessMean OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The arithmetic mean of the responsiveness metrics for all
Packit 022b05
        successful transactions aggregated into this record."
Packit 022b05
    ::= { apmReportEntry 5 }
Packit 022b05
Packit 022b05
apmReportResponsivenessMin OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The minimum of the responsiveness metrics for all
Packit 022b05
        successful transactions aggregated into this record."
Packit 022b05
    ::= { apmReportEntry 6 }
Packit 022b05
Packit 022b05
apmReportResponsivenessMax OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum of the responsiveness metrics for all
Packit 022b05
        successful transactions aggregated into this record."
Packit 022b05
    ::= { apmReportEntry 7 }
Packit 022b05
Packit 022b05
-- Note that when updating a report entry, a transaction will not be
Packit 022b05
-- counted in more than 1 bucket in an entry. It will be counted in
Packit 022b05
-- the first bucket that matches, starting with Bucket 1 (B1). Note
Packit 022b05
-- that if a transaction matches 2 application types, it will update
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
-- one bucket in each of 2 entries in this table.
Packit 022b05
Packit 022b05
apmReportResponsivenessB1 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of successful transactions aggregated into this
Packit 022b05
        record whose responsiveness was less than boundary1 value for
Packit 022b05
        this application."
Packit 022b05
    ::= { apmReportEntry 8 }
Packit 022b05
Packit 022b05
apmReportResponsivenessB2 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of successful transactions aggregated into this
Packit 022b05
        record whose responsiveness did not fall into Bucket 1 and was
Packit 022b05
        greater than or equal to the boundary1 value for this
Packit 022b05
        application and less than the boundary2 value for this
Packit 022b05
        application."
Packit 022b05
    ::= { apmReportEntry 9 }
Packit 022b05
Packit 022b05
apmReportResponsivenessB3 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of successful transactions aggregated into this
Packit 022b05
        record whose responsiveness did not fall into Bucket 1 or 2
Packit 022b05
        and as greater than or equal to the boundary2 value for this
Packit 022b05
        application and less than the boundary3 value for this
Packit 022b05
        application."
Packit 022b05
    ::= { apmReportEntry 10 }
Packit 022b05
Packit 022b05
apmReportResponsivenessB4 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of successful transactions aggregated into this
Packit 022b05
        record whose responsiveness did not fall into Buckets 1
Packit 022b05
        through 3 and was greater than or equal to the boundary3 value
Packit 022b05
        for this application and less than the boundary4 value for
Packit 022b05
        this application."
Packit 022b05
    ::= { apmReportEntry 11 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
apmReportResponsivenessB5 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of successful transactions aggregated into this
Packit 022b05
        record whose responsiveness did not fall into Buckets 1
Packit 022b05
        through 4 and was greater than or equal to the boundary4 value
Packit 022b05
        for this application and less than the boundary5 value for
Packit 022b05
        this application."
Packit 022b05
    ::= { apmReportEntry 12 }
Packit 022b05
Packit 022b05
apmReportResponsivenessB6 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of successful transactions aggregated into this
Packit 022b05
        record whose responsiveness did not fall into Buckets 1
Packit 022b05
        through 5 and was greater than or equal to the
Packit 022b05
        boundary5 value for this application and less than the
Packit 022b05
        boundary6 value for this application."
Packit 022b05
    ::= { apmReportEntry 13 }
Packit 022b05
Packit 022b05
apmReportResponsivenessB7 OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of successful transactions aggregated into this
Packit 022b05
        record whose responsiveness did not fall into Buckets 1
Packit 022b05
        through 6 and was greater than or equal to the boundary6 value
Packit 022b05
        for this application."
Packit 022b05
    ::= { apmReportEntry 14 }
Packit 022b05
Packit 022b05
-- APM Transaction Table
Packit 022b05
Packit 022b05
apmTransactionTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF ApmTransactionEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This table contains transactions that are currently running
Packit 022b05
        or have recently finished."
Packit 022b05
    ::= { apmMibObjects 11 }
Packit 022b05
Packit 022b05
apmTransactionEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      ApmTransactionEntry
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the apmTransactionTable.
Packit 022b05
Packit 022b05
        The apmAppDirAppLocalIndex value in the index identifies
Packit 022b05
        the application of the transaction represented by this entry.
Packit 022b05
        The apmAppDirResponsivenessType value in the index
Packit 022b05
        identifies the type of responsiveness metric reported by
Packit 022b05
        this entry and uniquely identifies this entry when more
Packit 022b05
        than one responsiveness metric is measured for a flow.
Packit 022b05
        Entries will only exist in this table for those
Packit 022b05
        combinations of AppLocalIndex and ResponsivenessType
Packit 022b05
        that are configured 'on(1)'.
Packit 022b05
        The protocolDirLocalIndex value in the index identifies
Packit 022b05
        the network layer protocol of the apmTransactionServerAddress.
Packit 022b05
        The apmTransactionServerAddress value in the index identifies
Packit 022b05
        the network layer address of the server in the transaction
Packit 022b05
        represented by this entry.
Packit 022b05
        The apmNameClientID value in the index identifies the
Packit 022b05
        client in the transaction represented by this entry.
Packit 022b05
Packit 022b05
        An example of the indexing of this entry is
Packit 022b05
        apmTransactionCount.3.1.8.4.192.168.1.2.3232235788.2987
Packit 022b05
Packit 022b05
        Note that some combinations of index values may result in an
Packit 022b05
        index that exceeds 128 sub-identifiers in length which exceeds
Packit 022b05
        the maximum for the SNMP protocol. Implementations should take
Packit 022b05
        care to avoid such combinations."
Packit 022b05
    INDEX { apmAppDirAppLocalIndex,
Packit 022b05
            apmAppDirResponsivenessType,
Packit 022b05
            protocolDirLocalIndex, apmTransactionServerAddress,
Packit 022b05
            apmNameClientID, apmTransactionID }
Packit 022b05
    ::= { apmTransactionTable 1 }
Packit 022b05
Packit 022b05
ApmTransactionEntry ::= SEQUENCE {
Packit 022b05
    apmTransactionServerAddress      ProtocolDirNetworkAddress,
Packit 022b05
    apmTransactionID                 Unsigned32,
Packit 022b05
    apmTransactionResponsiveness     Unsigned32,
Packit 022b05
    apmTransactionAge                TimeInterval,
Packit 022b05
    apmTransactionSuccess            TruthValue
Packit 022b05
}
Packit 022b05
Packit 022b05
apmTransactionServerAddress OBJECT-TYPE
Packit 022b05
    SYNTAX      ProtocolDirNetworkAddress (SIZE (1..255))
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        "The network server address for this apmTransactionEntry.
Packit 022b05
Packit 022b05
        This is represented as an octet string with specific semantics
Packit 022b05
        and length as identified by the protocolDirLocalIndex
Packit 022b05
        component of the index. This object may not be the zero length
Packit 022b05
        string.
Packit 022b05
Packit 022b05
        For example, if the protocolDirLocalIndex indicates an
Packit 022b05
        encapsulation of ip, this object is encoded as a length octet
Packit 022b05
        of 4, followed by the 4 octets of the ip address, in network
Packit 022b05
        byte order. Care should be taken to avoid values of this
Packit 022b05
        object that, in conjunction with the other index variables,
Packit 022b05
        would result in an index longer than SNMP's maximum of 128
Packit 022b05
        subidentifiers."
Packit 022b05
    ::= { apmTransactionEntry 1 }
Packit 022b05
Packit 022b05
apmTransactionID OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (0..4294967295)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A unique value for this transaction amongst other
Packit 022b05
        transactions sharing the same application layer protocol and
Packit 022b05
        server and client addresses. Implementations may choose to use
Packit 022b05
        the value of the client's source port, when possible."
Packit 022b05
    ::= { apmTransactionEntry 2 }
Packit 022b05
Packit 022b05
apmTransactionResponsiveness OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The current value of the responsiveness metric for this
Packit 022b05
        transaction. If this transaction has completed, the final
Packit 022b05
        value of the metric will be available.
Packit 022b05
Packit 022b05
        Note that this value may change over the lifetime of the
Packit 022b05
        transaction and it is the final value of this metric that is
Packit 022b05
        recorded as the responsiveness of the transaction for use in
Packit 022b05
        other APM MIB functions."
Packit 022b05
    ::= { apmTransactionEntry 3 }
Packit 022b05
Packit 022b05
apmTransactionAge OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeInterval
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "If this transaction is still executing, this value shall be
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        the length of time since it was started. If it has completed,
Packit 022b05
        this value shall be the length of time it was executing."
Packit 022b05
    ::= { apmTransactionEntry 4 }
Packit 022b05
Packit 022b05
apmTransactionSuccess OBJECT-TYPE
Packit 022b05
    SYNTAX      TruthValue
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The success of this transaction up to this time. Once a
Packit 022b05
        transaction has been marked as failed, it cannot move back
Packit 022b05
        into the successful state."
Packit 022b05
    ::= { apmTransactionEntry 5 }
Packit 022b05
Packit 022b05
apmTransactionsRequestedHistorySize OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum number of completed transactions desired to be
Packit 022b05
        retained in the apmTransactionTable. If the agent doesn't have
Packit 022b05
        enough resources to retain this many, it will retain as many as
Packit 022b05
        possible. Regardless of this value, the agent must attempt to
Packit 022b05
        keep records for all current transactions it is monitoring.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
    ::= { apmMibObjects 12 }
Packit 022b05
Packit 022b05
-- The APM Exception table
Packit 022b05
-- The APM Exception Table creates filters so that a management
Packit 022b05
-- station can get immediate notification of a transaction that has
Packit 022b05
-- had poor availability or responsiveness.
Packit 022b05
--
Packit 022b05
-- This function is particularly helpful in unaggregated situations
Packit 022b05
-- where the numbers of agents is relatively high and the transaction
Packit 022b05
-- rate per agent is relatively low (such as agents for desktops or
Packit 022b05
-- dedicated to small workgroups). Polling agents in such an
Packit 022b05
-- environment would either cause scalability problems (high rate) or
Packit 022b05
-- lead to long notification delays (low rate).
Packit 022b05
Packit 022b05
Packit 022b05
apmExceptionTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF ApmExceptionEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This table creates filters so that a management station can
Packit 022b05
        get immediate notification of a transaction that has had poor
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        availability or responsiveness.
Packit 022b05
Packit 022b05
        Each apmExceptionEntry is associated with a particular type of
Packit 022b05
        transaction and is applied to all transactions of that
Packit 022b05
        type. Multiple apmExceptionEntries may be associated with a
Packit 022b05
        particular type of transaction. A transaction type is
Packit 022b05
        identified by the value of the apmAppDirAppLocalIndex
Packit 022b05
        component of the index.
Packit 022b05
Packit 022b05
        Because the quality of a transaction is not known until it is
Packit 022b05
        completed, these thresholds are only applied after the
Packit 022b05
        transaction has completed."
Packit 022b05
    ::= { apmMibObjects 13 }
Packit 022b05
Packit 022b05
apmExceptionEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      ApmExceptionEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the apmExceptionTable.
Packit 022b05
Packit 022b05
        The apmAppDirAppLocalIndex value in the index identifies
Packit 022b05
        the application this entry will monitor.
Packit 022b05
        The apmAppDirResponsivenessType value in the index
Packit 022b05
        identifies the type of responsiveness metric this entry will
Packit 022b05
        monitor."
Packit 022b05
Packit 022b05
    INDEX { apmAppDirAppLocalIndex,
Packit 022b05
            apmAppDirResponsivenessType, apmExceptionIndex }
Packit 022b05
    ::= { apmExceptionTable 1 }
Packit 022b05
Packit 022b05
ApmExceptionEntry ::= SEQUENCE {
Packit 022b05
    apmExceptionIndex                       Unsigned32,
Packit 022b05
    apmExceptionResponsivenessComparison    INTEGER,
Packit 022b05
    apmExceptionResponsivenessThreshold     Unsigned32,
Packit 022b05
    apmExceptionUnsuccessfulException       INTEGER,
Packit 022b05
    apmExceptionResponsivenessEvents        Counter32,
Packit 022b05
    apmExceptionUnsuccessfulEvents          Counter32,
Packit 022b05
    apmExceptionOwner                       OwnerString,
Packit 022b05
    apmExceptionStorageType                 StorageType,
Packit 022b05
    apmExceptionStatus                      RowStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
apmExceptionIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (1..65535)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        "An index that uniquely identifies an entry in the
Packit 022b05
        apmExceptionTable amongst other entries with equivalent index
Packit 022b05
        values for apmAppDirAppLocalIndex and
Packit 022b05
        apmAppDirResponsivenessType. Each such entry sets up
Packit 022b05
        thresholds for a particular measurement of a particular
Packit 022b05
        application."
Packit 022b05
    ::= { apmExceptionEntry 1 }
Packit 022b05
Packit 022b05
apmExceptionResponsivenessComparison OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
                    none(1),
Packit 022b05
                    greater(2),
Packit 022b05
                    less(3)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "If this value is greater(2) or less(3), the associated
Packit 022b05
        apmExceptionResponsivenessThreshold will be compared to this
Packit 022b05
        value and an exception will be created if the responsiveness
Packit 022b05
        is greater than the threshold (greater(2)) or less than the
Packit 022b05
        threshold (less(3))."
Packit 022b05
    ::= { apmExceptionEntry 2 }
Packit 022b05
Packit 022b05
apmExceptionResponsivenessThreshold OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The threshold that responsiveness metrics are compared to."
Packit 022b05
    ::= { apmExceptionEntry 3 }
Packit 022b05
Packit 022b05
apmExceptionUnsuccessfulException OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
                    off(1),
Packit 022b05
                    on(2)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "If this value is on(2), an exception will be created if a
Packit 022b05
        transaction of the associated type is unsuccessful."
Packit 022b05
    ::= { apmExceptionEntry 4 }
Packit 022b05
Packit 022b05
apmExceptionResponsivenessEvents OBJECT-TYPE
Packit 022b05
    SYNTAX      Counter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of responsiveness exceptions generated. This
Packit 022b05
        counter will be incremented even if no notification was sent
Packit 022b05
        due to notifications not being configured or due to exceeding
Packit 022b05
        the apmNotificationMaxRate value."
Packit 022b05
    ::= { apmExceptionEntry 5 }
Packit 022b05
Packit 022b05
apmExceptionUnsuccessfulEvents OBJECT-TYPE
Packit 022b05
    SYNTAX      Counter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of unsuccessful exceptions generated. This
Packit 022b05
        counter will be incremented even if no notification was sent
Packit 022b05
        due to notifications not being configured or due to exceeding
Packit 022b05
        the apmNotificationMaxRate value."
Packit 022b05
    ::= { apmExceptionEntry 6 }
Packit 022b05
Packit 022b05
apmExceptionOwner OBJECT-TYPE
Packit 022b05
    SYNTAX      OwnerString
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is
Packit 022b05
        therefore using the resources assigned to it."
Packit 022b05
    ::= { apmExceptionEntry 7 }
Packit 022b05
Packit 022b05
apmExceptionStorageType OBJECT-TYPE
Packit 022b05
    SYNTAX     StorageType
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The storage type of this apmReportControlEntry. If the value
Packit 022b05
        of this object is 'permanent', no objects in this row need to
Packit 022b05
        be writable."
Packit 022b05
    ::= { apmExceptionEntry 8 }
Packit 022b05
Packit 022b05
apmExceptionStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     RowStatus
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this apmExceptionEntry. The only objects in the
Packit 022b05
        entry that may be modified while the entry is in the active
Packit 022b05
        state are apmExceptionResponsivenessComparison,
Packit 022b05
        apmExceptionResponsivenessThreshold and
Packit 022b05
        apmExceptionUnsuccessfulException."
Packit 022b05
    ::= { apmExceptionEntry 9 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
apmThroughputExceptionMinTime OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    UNITS       "seconds"
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Because the responsiveness for throughput-oriented
Packit 022b05
        transactions is divided by the elapsed time, it can be very
Packit 022b05
        sensitive to short-term performance variations for
Packit 022b05
        transactions that take a short period of time. For example,
Packit 022b05
        when downloading a very short file, a single dropped packet
Packit 022b05
        could double or triple the total response time.
Packit 022b05
Packit 022b05
        Further, throughput is usually examined for applications that
Packit 022b05
        transfer a lot of data, and when doing so it is helpful to
Packit 022b05
        conceptualize transaction costs that are proportional to the
Packit 022b05
        amount of data separately from those costs that are relatively
Packit 022b05
        fixed (i.e., independent of the amount of data).  For very
Packit 022b05
        short transactions, these fixed transaction costs (handshake,
Packit 022b05
        setup time, authentication, round-trip time) may dominate the
Packit 022b05
        total response time for the transaction, resulting in
Packit 022b05
        throughput measurements that aren't really proportional to the
Packit 022b05
        network's, server's and client's combined data throughput
Packit 022b05
        capability.
Packit 022b05
Packit 022b05
        This object controls the minimum number of seconds that an
Packit 022b05
        throughput-based transaction must exceed before an exception
Packit 022b05
        can be generated for it. If this object is set to zero, then
Packit 022b05
        all throughput-based transactions are candidates for
Packit 022b05
        exceptions.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
    DEFVAL     { 10 }
Packit 022b05
    ::= { apmMibObjects 14 }
Packit 022b05
Packit 022b05
apmNotificationMaxRate OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum number of notifications that can be generated
Packit 022b05
        from this agent by the apmExceptionTable in any 60 second
Packit 022b05
        period.
Packit 022b05
Packit 022b05
        The value of this object must persist across reboots."
Packit 022b05
    DEFVAL { 1 }
Packit 022b05
    ::= { apmMibObjects 15 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
-- APM Notifications
Packit 022b05
Packit 022b05
apmNotifications OBJECT IDENTIFIER ::= { apm 0 }
Packit 022b05
Packit 022b05
apmTransactionResponsivenessAlarm NOTIFICATION-TYPE
Packit 022b05
    OBJECTS     { apmExceptionResponsivenessThreshold,
Packit 022b05
                  apmTransactionResponsiveness }
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Notification sent when a transaction exceeds a threshold
Packit 022b05
        defined in the apmException table. The index of the
Packit 022b05
        included apmExceptionResponsivenessThreshold object identifies
Packit 022b05
        the apmExceptionEntry that specified the threshold. The
Packit 022b05
        apmTransactionResponsiveness variable identifies the actual
Packit 022b05
        transaction and its responsiveness.
Packit 022b05
Packit 022b05
        Agent implementors are urged to include additional data
Packit 022b05
        objects in the alarm that may explain the reason for the
Packit 022b05
        alarm. It is helpful to include such data in the alarm because
Packit 022b05
        it describes the situation at the time the alarm was
Packit 022b05
        generated, where polls after the fact may not provide
Packit 022b05
        meaningful information. Examples of such information are CPU
Packit 022b05
        load, memory utilization, network utilization, and transaction
Packit 022b05
        statistics."
Packit 022b05
    ::= { apmNotifications 1 }
Packit 022b05
Packit 022b05
apmTransactionUnsuccessfulAlarm NOTIFICATION-TYPE
Packit 022b05
    OBJECTS     { apmExceptionResponsivenessThreshold }
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Notification sent when a transaction is unsuccessful.
Packit 022b05
        The index of the included apmExceptionResponsivenessThreshold
Packit 022b05
        object identifies both the type of the transaction that caused
Packit 022b05
        this notification as well as the apmExceptionEntry that
Packit 022b05
        specified the threshold.
Packit 022b05
Packit 022b05
        Agent implementors are urged to include additional data
Packit 022b05
        objects in the alarm that may explain the reason for the
Packit 022b05
        alarm. It is helpful to include such data in the alarm because
Packit 022b05
        it describes the situation at the time the alarm was
Packit 022b05
        generated, where polls after the fact may not provide
Packit 022b05
        meaningful information. Examples of such information are CPU
Packit 022b05
        load, memory utilization, network utilization, and transaction
Packit 022b05
        statistics."
Packit 022b05
    ::= { apmNotifications 2 }
Packit 022b05
Packit 022b05
apmCompliance MODULE-COMPLIANCE
Packit 022b05
    STATUS  current
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Describes the requirements for conformance to
Packit 022b05
        the APM MIB"
Packit 022b05
    MODULE  -- this module
Packit 022b05
        MANDATORY-GROUPS { apmAppDirGroup, apmReportGroup }
Packit 022b05
Packit 022b05
        GROUP apmUserDefinedApplicationsGroup
Packit 022b05
          DESCRIPTION
Packit 022b05
              "Implementation of the apmUserDefinedApplicationsGroup
Packit 022b05
              is optional."
Packit 022b05
Packit 022b05
        GROUP apmTransactionGroup
Packit 022b05
          DESCRIPTION
Packit 022b05
              "Implementation of the apmTransactionGroup is optional."
Packit 022b05
Packit 022b05
        GROUP apmExceptionGroup
Packit 022b05
          DESCRIPTION
Packit 022b05
              "Implementation of the apmExceptionGroup is optional."
Packit 022b05
Packit 022b05
        GROUP apmNotificationGroup
Packit 022b05
          DESCRIPTION
Packit 022b05
              "Implementation of the apmNotificationGroup is optional."
Packit 022b05
Packit 022b05
    ::= { apmCompliances 1 }
Packit 022b05
Packit 022b05
apmAppDirGroup OBJECT-GROUP
Packit 022b05
    OBJECTS { apmAppDirConfig,
Packit 022b05
              apmAppDirResponsivenessBoundary1,
Packit 022b05
              apmAppDirResponsivenessBoundary2,
Packit 022b05
              apmAppDirResponsivenessBoundary3,
Packit 022b05
              apmAppDirResponsivenessBoundary4,
Packit 022b05
              apmAppDirResponsivenessBoundary5,
Packit 022b05
              apmAppDirResponsivenessBoundary6,
Packit 022b05
              apmBucketBoundaryLastChange, apmAppDirID,
Packit 022b05
              apmNameMachineName, apmNameUserName }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The APM MIB directory of applications and application verbs."
Packit 022b05
    ::=  { apmGroups 1 }
Packit 022b05
Packit 022b05
apmUserDefinedApplicationsGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {     apmHttpFilterAppLocalIndex,
Packit 022b05
                  apmHttpFilterServerProtocol,
Packit 022b05
                  apmHttpFilterServerAddress, apmHttpFilterURLPath,
Packit 022b05
                  apmHttpFilterMatchType, apmHttpFilterOwner,
Packit 022b05
                  apmHttpFilterStorageType, apmHttpFilterRowStatus,
Packit 022b05
                  apmHttpIgnoreUnregisteredURLs, apmHttp4xxIsFailure,
Packit 022b05
                  apmUserDefinedAppParentIndex,
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
                  apmUserDefinedAppApplication }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Objects used for creating and managing user-defined
Packit 022b05
        applications."
Packit 022b05
    ::= { apmGroups 2 }
Packit 022b05
Packit 022b05
apmReportGroup OBJECT-GROUP
Packit 022b05
    OBJECTS { apmReportControlDataSource,
Packit 022b05
              apmReportControlAggregationType,
Packit 022b05
              apmReportControlInterval,
Packit 022b05
              apmReportControlRequestedSize,
Packit 022b05
              apmReportControlGrantedSize,
Packit 022b05
              apmReportControlRequestedReports,
Packit 022b05
              apmReportControlGrantedReports,
Packit 022b05
              apmReportControlStartTime,
Packit 022b05
              apmReportControlReportNumber,
Packit 022b05
              apmReportControlDeniedInserts,
Packit 022b05
              apmReportControlDroppedFrames,
Packit 022b05
              apmReportControlOwner,
Packit 022b05
              apmReportControlStorageType,
Packit 022b05
              apmReportControlStatus,
Packit 022b05
              apmReportTransactionCount,
Packit 022b05
              apmReportSuccessfulTransactions,
Packit 022b05
              apmReportResponsivenessMean,
Packit 022b05
              apmReportResponsivenessMin,
Packit 022b05
              apmReportResponsivenessMax,
Packit 022b05
              apmReportResponsivenessB1,
Packit 022b05
              apmReportResponsivenessB2,
Packit 022b05
              apmReportResponsivenessB3,
Packit 022b05
              apmReportResponsivenessB4,
Packit 022b05
              apmReportResponsivenessB5,
Packit 022b05
              apmReportResponsivenessB6,
Packit 022b05
              apmReportResponsivenessB7 }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The apm report group controls the creation and retrieval of
Packit 022b05
        reports that aggregate application performance."
Packit 022b05
    ::=  { apmGroups 3 }
Packit 022b05
Packit 022b05
apmTransactionGroup OBJECT-GROUP
Packit 022b05
    OBJECTS { apmTransactionResponsiveness,
Packit 022b05
              apmTransactionAge, apmTransactionSuccess,
Packit 022b05
              apmTransactionsRequestedHistorySize }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The apm transaction group contains statistics for
Packit 022b05
        individual transactions."
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    ::=  { apmGroups 4 }
Packit 022b05
Packit 022b05
apmExceptionGroup OBJECT-GROUP
Packit 022b05
    OBJECTS { apmExceptionResponsivenessComparison,
Packit 022b05
              apmExceptionResponsivenessThreshold,
Packit 022b05
              apmExceptionUnsuccessfulException,
Packit 022b05
              apmExceptionResponsivenessEvents,
Packit 022b05
              apmExceptionUnsuccessfulEvents,
Packit 022b05
              apmExceptionOwner, apmExceptionStorageType,
Packit 022b05
              apmExceptionStatus, apmThroughputExceptionMinTime,
Packit 022b05
              apmNotificationMaxRate }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The apm exception group causes notifications to be sent
Packit 022b05
        whenever transactions are detected that had poor availability
Packit 022b05
        or responsiveness."
Packit 022b05
    ::=  { apmGroups 5 }
Packit 022b05
Packit 022b05
apmNotificationGroup NOTIFICATION-GROUP
Packit 022b05
    NOTIFICATIONS { apmTransactionResponsivenessAlarm,
Packit 022b05
                    apmTransactionUnsuccessfulAlarm }
Packit 022b05
    STATUS        current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Notifications sent by an APM MIB agent."
Packit 022b05
    ::= { apmGroups 6 }
Packit 022b05
Packit 022b05
END