-- extracted from draft-bierman-rmonmib-apmcaps-00.txt -- at Fri Mar 17 12:29:49 2000 APMCAPS-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE FROM SNMPv2-SMI TEXTUAL-CONVENTION, RowPointer, TruthValue FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF SnmpAdminString FROM SNMP-FRAMEWORK-MIB rmon FROM RMON-MIB protocolDirLocalIndex, protocolDirectoryGroup PROM RMON2-MIB; apmCapsMIB MODULE-IDENTITY LAST-UPDATED "200003100000Z" ORGANIZATION "IETF RMONMIB WG" CONTACT-INFO " E-mail: rmonmib@cisco.com Subscribe: majordomo@cisco.com w/ msg body: subscribe rmonmib Andy Bierman Cisco Systems Inc. 170 West Tasman Drive San Jose, CA 95134 +1 408-527-3711 abierman@cisco.com" DESCRIPTION "The MIB module for representing Application Performance Measurement Capabilities." REVISION "200003100000Z" DESCRIPTION "Initial Version of the APM Capabilities MIB." ::= { rmon xxx } apmCapsMIBObjects OBJECT IDENTIFIER ::= { apmCapsMIB 1 } apmCaps OBJECT IDENTIFIER ::= { apmCapsMIBObjects 1 } -- -- APM Metric Table -- apmMetricTable OBJECT-TYPE SYNTAX SEQUENCE OF ApmMetricEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains one row per APM Metric supported by this APM Device, and should be populated during system initialization." ::= { apmCaps 1 } apmMetricEntry OBJECT-TYPE SYNTAX ApmMetricEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Information about a particular APM Metric." INDEX { apmMetricID } ::= { apmMetricTable 1 } ApmMetricEntry ::= SEQUENCE { apmMetricID OBJECT IDENTIFIER, apmMetricType INTEGER, apmMetricDirType INTEGER, apmMetricIsStandard TruthValue, apmMetricName SnmpAdminString, apmMetricReference SnmpAdminString } apmMetricID OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index for this entry. This object identifies the standard or vendor-specific registration OBJECT IDENTIFER defined for a particular APM metric." ::= { apmMetricEntry 1 } apmMetricType OBJECT-TYPE SYNTAX INTEGER { other(1), connectMetric(2), delayMetric(3), lossMetric(4) } MAX-ACCESS read-only STATUS current DESCRIPTION "The basic type of metric indicated by this entry. The value 'other(1)' indicates that this metric cannot be characterized by any of the remaining enumerations specified for this object. The value 'connectMetric(2)' indicates that this metric measures network connectivity characteristics. The value 'delayMetric(3)' indicates that this metric measures network delay characteristics. The value 'lossMetric(4)' indicates that this metric measures network loss characteristics." ::= { apmMetricEntry 2 } apmMetricDirType OBJECT-TYPE SYNTAX INTEGER { oneWay(1), twoWay(2), multiWay(3), } MAX-ACCESS read-only STATUS current DESCRIPTION "The directional characteristics of the this metric. The value 'oneWay(1)' indicates that this metric is measured with some sort of uni-directional test. The value 'twoWay(2)' indicates that this metric is measured with some sort of bi-directional test. The value 'multiWay(3)' indicates that this metric is measured with some combination of uni-directional and/or bi- directional tests." ::= { apmMetricEntry 3 } apmMetricIsStandard OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates whether this metric is defined in a document defined by a standards organization. The value 'true(1)' indicates that this is a standard metric. The corresponding value of the apmMetricReference object should identify this document. The value 'false(2)' indicates that this is a proprietary metric." ::= { apmMetricEntry 4 } apmMetricName OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "The textual name of this metric." ::= { apmMetricEntry 5 } apmMetricReference OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "This object contains a reference to the document which defines this metric. If this document is available online via electronic download, then a URL should be specified in this object. For example, if this apmMetricEntry identified the IPPM metric 'Type-P-Round-Trip-Delay', then this object should contain the value 'http://www.ietf.org/rfc/rfc2681.txt'." ::= { apmMetricEntry 6 } -- -- APM Study Class Table -- apmStudyClassTable OBJECT-TYPE SYNTAX SEQUENCE OF ApmStudyClassEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains one row per APM Study Class supported by this APM Device, and should be populated during system initialization." ::= { apmCaps 2 } apmStudyClassEntry OBJECT-TYPE SYNTAX ApmStudyClassEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Information about a particular APM Study Class." INDEX { apmStudyClassID } ::= { apmStudyClassTable 1 } ApmStudyClassEntry ::= SEQUENCE { apmStudyClassID OBJECT IDENTIFIER, apmStudyClassCollectType BITS, apmStudyClassCollectPts Integer32, apmStudyClassCollectCaps BITS, apmStudyClassOutputCaps BITS, apmStudyClassCtlMibPtr OBJECT IDENTIFIER, apmStudyClassCtlTablePtr OBJECT IDENTIFIER, } apmStudyClassID OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index for this entry. This object identifier should specify the standard or vendor-specific registration OID for this APM Study Class." ::= { apmStudyClassEntry 1 } apmStudyClassCollectType OBJECT-TYPE SYNTAX BITS { apmPassiveClient(0), apmPassiveNet(1), apmPassiveServer(2), apmActiveClient(3), apmActiveNet(4), apmActiveServer(5), apmIntrusiveClient(6), apmIntrusiveNet(7), apmIntrusiveServer(8) } MAX-ACCESS read-only STATUS current DESCRIPTION "The type(s) of collection methodologies employed by this APM Study Class. If this APM Study class utilizes some sort of passive monitoring technology, which is located on the host machine being monitored, then the 'apmPassiveClient' BIT will be set. If this APM Study class utilizes some sort of passive monitoring technology which is located on one or more networking devices (e.g., routers, switches, RMON probes), then the 'apmPassiveNet' BIT will be set. If this APM Study class utilizes some sort of passive monitoring technology which is located on the machine(s) providing the network service being monitored, then the 'apmPassiveServer' BIT will be set. If this APM Study class utilizes some sort of active monitoring technology, which is located on a machine acting in the 'client role', then the 'apmActiveClient' BIT will be set. If this APM Study class utilizes some sort of active monitoring technology which is located on one or more networking devices (e.g., routers, switches, RMON probes), then the 'apmActiveNet' BIT will be set. If this APM Study class utilizes some sort of active monitoring technology which is located on a machine acting in the 'server role', then the 'apmActiveServer' BIT will be set. If this APM Study class utilizes some sort of intrusive monitoring technology, which is located on the host machine being monitored, then the 'apmIntrusiveClient' BIT will be set. If this APM Study class utilizes some sort of intrusive monitoring technology which is located on one or more networking devices (e.g., routers, switches, RMON probes), then the 'apmIntrusiveNet' BIT will be set. If this APM Study class utilizes some sort of intrusive monitoring technology which is located on the machine(s) providing the network service being monitored, then the 'apmIntrusiveServer' BIT will be set." ::= { apmStudyClassEntry 2 } apmStudyClassCollectPts OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "The number of APM Collection Points utilized in this APM Study Class. If this is a variable quantity, then this object should contain the minimum number needed for this APM Study Class to function." ::= { apmStudyClassEntry 3 } apmStudyClassCollectCaps OBJECT-TYPE SYNTAX BITS { apmCollectMac(0), apmCollectNet(1), apmCollectTrans(2), apmCollectApp(3), apmCollectFlow(4), apmCollectNonNet(5) } MAX-ACCESS read-only STATUS current DESCRIPTION "This object identifies some generic characteristics of the collection methodologies employed by this APM Study Class. If this APM Study class utilizes some sort of MAC (and/or VLAN) layer APM Data collection technology, then the 'apmCollectMac' BIT will be set. If this APM Study class utilizes some sort of network layer APM Data collection technology, then the 'apmCollectNet' BIT will be set. If this APM Study class utilizes some sort of transport layer APM Data collection technology, then the 'apmCollectTrans' BIT will be set. If this APM Study class utilizes some sort of application layer APM Data collection technology, then the 'apmCollectApp' BIT will be set. If this APM Study class utilizes some sort of APM Data collection technology based on monitoring of some sort of network flow summary information, then the 'apmCollectFlow' BIT will be set. If this APM Study class utilizes some sort of APM Data collection technology based on monitoring of non-network events, such as UI monitoring of window events, then the 'apmCollectNonNet' BIT will be set." ::= { apmStudyClassEntry 4 } apmStudyClassOutputCaps OBJECT-TYPE SYNTAX BITS { apmOutputOther(0), apmOutputApmDist(1), apmOutputApmStat(2), apmOutputApmHist(3), apmOutputApmFlow(4), apmOutputApmExcept(5), apmOutputApmProp(6), apmOutputTpmDist(7), apmOutputTpmStat(8), apmOutputTpmHist(9), apmOutputTpmExcept(10), apmOutputTpmProp(11) } MAX-ACCESS read-only STATUS current DESCRIPTION "The type(s) of APM Reports that this APM Study Class can provide. If this APM Study class can generate standard reports not described by any of the provided BITS here, then the 'apmOutputOther' BIT will be set. If this APM Study class can generate distribution-oriented reports for application layer protocols, then the 'apmOutputApmDist' BIT will be set. If this APM Study class can generate statistics-oriented reports for application layer protocols, then the 'apmOutputApmStat' BIT will be set. If this APM Study class can generate historical analysis oriented reports for application layer protocols, then the 'apmOutputApmHist' BIT will be set. If this APM Study class can generate flow decomposition analysis oriented reports for application layer protocols, then the 'apmOutputApmFlow' BIT will be set. If this APM Study class can generate profile exception oriented reports for application layer protocols, then the 'apmOutputApmExcept' BIT will be set. If this APM Study class can generate vendor-specific proprietary reports for application layer protocols, in addition to standard reports, then the 'apmOutputApmProp' BIT will be set. If this APM Study class can generate distribution-oriented reports for transport layer protocols, then the 'apmOutputTpmDist' BIT will be set. If this APM Study class can generate statistics-oriented reports for transport layer protocols, then the 'apmOutputTpmStat' BIT will be set. If this APM Study class can generate historical analysis oriented reports for transport layer protocols, then the 'apmOutputTpmHist' BIT will be set. If this APM Study class can generate flow decomposition analysis oriented reports for transport layer protocols, then the 'apmOutputTpmFlow' BIT will be set. If this APM Study class can generate profile exception oriented reports for transport layer protocols, then the 'apmOutputTpmExcept' BIT will be set. If this APM Study class can generate vendor-specific proprietary reports for transport layer protocols, in addition to standard reports, then the 'apmOutputTpmProp' BIT will be set." ::= { apmStudyClassEntry 5 } apmStudyClassCtlMibPtr OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-only STATUS current DESCRIPTION "This object identifies the MIB that can be used to configure detailed aspects of the collection or report processing functions for this APM Study Class. If such a MIB exists, then this object should contain the registration value specified in the MODULE-IDENTITY macro for that MIB. This object just identifies the MIB to use, not any particular agent which implements this MIB. This APM device may or may not contain an implementation of the specified MIB. If no appropriate MIB can be identified, then the value { 0 0 } is returned." ::= { apmStudyClassEntry 6 } apmStudyClassCtlTablePtr OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-only STATUS current DESCRIPTION "This object identifies a specific MIB table that can be used to configure detailed aspects of the collection or report processing functions for this APM Study Class. If such a MIB table exists, then this object should contain the registration value specified in the OBJECT-TYPE macro for the top-level MIB table definition. This MIB table must be within the MIB module specified by the associated apmStudyClassCtlMibPtr object. This object just identifies the MIB table to use, not any particular agent which implements this MIB table. This APM device may or may not contain an implementation of the specified MIB. If no appropriate MIB table can be identified, then the value { 0 0 } is returned." ::= { apmStudyClassEntry 7 } -- -- APM Study Metric Table -- apmStudyMetricTable OBJECT-TYPE SYNTAX SEQUENCE OF ApmStudyMetricEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains one row for each metric supported by the specified APM Study Class, and should be populated during system initialization." ::= { apmCaps 3 } apmStudyMetricEntry OBJECT-TYPE SYNTAX ApmStudyMetricEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Metrics information related to a particular APM Study Class." INDEX { apmStudyClassID } ::= { apmStudyMetricTable 1 } ApmStudyMetricEntry ::= SEQUENCE { apmStudyMetricID OBJECT IDENTIFIER } apmStudyMetricID OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-only STATUS current DESCRIPTION "This object identifies the APM Metric associated with this APM Study, and contains the same value as the apmMetricID index for that apmMetricEntry." ::= { apmStudyMetricEntry 1 } -- -- APM Study Protocol Table -- apmStudyProtocolTable OBJECT-TYPE SYNTAX SEQUENCE OF ApmStudyProtocolEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains one row for each protocol supported by the specified APM Study Class, and should be populated during system initialization. This is an indication of the protocols the indicated APM Study Class is capable of measuring. The actual protocols present in a given APM Study may be a subset of the protocols identified in this table. This table contain entries which reference any protocol in the protocolDirTable. If the index of this entry identifies an internal node in the protocolDirTable, then the apmStudyProtocolIsSubtree object is relevant." ::= { apmCaps 4 } apmStudyProtocolEntry OBJECT-TYPE SYNTAX ApmStudyProtocolEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Protocol information about a particular APM Study." INDEX { apmStudyClassID, protocolDirLocalIndex } ::= { apmStudyProtocolTable 1 } ApmStudyProtocolEntry ::= SEQUENCE { apmStudyProtocolIsSubtree TruthValue } apmStudyProtocolIsSubtree OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates whether or not this entry identifies one node or an entire subtree of the protocolDirTable. If set to 'true(1)' then the specified protocolDirEntry, and all its children, are supported by the specified APM Study Class. If set to 'false(2)', then only the specified protocolDirEntry is supported by this APM Study Class." ::= { apmStudyProtocolEntry 1 } -- placeholder apmCapsNotifications OBJECT IDENTIFIER ::= { apmCapsMIB 2 } -- conformance information apmCapsConformance OBJECT IDENTIFIER ::= { apmCapsMIB 3 } apmCapsCompliances OBJECT IDENTIFIER ::= { apmCapsConformance 1 } apmCapsGroups OBJECT IDENTIFIER ::= { apmCapsConformance 2 } -- compliance statements apmCapsCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMP entities which implement version 1 of the APM Capabilities MIB." MODULE -- this module MANDATORY-GROUPS { protocolDirectoryGroup, apmCapsGroup } ::= { apmCapsCompliances 1 } -- MIB groupings apmCapsGroup OBJECT-GROUP OBJECTS { apmMetricType, apmMetricDirType, apmMetricIsStandard, apmMetricName, apmMetricReference, apmStudyClassCollectType, apmStudyClassCollectPts, apmStudyClassCollectCaps, apmStudyClassOutputCaps, apmStudyClassCtlMibPtr, apmStudyClassCtlTablePtr, apmStudyMetricID, apmStudyProtocolIsSubtree } STATUS current DESCRIPTION "The collection of objects which are used to represent application performance measurement capabilities, for which a single agent provides management information." ::= { apmCapsGroups 1 } END -- -- Copyright (C) The Internet Society (2000). All Rights Reserved. -- -- This document and translations of it may be copied and furnished to -- others, and derivative works that comment on or otherwise explain it or -- assist in its implementation may be prepared, copied, published and -- distributed, in whole or in part, without restriction of any kind, -- provided that the above copyright notice and this paragraph are included -- on all such copies and derivative works. However, this document itself -- may not be modified in any way, such as by removing the copyright notice -- or references to the Internet Society or other Internet organizations, -- except as needed for the purpose of developing Internet standards in -- which case the procedures for copyrights defined in the Internet -- Standards process must be followed, or as required to translate it into -- languages other than English. -- -- The limited permissions granted above are perpetual and will not be -- revoked by the Internet Society or its successors or assigns. -- -- This document and the information contained herein is provided on an "AS -- IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK -- FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT -- LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT -- INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR -- FITNESS FOR A PARTICULAR PURPOSE.