Internet Draft Andy Bierman
Cisco Systems, Inc.
11 June
27 August 1999
Remote Monitoring MIB Extensions for
Differentiated Services Enabled Networks
<draft-bierman-dsmon-mib-01.txt>
<draft-bierman-dsmon-mib-02.txt>
Status of this Memo
This document is an Internet-Draft and is in full conformance with all
provisions of Section 10 of RFC2026 [RFC2026].
Internet-Drafts are working documents of the Internet Engineering Task
Force (IETF), its areas, and its working groups. Note that other groups
may also distribute working documents as Internet-Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet- Drafts as reference material
or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.
Distribution of this document is unlimited. Please send comments to the
author, <abierman@cisco.com>.
1. Copyright Notice
Copyright (C) The Internet Society (1999). All Rights Reserved.
2. Abstract
This memo defines an experimental portion of the Management Information
Base (MIB) for use with network management protocols in the Internet
community. In particular, it describes managed objects used for
monitoring Differentiated Services Codepoint usage in IP packets,
utilizing the monitoring framework defined in the RMON-2 MIB [RFC2021].
3. Table of Contents
1 Copyright Notice ................................................ 1
2 Abstract ........................................................ 2
3 Table of Contents ............................................... 2
4 The SNMP Network Management Framework ........................... 2
5 Overview ........................................................ 3
5.1 Terms ......................................................... 4
5.2 Relationship to Differentiated Services ....................... 4
5.3 Relationship to the Remote Monitoring MIBs .................... 5
5.4 MIB Structure ................................................. 6
5.4.1 DS Statistics Group ......................................... 7
5.4.2 DS Protocol Distribution Group .............................. 7
5.4.3 DS Host Distribution Group .................................. 8
6 Definitions ..................................................... 9
7 Intellectual Property ........................................... 59
8 Acknowledgements ................................................ 59 60
9 References ...................................................... 59 60
10 Security Considerations ........................................ 62 63
11 Author's Address ............................................... 63 64
12 Full Copyright Statement ....................................... 63 64
4. The SNMP Network Management Framework
The SNMP Management Framework presently consists of five major
components:
o An overall architecture, described in RFC 2571 [RFC2571].
o Mechanisms for describing and naming objects and events for the
purpose of management. The first version of this Structure of
Management Information (SMI) is called SMIv1 and described in
RFC 1155 [RFC1155], RFC 1212 [RFC1212] and RFC 1215 [RFC1215].
The second version, called SMIv2, is described in RFC 2578
[RFC2578], RFC 2579 [RFC2579] and RFC 2580 [RFC2580].
o Message protocols for transferring management information. The
first version of the SNMP message protocol is called SNMPv1 and
described in RFC 1157 [RFC1157]. A second version of the SNMP
message protocol, which is not an Internet standards track
protocol, is called SNMPv2c and described in RFC 1901 [RFC1901]
and RFC 1906 [RFC1906]. The third version of the message
protocol is called SNMPv3 and described in RFC 1906 [RFC1906],
RFC 2572 [RFC2572] and RFC 2574 [RFC2574].
o Protocol operations for accessing management information. The
first set of protocol operations and associated PDU formats is
described in RFC 1157 [RFC1157]. A second set of protocol
operations and associated PDU formats is described in RFC 1905
[RFC1905].
o A set of fundamental applications described in RFC 2573
[RFC2573] and the view-based access control mechanism described
in RFC 2575 [RFC2575].
A more detailed introduction to the current SNMP Management Framework
can be found in RFC 2570 [RFC2570].
Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. Objects in the MIB are
defined using the mechanisms defined in the SMI.
This memo specifies a MIB module that is compliant to the SMIv2. A
MIB conforming to the SMIv1 can be produced through the appropriate
translations. The resulting translated MIB must be semantically
equivalent, except where objects or events are omitted because no
translation is possible (use of Counter64). Some machine readable
information in SMIv2 will be converted into textual descriptions in
SMIv1 during the translation process. However, this loss of machine
readable information is not considered to change the semantics of the
MIB.
5. Overview
There is a need for a standardized way of monitoring the network traffic
usage of Differentiated Services (DS) [RFC2474] codepoint values. Each
DS codepoint (DSCP) value may be given a different preference by a
forwarding device, and this affects which packets get dropped or delayed
during periods of network congestion.
The IETF DIFFSERV working group has redefined the semantics of the Type
of Service (TOS) octet in the IP header, which is now called the 'DS
field'. The 6-bit Codepoint (DSCP) portion is contained in the DS field,
which provides for 64 different packet treatments for the implementation
of differentiated network services. The actual packet treatment, or per-
hop behavior (PHB), applied by a forwarding device, is independent of a
particular DSCP value.
By polling DSCP usage counters, an NMS can determine the network
throughput for traffic associated with different DSCPs. This data can
then be analyzed in order to 'tune' DSCP 'allocations' within a network,
based on the Quality of Service (QoS) policies for that network.
5.1. Terms
This document uses some terms that need introduction:
DataSource
A source of data for monitoring purposes. This term is used exactly
as defined in the RMON-2 MIB [RFC2021].
protocol
A specific protocol encapsulation, as identified for monitoring
purposes. This term is used exactly as defined in the RMON
Protocol Identifiers document [RFC2074].
5.2. Relationship to Differentiated Services
The DS-MON MIB focuses only on the DSCP values used in IP packets on a
monitored dataSource. The per-hop behavior (PHB) associated with each
DSCP may be different at each DS-capable forwarding device in the
network.
This MIB does not address the following Differentiated Services issues
in any way:
- configuration and characterization of each PHB in each device
- identification of the mapping between DSCPs and PHBs in each device
- identification of DS capabilities of each forwarding device
- characterization of DSCP values or PHBs, as they relate to standard
or proprietary QoS policy and deployment strategy.
It is expected that such a MIB (targeted for DS-capable forwarding
devices) will be developed by the DIFFSERV working group to address
these issues.
It is also desirable to keep the monitoring of DSCP usage independent of
the DS forwarding devices, in order to keep probe placement more
flexible, which, in turn, enables better statistics aggregation by the
probe.
This document assumes the reader is somewhat familiar with the DS
Architecture [RFC2475], but the DS-MON MIB addresses only the aspects of
monitoring DSCP usage, and therefore is completely decoupled from the
larger issues of network-wide DS configuration and performance analysis.
It is expected that complex NMS applications will use the counters in
this MIB to help analyze DS-related throughput. It is expected that
other metrics, such as delay and jitter, will also be analyzed, but
support for other metrics is outside the scope of this document.
5.3. Relationship to the Remote Monitoring MIBs
This MIB is intended to be implemented in Remote Monitoring (RMON)
probes, which implement the RMON-2 MIB [RFC2021]. Such probes may be
stand-alone devices, or may not be co-located with other networking
devices (e.g., ethernet switches and repeaters).
The DS-MON probe must be capable of parsing the DS field in IP packets
and correlating the embedded DSCP value with other statistics, as
defined in the DS-MON MIB. The DS-MON functions are intended to be
implemented in conjunction with the associated RMON functions, but the
MIB is independent of all other RMON data tables. For example, an agent
might wish to implement the RMON-2 protocol distribution group and the
DS-MON protocol distribution group, in order to provide the fine
granularity, 'per DSCP' statistics with the DS-MON MIB, and the 'grand
total' statistics with the RMON-2 MIB.
Several concepts and even MIB objects from the RMON MIBs are used in the
DS-MON MIB:
DataSource
This textual convention is used to describe the identification of
an RMON monitoring source (defined in the RMON-2 MIB [RFC2021]).
The DataSource textual convention is used throughout the DS-MON MIB
to identify the monitoring source for each configured collection.
A DataSource MIB object is an OBJECT IDENTIFIER, which contains the
particular instance of the ifIndex object associated with the
monitored dataSource.
Protocol Directory
The RMON-2 MIB [RFC2021] defines the protocolDirTable, which is a
directory of all the protocols that the RMON-2 agent is capable of
decoding and counting. The DS-MON MIB utilizes this directory to
identify the protocols detected in monitored packets.
TimeFilter
The RMON-2 TimeFilter textual convention provides a mechanism to
retrieve only rows which have been created or modified since the
last polling interval (for a particular NMS). The DS-MON MIB uses
this textual convention in the large data tables, in order to
minimize polling impact.
Zero-Based Counters
Since counters are instantiated by management action, as in the
RMON MIBs, the DS-MON MIB uses zero-based counters in all data
collection tables. Specifically, the ZeroBasedCounter32 textual
convention from the RMON-2 MIB [RFC2021] and the ZeroBasedCounter64
textual convention (defined in the HC-RMON MIB [HC-RMON]) are used
to define counter objects in this MIB.
High Capacity Counters
The DS-MON MIB uses the same 'SNMPv1 coexistence' strategy as the
RMONMIB WG. That is, where a 64-bit counter is provided, a 32-bit
version of the counter, and a 32-bit overflow counter are also
provided.
TopN Reports
The DS-MON MIB uses the same TopN reporting MIB structure as the
RMON-2 MIB [RFC2021]. TopN reporting can greatly reduce the polling
overhead required to analyze DSCP usage patterns.
5.4. MIB Structure
The DS-MON MIB contains three groups of MIB objects:
- dsStatObjects dsmonStatsObjects group
Report DSCP distribution statistics for a particular RMON
dataSource.
- dsPdistObjects dsmonPdistObjects group
Report DSCP distribution statistics for each protocol detected on a
particular RMON dataSource.
- dsHostObjects dsmonHostObjects group
Report IP host address distribution statistics for each DSCP,
detected on a particular RMON dataSource.
5.4.1. DS Statistics Group
This group contains two tables, the dsStatsControlTable dsmonStatsControlTable and the
dsStatsTable,
dsmonStatsTable, and supports DSCP distribution statistics for half and
full-duplex, low and high speed interfaces. Packet and octets
distributions (by DSCP) are maintained in the dsStatsTable dsmonStatsTable for each
active control row in the dsStatsControlTable. dsmonStatsControlTable.
This group provides the lowest statistics granularity in the DS-MON MIB.
It is expected than NMS applications will analyze certain DS deployment
or performance problems by first examining the DSCP distribution for an
entire interface with this group.
5.4.2. DS Protocol Distribution Group
This group contains two tables for statistics collection,
(dsPdistControlTable
(dsmonPdistControlTable and dsPdistStatsTable), dsmonPdistStatsTable), and two tables for a
'Top N' reporting function for the collected statistics
(dsPdistTopNControlTable
(dsmonPdistTopNControlTable and dsPdistTopNTable). dsmonPdistTopNTable).
The dsPdistControlTable dsmonPdistControlTable and dsPdistStatsTable dsmonPdistStatsTable tables provide DSCP
distribution statistics for each selected protocol encapsulation in
packets monitored on a particular dataSource. Packet and octets
distributions (per protocol per DSCP) are maintained in the
dsPdistStatsTable
dsmonPdistStatsTable for each active control row in the
dsPdistControlTable.
dsmonPdistControlTable.
Due the potentially large number of entries, the DS Protocol
Distribution is different from the RMON-2 protocol distribution group in
several ways:
- maximum desired entries parameter added to the control table
- inserts and deletes counters added to the control table
- support for LRU garbage collection in the dsPdistStatsTable dsmonPdistStatsTable
- TimeFilter index added to the dsPdistStatsTable dsmonPdistStatsTable
- the selection of protocols to count by a special 'collect mode'
enumeration. is not configurable. Rather than select
individual protocols to monitor, (e.g., via a 'supportedOn/Off'
extension to the protocolDirTable [RFC 2021]), a simplified
configuration mechanism is provided. Since DSCP usage statistics
are most interesting at the network and application
layers, the dsPdistControlCollectMode object selects protocols by
network layer, the
dsmonPdistStatsTable is 'hardwired' to select only application layer, or both.
layer (i.e., 'terminal') protocols for statistical analysis.
The TopN feature requires two additional tables: the
dsPdistTopNControlTable
dsmonPdistTopNControlTable and the dsPdistTopNTable, dsmonPdistTopNTable, and supports
periodic usage reporting for the statistics maintained in the dsPdistStatsTable.
dsmonPdistStatsTable. This feature allows for simple periodic retrieval
of the most used
protocol/DSCP application/DSCP combinations.
5.4.3. DS Host Distribution Group
This group contains two tables for statistics collection,
(dsHostControlTable
(dsmonHostControlTable and dsHostTable), dsmonHostTable), and two tables for a 'Top N'
reporting function for the collected statistics (dsHostTopNControlTable
(dsmonHostTopNControlTable and dsHostTopNTable). dsmonHostTopNTable).
The dsHostControlTable dsmonHostControlTable and dsHostTables dsmonHostTables provide IP host
distribution statistics for each DSCP detected in packets monitored on a
particular dataSource.
It is expected than NMS applications will analyze certain DS deployment
or performance problems by first determining the high priority DSCP
values to examine (beyond the scope of this document) and then examining
the dsHostTable dsmonHostTable statistics to determine which IP hosts are using the
selected DSCP(s).
Packet and octets distributions (in and out, per DSCP per IP host) are
maintained in the dsHostTable dsmonHostTable for each active control row in the
dsHostControlTable.
dsmonHostControlTable.
The DS Host Distribution is different from the RMON-2 network layer host
group in two ways:
- there is no protocolDirLocalIndex in the dsHostTable dsmonHostTable INDEX,
since only IPv4 and IPv6 packets contain a DS field, the protocol
(IPv4 or IPv6) is determined by the length of each dsHostAddress dsmonHostAddress
instance.
- the dsHostControlTable dsmonHostControlTable supports limited IPv4 subnet aggregation
by allowing the number of 'monitored address bits' in each address
to be configured for each collection. The agent will zero out the
selected number of rightmost IPv4 address bits for counting
purposes. This configuration parameter can dramatically reduce the
number of entries which must be maintained by the agent, which
should reduce CPU and memory resource requirements on the agent,
and reduce polling overhead on the network and the management
station.
The TopN feature requires two additional tables: the
dsHostTopNControlTable
dsmonHostTopNControlTable and the dsHostTopNTable. dsmonHostTopNTable. and supports
periodic usage reporting for the statistics maintained in the dsHostTable.
dsmonHostTable. This feature allows for simple periodic retrieval of
the most used IP-
host/DSCP IP-host/DSCP combinations.
6. Definitions
-- RMON-2 Extensions for the Monitoring of Differentiated Services
-- Enabled Networks
--
-- IP DIFFSERV DSCP statistics
-- * Per DSCP
-- * Per Protocol Per DSCP
-- * Per DSCP Per IP Host Address
--
--
DSMON-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, Integer32,
Counter32, Gauge32, Counter64, experimental
FROM SNMPv2-SMI
MODULE-COMPLIANCE, OBJECT-GROUP
FROM SNMPv2-CONF
RowStatus, TimeStamp, TEXTUAL-CONVENTION
FROM SNMPv2-TC
OwnerString
FROM IF-MIB
protocolDirLocalIndex, LastCreateTime,
DataSource, ZeroBasedCounter32, TimeFilter
FROM RMON2-MIB
ZeroBasedCounter64
FROM HC-RMON-MIB;
dsMonMIB
dsmonMIB MODULE-IDENTITY
LAST-UPDATED "9906100000Z" "9908260000Z"
ORGANIZATION "Cisco Systems, Inc."
CONTACT-INFO
" Andy Bierman
Cisco Systems, Inc.
Postal: 170 West Tasman Drive
San Jose, CA USA 95134
Tel: +1 408 527-3711
E-mail: abierman@cisco.com"
DESCRIPTION
"This module defines Remote Monitoring MIB extensions for
Differentiated Services enabled networks."
::= { experimental 999999 }
dsMonObjects
dsmonObjects OBJECT IDENTIFIER ::= { dsMonMIB dsmonMIB 1 }
dsMonNotifications
dsmonNotifications OBJECT IDENTIFIER ::= { dsMonMIB dsmonMIB 2 }
dsMonConformance
dsmonConformance OBJECT IDENTIFIER ::= { dsMonMIB dsmonMIB 3 }
dsStatObjects
dsmonStatsObjects OBJECT IDENTIFIER ::= { dsMonObjects dsmonObjects 1 }
dsPdistObjects
dsmonPdistObjects OBJECT IDENTIFIER ::= { dsMonObjects dsmonObjects 2 }
dsHostObjects
dsmonHostObjects OBJECT IDENTIFIER ::= { dsMonObjects dsmonObjects 3 }
--
-- Extensions to the RMON-2 MIB for Differentiated Services
-- Monitoring
--
-- In order to maintain the RMON 'look-and-feel', some of
-- the text from the RMON-2 and HC-RMON MIBs by
-- Steve Waldbusser have has been used in this MIB.
--
--
-- Textual Convention to define a DSCP for
-- monitoring purposes
--
DSCodePoint ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"This TC describes an object which identifies the
Differentiated Services Codepoint (DSCP) value in an IPv4 or
IPv6 packet header."
REFERENCE
"Definition of the Differentiated Services Field (DS Field)
in the IPv4 and IPv6 Headers [RFC2474]."
SYNTAX Integer32 (0..63)
-- ***********************************************************
-- * *
-- * P E R - D A T A S O U C E C O L L E C T I O N S *
-- * *
-- ***********************************************************
--
-- DSCP Per-DataSource Statistics Control Table
--
dsStatsControlTable
dsmonStatsControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsStatsControlEntry DsmonStatsControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Controls the setup of per-data source per-DSCP distribution
statistics."
::= { dsStatObjects dsmonStatsObjects 1 }
dsStatsControlEntry
dsmonStatsControlEntry OBJECT-TYPE
SYNTAX DsStatsControlEntry DsmonStatsControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row in the dsStatsControlTable. dsmonStatsControlTable.
Entries are created and deleted from this table by
management action only, using the dsStatsControlStatus dsmonStatsControlStatus
RowStatus object.
Activation of a control row in this table will cause an
associated dsStatsTable dsmonStatsTable to be created and maintained by
the agent."
INDEX { dsStatsControlIndex dsmonStatsControlIndex }
::= { dsStatsControlTable dsmonStatsControlTable 1 }
DsStatsControlEntry
DsmonStatsControlEntry ::= SEQUENCE {
dsStatsControlIndex
dsmonStatsControlIndex Integer32,
dsStatsControlDataSource
dsmonStatsControlDataSource DataSource,
dsStatsControlDroppedFrames
dsmonStatsControlDroppedFrames Counter32,
dsStatsControlCreateTime
dsmonStatsControlCreateTime LastCreateTime,
dsStatsControlOwner
dsmonStatsControlOwner OwnerString,
dsStatsControlStatus
dsmonStatsControlStatus RowStatus
}
dsStatsControlIndex
dsmonStatsControlIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An arbitrary and unique index for this
dsStatsControlEntry."
dsmonStatsControlEntry."
::= { dsStatsControlEntry dsmonStatsControlEntry 1 }
dsStatsControlDataSource
dsmonStatsControlDataSource OBJECT-TYPE
SYNTAX DataSource
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The source of data for the this per-protocol DSCP
distribution.
The statistics in this group reflect all IPv4 and IPv6
packets on the local network segment attached to the
identified interface.
This object may not be modified if the associated
dsStatsControlStatus
dsmonStatsControlStatus object is equal to active(1)."
::= { dsStatsControlEntry dsmonStatsControlEntry 2 }
dsStatsControlDroppedFrames
dsmonStatsControlDroppedFrames OBJECT-TYPE
SYNTAX Counter32
UNITS "frames"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of frames which were received by the probe
and therefore not accounted for in the *StatsDropEvents, but
for which the probe chose not to count for this entry for
whatever reason. Most often, this event occurs when the
probe is out of some resources and decides to shed load from
this collection.
This count does not include packets that were not counted
because they had MAC-layer errors.
Note that, unlike the dropEvents counter, this number is the
exact number of frames dropped."
::= { dsStatsControlEntry dsmonStatsControlEntry 3 }
dsStatsControlCreateTime
dsmonStatsControlCreateTime OBJECT-TYPE
SYNTAX LastCreateTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime when this control entry was last
activated. This can be used by the management station to
ensure that
detect if the table has not been deleted and recreated between
polls."
::= { dsStatsControlEntry dsmonStatsControlEntry 4 }
dsStatsControlOwner
dsmonStatsControlOwner OBJECT-TYPE
SYNTAX OwnerString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The entity that configured this entry and is therefore
using the resources assigned to it."
::= { dsStatsControlEntry dsmonStatsControlEntry 5 }
dsStatsControlStatus
dsmonStatsControlStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row.
An entry may not exist in the active state unless all
objects in the entry have an appropriate value.
If this object is not equal to active(1), all associated
entries in the dsStatsTable dsmonStatsTable shall be deleted."
::= { dsStatsControlEntry dsmonStatsControlEntry 6 }
--
-- DSCP Per-DataSource Statistics Table
--
dsStatsTable
dsmonStatsTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsStatsEntry DsmonStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A list of information on Per Protocol DSCP usage.
The following table defines per-DSCP statistics for full
and/or half-duplex links as well as high capacity links.
For half-duplex links, or full-duplex-capable links
operating in half-duplex mode, the dsStatsIn* dsmonStatsIn* objects
shall be used and the dsStatsOut* dsmonStatsOut* objects will not
increment.
For full-duplex links, the dsOut* dsmonStatsOut* objects will be
present. Whenever possible, the probe should count packets
moving away from the closest terminating equipment as output
packets. Failing that, the probe should count packets moving
away from the DTE as output packets."
::= { dsStatObjects dsmonStatsObjects 2 }
dsStatsEntry
dsmonStatsEntry OBJECT-TYPE
SYNTAX DsStatsEntry DsmonStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A list of information on Differentiated Services DSCP
usage, containing inbound and outbound packet and octet
counters for each DSCP configured for collection.
The dsStatsControlIndex dsmonStatsControlIndex value in the index identifies the
dsStatsControlEntry
dsmonStatsControlEntry on whose behalf this entry was
created.
Only entries with non-zero statistics will be returned by
the agent, in order to reduce the amount of polling required
to retrieve data from this table. That is, an entry will be
created when a packet with the indicated DSCP value is
detected by the agent.
Note that only protocols which are encapsulated in IPv4 or
IPv6 packets will be counted in this table.
An example of the indexing of this entry is
dsStatsOutPkts.1.16"
dsmonStatsOutPkts.1.16"
INDEX { dsStatsControlIndex, dsStatsDsCodept dsmonStatsControlIndex, dsmonStatsDsCodept }
::= { dsStatsTable dsmonStatsTable 1 }
DsStatsEntry
DsmonStatsEntry ::= SEQUENCE {
dsStatsDsCodept
dsmonStatsDsCodept DSCodePoint,
dsStatsInPkts
dsmonStatsInPkts ZeroBasedCounter32,
dsStatsInOctets
dsmonStatsInOctets ZeroBasedCounter32,
dsStatsInOvflPkts
dsmonStatsInOvflPkts ZeroBasedCounter32,
dsStatsInOvflOctets
dsmonStatsInOvflOctets ZeroBasedCounter32,
dsStatsInHCPkts
dsmonStatsInHCPkts ZeroBasedCounter64,
dsStatsInHCOctets
dsmonStatsInHCOctets ZeroBasedCounter64,
dsStatsOutPkts
dsmonStatsOutPkts ZeroBasedCounter32,
dsStatsOutOctets
dsmonStatsOutOctets ZeroBasedCounter32,
dsStatsOutOvflPkts
dsmonStatsOutOvflPkts ZeroBasedCounter32,
dsStatsOutOvflOctets
dsmonStatsOutOvflOctets ZeroBasedCounter32,
dsStatsOutHCPkts
dsmonStatsOutHCPkts ZeroBasedCounter64,
dsStatsOutHCOctets
dsmonStatsOutHCOctets ZeroBasedCounter64
}
dsStatsDsCodept
dsmonStatsDsCodept OBJECT-TYPE
SYNTAX DSCodePoint
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The DSCP value associated with the aggregated statistics
for a particular data source."
::= { dsStatsEntry dsmonStatsEntry 1 }
dsStatsInPkts
dsmonStatsInPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of packets using a particular DSCP value,
received on a half-duplex link or on the inbound connection
of a full-duplex link."
::= { dsStatsEntry dsmonStatsEntry 2 }
dsStatsInOctets
dsmonStatsInOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of octets in packets, using a particular DSCP
value, received on a half-duplex link or on the inbound
connection of a full-duplex link."
::= { dsStatsEntry dsmonStatsEntry 3 }
dsStatsInOvflPkts
dsmonStatsInOvflPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated dsStatsInPkts dsmonStatsInPkts counter
has overflowed. Note that this object will only be
instantiated if the associated dsStatsInHCPkts dsmonStatsInHCPkts object is
also instantiated for a particular dataSource."
::= { dsStatsEntry dsmonStatsEntry 4 }
dsStatsInOvflOctets
dsmonStatsInOvflOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated dsStatsInOctets dsmonStatsInOctets
counter has overflowed. Note that this object will only be
instantiated if the associated dsStatsInHCOctets dsmonStatsInHCOctets object
is also instantiated for a particular dataSource."
::= { dsStatsEntry dsmonStatsEntry 5 }
dsStatsInHCPkts
dsmonStatsInHCPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter64
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The 64-bit version of the dsStatsInPkts dsmonStatsInPkts object.
Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular
dataSource."
::= { dsStatsEntry dsmonStatsEntry 6 }
dsStatsInHCOctets
dsmonStatsInHCOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter64
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The 64-bit version of the dsStatsInOctets dsmonStatsInOctets object.
Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular
dataSource."
::= { dsStatsEntry dsmonStatsEntry 7 }
dsStatsOutPkts
dsmonStatsOutPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of packets using a particular DSCP value,
received on a full-duplex link in the direction of the
network."
::= { dsStatsEntry dsmonStatsEntry 8 }
dsStatsOutOctets
dsmonStatsOutOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of octets in packets, using a particular DSCP
value, received on a full-duplex link in the direction of
the network."
::= { dsStatsEntry dsmonStatsEntry 9 }
dsStatsOutOvflPkts
dsmonStatsOutOvflPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated dsStatsOutPkts dsmonStatsOutPkts
counter has overflowed. Note that this object will only be
instantiated if the associated dsStatsOutHCPkts dsmonStatsOutHCPkts object is
also instantiated for a particular dataSource."
::= { dsStatsEntry dsmonStatsEntry 10 }
dsStatsOutOvflOctets
dsmonStatsOutOvflOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated dsStatsOutOctets dsmonStatsOutOctets
counter has overflowed. Note that this object will only be
instantiated if the associated dsStatsOutHCOctets dsmonStatsOutHCOctets object
is also instantiated for a particular dataSource."
::= { dsStatsEntry dsmonStatsEntry 11 }
dsStatsOutHCPkts
dsmonStatsOutHCPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter64
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The 64-bit version of the dsStatsOutPkts dsmonStatsOutPkts object.
Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular
dataSource."
::= { dsStatsEntry dsmonStatsEntry 12 }
dsStatsOutHCOctets
dsmonStatsOutHCOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter64
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The 64-bit version of the dsStatsOutOctets dsmonStatsOutOctets object.
Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular
dataSource."
::= { dsStatsEntry dsmonStatsEntry 13 }
-- ***********************************************************
-- * *
-- * P E R - P R O T O C O L C O L L E C T I O N S *
-- * *
-- ***********************************************************
--
-- DSCP Per-Protocol Statistics Control Table
--
dsPdistControlTable
dsmonPdistControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsPdistControlEntry DsmonPdistControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Controls the setup of per-protocol per-application per-DSCP distribution
statistics."
::= { dsPdistObjects dsmonPdistObjects 1 }
dsPdistControlEntry
dsmonPdistControlEntry OBJECT-TYPE
SYNTAX DsPdistControlEntry DsmonPdistControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row in the dsPdistControlTable. dsmonPdistControlTable.
Entries are created and deleted from this table by
management action only, using the dsPdistControlStatus dsmonPdistControlStatus
RowStatus object.
Activation of a control row in this table will cause an
associated dsPdistStatsTable dsmonPdistStatsTable to be created and maintained
by the agent."
INDEX { dsPdistControlIndex dsmonPdistControlIndex }
::= { dsPdistControlTable dsmonPdistControlTable 1 }
DsPdistControlEntry
DsmonPdistControlEntry ::= SEQUENCE {
dsPdistControlIndex
dsmonPdistControlIndex Integer32,
dsPdistControlDataSource
dsmonPdistControlDataSource DataSource,
dsPdistControlMaxDesiredEntries
dsmonPdistControlMaxDesiredEntries Integer32,
dsPdistControlCollectMode INTEGER,
dsPdistControlDroppedFrames
dsmonPdistControlDroppedFrames Counter32,
dsPdistControlInserts
dsmonPdistControlInserts Counter32,
dsPdistControlDeletes
dsmonPdistControlDeletes Counter32,
dsPdistControlCreateTime
dsmonPdistControlCreateTime LastCreateTime,
dsPdistControlOwner
dsmonPdistControlOwner OwnerString,
dsPdistControlStatus
dsmonPdistControlStatus RowStatus
}
dsPdistControlIndex
dsmonPdistControlIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An arbitrary and unique index for this
dsPdistControlEntry."
dsmonPdistControlEntry."
::= { dsPdistControlEntry dsmonPdistControlEntry 1 }
dsPdistControlDataSource
dsmonPdistControlDataSource OBJECT-TYPE
SYNTAX DataSource
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The source of data for the this per-protocol DSCP
distribution.
The statistics in this group reflect all IPv4 and IPv6
packets on the local network segment attached to the
identified interface.
This object may not be modified if the associated
dsPdistControlStatus
dsmonPdistControlStatus object is equal to active(1)."
::= { dsPdistControlEntry dsmonPdistControlEntry 2 }
dsPdistControlMaxDesiredEntries
dsmonPdistControlMaxDesiredEntries OBJECT-TYPE
SYNTAX Integer32 (-1 | 1..2147483647)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The maximum number of entries that are desired in the
dsPdistStatsTable
dsmonPdistStatsTable on behalf of this control entry. The
probe will not create more than this number of associated
entries in the table, but may choose to create fewer entries
in this table for any reason including the lack of
resources.
If this value is set to -1, the probe may create any number
of entries in this table.
This object may not be modified if the associated
dsPdistControlStatus
dsmonPdistControlStatus object is equal to active(1)."
::= { dsPdistControlEntry dsmonPdistControlEntry 3 }
dsPdistControlCollectMode OBJECT-TYPE
SYNTAX INTEGER {
netLayer(1), -- count L3 protocols
appLayer(2), -- count application protocols
netAndAppLayers(3) -- count L3 and app protocols
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The packet layer(s) at which the agent should process DSCP
information, for each monitored packet.
If this object has a value of 'netLayer(1)', then the agent
will include only network layer protocols in the associated
dsPdistStatsTable.
If this object has a value of 'appLayer(2)', then the agent
will include only application layer protocols in the
associated dsPdistStatsTable. Any 'terminal' protocol is
considered to be an application protocol.
If this object has a value of 'netAndAppLayers(3)', then the
agent will include only network and application layer
protocols in the associated dsPdistStatsTable. Note that
entries for transport layer protocols (e.g., TCP) will not
be created by the agent, even if detected by the agent.
This object may not be modified if the associated
dsPdistControlStatus object is equal to active(1)."
::= { dsPdistControlEntry 4 }
dsPdistControlDroppedFrames
dsmonPdistControlDroppedFrames OBJECT-TYPE
SYNTAX Counter32
UNITS "frames"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of frames which were received by the probe
and therefore not accounted for in the *StatsDropEvents, but
for which the probe chose not to count for this entry for
whatever reason. Most often, this event occurs when the
probe is out of some resources and decides to shed load from
this collection.
This count does not include packets that were not counted
because they had MAC-layer errors.
Note that, unlike the dropEvents counter, this number is the
exact number of frames dropped."
::= { dsPdistControlEntry 5 dsmonPdistControlEntry 4 }
dsPdistControlInserts
dsmonPdistControlInserts OBJECT-TYPE
SYNTAX Counter32
UNITS "table entries"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times a dsPdist dsmonPdist entry has been inserted
into the dsPdistTable. dsmonPdistTable. If an entry is inserted, then
deleted, and then inserted, this counter will be incremented
by 2.
To allow for efficient implementation strategies, agents may
delay updating this object for short periods of time. For
example, an implementation strategy may allow internal data
structures to differ from those visible via SNMP for short
periods of time. This counter may reflect the internal data
structures for those short periods of time.
Note that the table size can be determined by subtracting
dsPdistControlDeletes
dsmonPdistControlDeletes from dsPdistControlInserts." dsmonPdistControlInserts."
::= { dsPdistControlEntry 6 dsmonPdistControlEntry 5 }
dsPdistControlDeletes
dsmonPdistControlDeletes OBJECT-TYPE
SYNTAX Counter32
UNITS "table entries"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times a dsPdist dsmonPdist entry has been deleted
from the dsPdist dsmonPdist table (for any reason). If an entry is
deleted, then inserted, and then deleted, this counter will
be incremented by 2.
To allow for efficient implementation strategies, agents may
delay updating this object for short periods of time. For
example, an implementation strategy may allow internal data
structures to differ from those visible via SNMP for short
periods of time. This counter may reflect the internal data
structures for those short periods of time.
Note that the table size can be determined by subtracting
dsPdistControlDeletes
dsmonPdistControlDeletes from dsPdistControlInserts." dsmonPdistControlInserts."
::= { dsPdistControlEntry 7 dsmonPdistControlEntry 6 }
dsPdistControlCreateTime
dsmonPdistControlCreateTime OBJECT-TYPE
SYNTAX LastCreateTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime when this control entry was last
activated. This can be used by the management station to
ensure that
detect if the table has not been deleted and recreated between
polls."
::= { dsPdistControlEntry 8 dsmonPdistControlEntry 7 }
dsPdistControlOwner
dsmonPdistControlOwner OBJECT-TYPE
SYNTAX OwnerString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The entity that configured this entry and is therefore
using the resources assigned to it."
::= { dsPdistControlEntry 9 dsmonPdistControlEntry 8 }
dsPdistControlStatus
dsmonPdistControlStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row.
An entry may not exist in the active state unless all
objects in the entry have an appropriate value.
If this object is not equal to active(1), all associated
entries in the dsPdistStatsTable dsmonPdistStatsTable shall be deleted."
::= { dsPdistControlEntry 10 dsmonPdistControlEntry 9 }
--
-- Per-Protocol Statistics Table
--
dsPdistStatsTable
dsmonPdistStatsTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsPdistStatsEntry DsmonPdistStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A list of information on Per Protocol DSCP usage."
::= { dsPdistObjects dsmonPdistObjects 2 }
dsPdistStatsEntry
dsmonPdistStatsEntry OBJECT-TYPE
SYNTAX DsPdistStatsEntry DsmonPdistStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A list of information on Differentiated Services DSCP
usage, containing packet and octet counters for each DSCP
configured for collection, and each protocol (as identified
by the protocolDirLocalIndex for the protocol) identified in
each monitored packet.
The dsPdistControlIndex dsmonPdistControlIndex value in the index identifies the
dsPdistControlEntry
dsmonPdistControlEntry on whose behalf this entry was
created.
Only entries with non-zero statistics will be returned by
the agent, in order to reduce the amount of polling required
to retrieve data from this table. That is, an entry will be
created when a packet of that type and DSCP value is
detected by the agent.
Note that only protocols which are encapsulated in IPv4 or
IPv6 packets will be counted in this table, as indicated by
the protocolDirTable configuration.
The agent will include only application layer protocols in
the associated dsmonPdistStatsTable. Any 'terminal' protocol
is considered to be an application protocol.
An example of the indexing of this entry is
dsPdistStatsPkts.9.29943.42.16."
dsmonPdistStatsPkts.9.29943.42.16."
INDEX { dsPdistControlIndex,
dsPdistTimeMark, dsmonPdistControlIndex,
dsmonPdistTimeMark,
protocolDirLocalIndex,
dsPdistDsCodept
dsmonPdistDsCodept }
::= { dsPdistStatsTable dsmonPdistStatsTable 1 }
DsPdistStatsEntry
DsmonPdistStatsEntry ::= SEQUENCE {
dsPdistTimeMark
dsmonPdistTimeMark TimeFilter,
dsPdistDsCodept
dsmonPdistDsCodept DSCodePoint,
dsPdistStatsPkts
dsmonPdistStatsPkts ZeroBasedCounter32,
dsPdistStatsOctets
dsmonPdistStatsOctets ZeroBasedCounter32,
dsPdistStatsOvflPkts
dsmonPdistStatsOvflPkts ZeroBasedCounter32,
dsPdistStatsOvflOctets
dsmonPdistStatsOvflOctets ZeroBasedCounter32,
dsPdistStatsHCPkts
dsmonPdistStatsHCPkts ZeroBasedCounter64,
dsPdistStatsHCOctets
dsmonPdistStatsHCOctets ZeroBasedCounter64,
dsPdistStatsCreateTime
dsmonPdistStatsCreateTime LastCreateTime
}
dsPdistTimeMark
dsmonPdistTimeMark OBJECT-TYPE
SYNTAX TimeFilter
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The Time Filter index for this table. This object may be
used by a management station to retrieve only rows which
have been created or modified since a particular time. Note
that the current value for a row are always returned and the
TimeFilter is not a historical data archiving mechanism.
Refer to RFC 2021 [RFC2021] for a detailed description of
TimeFilter operation."
::= { dsPdistStatsEntry dsmonPdistStatsEntry 1 }
dsPdistDsCodept
dsmonPdistDsCodept OBJECT-TYPE
SYNTAX DSCodePoint
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The DSCP value associated with the aggregated statistics
for a particular protocol."
::= { dsPdistStatsEntry dsmonPdistStatsEntry 2 }
dsPdistStatsPkts
dsmonPdistStatsPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of packets, monitored by this agent, and
identified to be using a particular DSCP value in the DS
header, on behalf of the protocol identified by the
associated protocolDirLocalIndex value."
::= { dsPdistStatsEntry dsmonPdistStatsEntry 3 }
dsPdistStatsOctets
dsmonPdistStatsOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of octets in packets, monitored by this agent
and identified to be using a particular DSCP value in the DS
header, on behalf of the protocol identified by the
associated protocolDirLocalIndex value.
Note that this object doesn't count just those octets in the
particular protocol frames, but includes the entire packet
that contained the protocol."
::= { dsPdistStatsEntry dsmonPdistStatsEntry 4 }
dsPdistStatsOvflPkts
dsmonPdistStatsOvflPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated dsPdistStatsPkts dsmonPdistStatsPkts
counter has overflowed. Note that this object will only be
instantiated if the associated dsPdistStatsHCPkts dsmonPdistStatsHCPkts object
is also instantiated for a particular dataSource."
::= { dsPdistStatsEntry dsmonPdistStatsEntry 5 }
dsPdistStatsOvflOctets
dsmonPdistStatsOvflOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated dsPdistStatsOctets dsmonPdistStatsOctets
counter has overflowed. Note that this object will only be
instantiated if the associated dsPdistStatsHCOctets dsmonPdistStatsHCOctets
object is also instantiated for a particular dataSource."
::= { dsPdistStatsEntry dsmonPdistStatsEntry 6 }
dsPdistStatsHCPkts
dsmonPdistStatsHCPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter64
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The 64-bit version of the dsPdistStatsPkts dsmonPdistStatsPkts object.
Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular
dataSource."
::= { dsPdistStatsEntry dsmonPdistStatsEntry 7 }
dsPdistStatsHCOctets
dsmonPdistStatsHCOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter64
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The 64-bit version of the dsPdistStatsOctets dsmonPdistStatsOctets object.
Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular
dataSource."
::= { dsPdistStatsEntry dsmonPdistStatsEntry 8 }
dsPdistStatsCreateTime
dsmonPdistStatsCreateTime OBJECT-TYPE
SYNTAX LastCreateTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime when this dsPdistStats dsmonPdistStats entry was
last instantiated by the agent. This can be used by the
management station to ensure that detect if the entry has not been deleted
and recreated between polls."
::= { dsPdistStatsEntry dsmonPdistStatsEntry 9 }
--
-- Per-Protocol Statistics TopN Control Table
--
dsPdistTopNControlTable
dsmonPdistTopNControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsPdistTopNControlEntry DsmonPdistTopNControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A set of parameters that control the creation of a report
of the top N dsPdist dsmonPdist entries according to a selected
metric."
::= { dsPdistObjects dsmonPdistObjects 3 }
dsPdistTopNControlEntry
dsmonPdistTopNControlEntry OBJECT-TYPE
SYNTAX DsPdistTopNControlEntry DsmonPdistTopNControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row in the dsPdistTopNControlTable. dsmonPdistTopNControlTable.
Entries are created and deleted from this table by
management action only, using the dsPdistTopNControlStatus
dsmonPdistTopNControlStatus RowStatus object.
Activation of a control row in this table will cause an
associated dsPdistTopNTable dsmonPdistTopNTable to be created and maintained
by the agent."
INDEX { dsPdistTopNControlIndex dsmonPdistTopNControlIndex }
::= { dsPdistTopNControlTable dsmonPdistTopNControlTable 1 }
DsPdistTopNControlEntry
DsmonPdistTopNControlEntry ::= SEQUENCE {
dsPdistTopNControlIndex
dsmonPdistTopNControlIndex Integer32,
dsPdistTopNControlPdistIndex
dsmonPdistTopNControlPdistIndex Integer32,
dsPdistTopNControlRateBase
dsmonPdistTopNControlRateBase INTEGER,
dsPdistTopNControlTimeRemaining
dsmonPdistTopNControlTimeRemaining Integer32,
dsPdistTopNControlGeneratedReports
dsmonPdistTopNControlGeneratedReports Counter32,
dsPdistTopNControlDuration
dsmonPdistTopNControlDuration Integer32,
dsPdistTopNControlRequestedSize
dsmonPdistTopNControlRequestedSize Integer32,
dsPdistTopNControlGrantedSize
dsmonPdistTopNControlGrantedSize Integer32,
dsPdistTopNControlStartTime
dsmonPdistTopNControlStartTime TimeStamp,
dsPdistTopNControlOwner
dsmonPdistTopNControlOwner OwnerString,
dsPdistTopNControlStatus
dsmonPdistTopNControlStatus RowStatus
}
dsPdistTopNControlIndex
dsmonPdistTopNControlIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An index that uniquely identifies an entry in the
dsPdistTopNControlTable.
dsmonPdistTopNControlTable. Each such entry defines one Top
N report prepared for one RMON dataSource."
::= { dsPdistTopNControlEntry dsmonPdistTopNControlEntry 1 }
dsPdistTopNControlPdistIndex
dsmonPdistTopNControlPdistIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The dsPdistTable dsmonPdistTable for which a top N report will be
prepared on behalf of this entry. The dsPdistTable dsmonPdistTable is
identified by the value of the dsPdistControlIndex dsmonPdistControlIndex for
that table - that value is used here to identify the
particular table.
This object may not be modified if the associated
dsPdistTopNControlStatus
dsmonPdistTopNControlStatus object is equal to active(1)."
::= { dsPdistTopNControlEntry dsmonPdistTopNControlEntry 2 }
dsPdistTopNControlRateBase
dsmonPdistTopNControlRateBase OBJECT-TYPE
SYNTAX INTEGER {
dsPdistTopNPkts(1),
dsPdistTopNOctets(2),
dsPdistTopNHCPkts(3),
dsPdistTopNHCOctets(4)
dsmonPdistTopNPkts(1),
dsmonPdistTopNOctets(2),
dsmonPdistTopNHCPkts(3),
dsmonPdistTopNHCOctets(4)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The variable for each dsPdist dsmonPdist that the dsPdistTopNRate
dsmonPdistTopNRate and
dsPdistTopNHCRate dsmonPdistTopNHCRate variables are
based upon. Each
dsPdistTopN dsmonPdistTopN report generated on behalf
of this control entry will be ranked in descending order,
based on the associated
dsPdistStatsTable dsmonPdistStatsTable counter,
identified by this object.
The following table identifies the dsPdistTable dsmonPdistTable counter
associated with each enumeration:
Enumeration RateBase MIB Object
----------- -------------------
dsPdistTopNPkts dsPdistStatsPkts
dsPdistTopNOctets dsPdistStatsOctets
dsPdistTopNHCPkts dsPdistStatsHCPkts
dsPdistTopNHCOctets dsPdistStatsHCOctets
dsmonPdistTopNPkts dsmonPdistStatsPkts
dsmonPdistTopNOctets dsmonPdistStatsOctets
dsmonPdistTopNHCPkts dsmonPdistStatsHCPkts
dsmonPdistTopNHCOctets dsmonPdistStatsHCOctets
Note that the dsPdistTopNHCPkts dsmonPdistTopNHCPkts and dsPdistTopNHCOctets
dsmonPdistTopNHCOctets enumerations are only available if
the agent supports High Capacity RMON collection.
This object may not be modified if the associated
dsPdistTopNControlStatus
dsmonPdistTopNControlStatus object is equal to active(1)."
::= { dsPdistTopNControlEntry dsmonPdistTopNControlEntry 3 }
dsPdistTopNControlTimeRemaining
dsmonPdistTopNControlTimeRemaining OBJECT-TYPE
SYNTAX Integer32 (0..2147483647)
UNITS "seconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The number of seconds left in the report currently being
collected. When this object is modified by the management
station, a new collection is started, possibly aborting a
currently running report. The new value is used as the
requested duration of this report, and is immediately loaded
into the associated dsPdistTopNControlDuration dsmonPdistTopNControlDuration object.
When the report finishes, the probe will automatically start
another collection with the same initial value of
dsPdistTopNControlTimeRemaining.
dsmonPdistTopNControlTimeRemaining. Thus the management
station may simply read the resulting reports repeatedly,
checking the startTime and duration each time to ensure that
a report was not missed or that the report parameters were
not changed.
While the value of this object is non-zero, it decrements by
one per second until it reaches zero. At the time that this
object decrements to zero, the report is made accessible in
the dsPdistTopNTable, dsmonPdistTopNTable, overwriting any report that may be
there.
When this object is modified by the management station, any
associated entries in the dsPdistTopNTable dsmonPdistTopNTable shall be
deleted."
DEFVAL { 1800 }
::= { dsPdistTopNControlEntry dsmonPdistTopNControlEntry 4 }
dsPdistTopNControlGeneratedReports
dsmonPdistTopNControlGeneratedReports OBJECT-TYPE
SYNTAX Counter32
UNITS "reports"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of reports that have been generated by this
entry."
::= { dsPdistTopNControlEntry dsmonPdistTopNControlEntry 5 }
dsPdistTopNControlDuration
dsmonPdistTopNControlDuration OBJECT-TYPE
SYNTAX Integer32
UNITS "seconds"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of seconds that this report has collected during
the last sampling interval.
When the associated dsPdistTopNControlTimeRemaining dsmonPdistTopNControlTimeRemaining
object is set, this object shall be set by the probe to the
same value and shall not be modified until the next time the
dsPdistTopNControlTimeRemaining
dsmonPdistTopNControlTimeRemaining is set.
This value shall be zero if no reports have been requested
for this dsPdistTopNControlEntry." dsmonPdistTopNControlEntry."
::= { dsPdistTopNControlEntry dsmonPdistTopNControlEntry 6 }
dsPdistTopNControlRequestedSize
dsmonPdistTopNControlRequestedSize OBJECT-TYPE
SYNTAX Integer32 (0..2147483647)
UNITS "table entries"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The maximum number of dsPdist dsmonPdist entries requested for this
report.
When this object is created or modified, the probe should
set dsPdistTopNControlGrantedSize dsmonPdistTopNControlGrantedSize as closely to this
object as is possible for the particular probe
implementation and available resources."
DEFVAL { 150 }
::= { dsPdistTopNControlEntry dsmonPdistTopNControlEntry 7 }
dsPdistTopNControlGrantedSize
dsmonPdistTopNControlGrantedSize OBJECT-TYPE
SYNTAX Integer32 (0..2147483647)
UNITS "table entries"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum number of dsPdist dsmonPdist entries in this report.
When the associated dsPdistTopNControlRequestedSize dsmonPdistTopNControlRequestedSize
object is created or modified, the probe should set this
object as closely to the requested value as is possible for
the particular implementation and available resources. The
probe must not lower this value except as a result of a set
to the associated dsPdistTopNControlRequestedSize dsmonPdistTopNControlRequestedSize object.
When the associated dsPdistTopNControlRequestedSize dsmonPdistTopNControlRequestedSize
object is created or modified, the probe should set this
object as closely to the requested value as is possible for
the particular implementation and available resources. The
probe must not lower this value except as a result of a set
to the associated dsPdistTopNControlRequestedSize dsmonPdistTopNControlRequestedSize object.
Protocol entries with the highest value of dsPdistTopNRate
dsmonPdistTopNRate or dsPdistTopNHCRate dsmonPdistTopNHCRate (depending on the
value of the associated dsPdistTopNControlRateBase dsmonPdistTopNControlRateBase
object) shall be placed in this table in decreasing order of
this rate until there is no more room or until there are no
more dsPdist dsmonPdist entries."
::= { dsPdistTopNControlEntry dsmonPdistTopNControlEntry 8 }
dsPdistTopNControlStartTime
dsmonPdistTopNControlStartTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime when this top N report was last
started. In other words, this is the time that the
associated dsPdistTopNControlTimeRemaining dsmonPdistTopNControlTimeRemaining object was
modified to start the requested report or the time the
report was last automatically (re)started.
This object may be used by the management station to
determine if a report was missed or not."
::= { dsPdistTopNControlEntry dsmonPdistTopNControlEntry 9 }
dsPdistTopNControlOwner
dsmonPdistTopNControlOwner OBJECT-TYPE
SYNTAX OwnerString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The entity that configured this entry and is therefore
using the resources assigned to it."
::= { dsPdistTopNControlEntry dsmonPdistTopNControlEntry 10 }
dsPdistTopNControlStatus
dsmonPdistTopNControlStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this dsPdistTopNControlEntry. dsmonPdistTopNControlEntry.
An entry may not exist in the active state unless all
objects in the entry have an appropriate value.
If this object is not equal to active(1), all associated
entries in the dsPdistTopNTable dsmonPdistTopNTable shall be deleted by the
agent."
::= { dsPdistTopNControlEntry dsmonPdistTopNControlEntry 11 }
--
-- dsPdist dsmonPdist TopN Table
--
dsPdistTopNTable
dsmonPdistTopNTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsPdistTopNEntry DsmonPdistTopNEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A set of statistics for those protocol distribution entries
that have counted the highest number of octets or packets.
Note that dsPdist dsmonPdist entries which did not increment at all
during the report interval are not included in dsPdistTopN
dsmonPdistTopN reports."
::= { dsPdistObjects dsmonPdistObjects 4 }
dsPdistTopNEntry
dsmonPdistTopNEntry OBJECT-TYPE
SYNTAX DsPdistTopNEntry DsmonPdistTopNEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row in the dsPdistTopNTable. dsmonPdistTopNTable.
The dsPdistTopNControlIndex dsmonPdistTopNControlIndex value in the index identifies
the dsPdistTopNControlEntry dsmonPdistTopNControlEntry on whose behalf this entry
was created."
INDEX { dsPdistTopNControlIndex, dsPdistTopNIndex dsmonPdistTopNControlIndex, dsmonPdistTopNIndex }
::= { dsPdistTopNTable dsmonPdistTopNTable 1 }
DsPdistTopNEntry
DsmonPdistTopNEntry ::= SEQUENCE {
dsPdistTopNIndex
dsmonPdistTopNIndex Integer32,
dsPdistTopNProtocolDirLocalIndex
dsmonPdistTopNProtocolDirLocalIndex Integer32,
dsPdistTopNDsCodept
dsmonPdistTopNDsCodept DSCodePoint,
dsPdistTopNRate
dsmonPdistTopNRate Gauge32,
dsPdistTopNRateOvfl
dsmonPdistTopNRateOvfl Gauge32,
dsPdistTopNHCRate
dsmonPdistTopNHCRate Counter64 -- Gauge64
}
dsPdistTopNIndex
dsmonPdistTopNIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An index that uniquely identifies an entry in the
dsPdistTopNTable
dsmonPdistTopNTable among those in the same report. This
index is between 1 and N, where N is the number of entries
in this report."
::= { dsPdistTopNEntry dsmonPdistTopNEntry 1 }
dsPdistTopNProtocolDirLocalIndex
dsmonPdistTopNProtocolDirLocalIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The protocolDirLocalIndex value which identifies the
protocol associated with this entry."
::= { dsPdistTopNEntry dsmonPdistTopNEntry 2 }
dsPdistTopNDsCodept
dsmonPdistTopNDsCodept OBJECT-TYPE
SYNTAX DSCodePoint
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The DSCP value associated with protocol identified in this
entry."
::= { dsPdistTopNEntry dsmonPdistTopNEntry 3 }
dsPdistTopNRate
dsmonPdistTopNRate OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The amount of change in the selected variable during this
sampling interval. The selected variable is this protocol's
instance of the object selected by
dsPdistTopNControlRateBase.
dsmonPdistTopNControlRateBase.
If the associated dsPdistTopNControlRateBase dsmonPdistTopNControlRateBase is equal to
'dsPdistTopNHCPkts'
'dsmonPdistTopNHCPkts' or 'dsPdistTopNHCOctets', 'dsmonPdistTopNHCOctets', then
this object will contain the the least significant 32 bits
of the associated dsPdistTopNHCRate dsmonPdistTopNHCRate object."
::= { dsPdistTopNEntry dsmonPdistTopNEntry 4 }
dsPdistTopNRateOvfl
dsmonPdistTopNRateOvfl OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The most significant 32 bits of the associated
dsPdistTopNHCRate
dsmonPdistTopNHCRate object.
If the associated dsPdistTopNControlRateBase dsmonPdistTopNControlRateBase is equal to
'dsPdistTopNHCPkts'
'dsmonPdistTopNHCPkts' or 'dsPdistTopNHCOctets', 'dsmonPdistTopNHCOctets', then
this object will contain the upper 32 bits of the associated
dsPdistTopNHCRate
dsmonPdistTopNHCRate object.
If the associated dsPdistTopNControlRateBase dsmonPdistTopNControlRateBase is equal to
'dsPdistTopNPkts'
'dsmonPdistTopNPkts' or 'dsPdistTopNOctets', 'dsmonPdistTopNOctets', then this
object will contain the value zero.
The agent may choose not to instantiate this object if High
Capacity RMON collection is not supported."
::= { dsPdistTopNEntry dsmonPdistTopNEntry 5 }
dsPdistTopNHCRate
dsmonPdistTopNHCRate OBJECT-TYPE
SYNTAX Counter64 -- Gauge64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The amount of change in the selected variable during this
sampling interval. The selected variable is this protocol's
instance of the object selected by
dsPdistTopNControlRateBase.
dsmonPdistTopNControlRateBase.
If the associated dsPdistTopNControlRateBase dsmonPdistTopNControlRateBase is equal to
'dsPdistTopNPkts'
'dsmonPdistTopNPkts' or 'dsPdistTopNOctets', 'dsmonPdistTopNOctets', then this
object will contain the value zero, and the associated
dsPdistTopNRate
dsmonPdistTopNRate object will contain the change in the
selected variable during the sampling interval.
The agent may choose not to instantiate this object if High
Capacity RMON collection is not supported."
::= { dsPdistTopNEntry dsmonPdistTopNEntry 6 }
-- ***********************************************************
-- * *
-- * P E R - H O S T C O L L E C T I O N S *
-- * *
-- ***********************************************************
--
-- IP Host Statistics Control Table
--
dsHostControlTable
dsmonHostControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsHostControlEntry DsmonHostControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Controls setup of per DSCP, per IP host distribution
statistics."
::= { dsHostObjects dsmonHostObjects 1 }
dsHostControlEntry
dsmonHostControlEntry OBJECT-TYPE
SYNTAX DsHostControlEntry DsmonHostControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row in the dsHostControlTable. dsmonHostControlTable.
Entries are created and deleted from this table by
management action only, using the dsHostControlStatus dsmonHostControlStatus
RowStatus object.
Activation of a control row in this table will cause an
associated dsHostTable dsmonHostTable to be created and maintained by
the agent."
INDEX { dsHostControlIndex dsmonHostControlIndex }
::= { dsHostControlTable dsmonHostControlTable 1 }
DsHostControlEntry
DsmonHostControlEntry ::= SEQUENCE {
dsHostControlIndex
dsmonHostControlIndex Integer32,
dsHostControlDataSource
dsmonHostControlDataSource DataSource,
dsHostControlMaxDesiredEntries
dsmonHostControlMaxDesiredEntries Integer32,
dsHostControlNumAddrBits
dsmonHostControlNumAddrBits Integer32,
dsHostControlDroppedFrames
dsmonHostControlDroppedFrames Counter32,
dsHostControlInserts
dsmonHostControlInserts Counter32,
dsHostControlDeletes
dsmonHostControlDeletes Counter32,
dsHostControlCreateTime
dsmonHostControlCreateTime LastCreateTime,
dsHostControlOwner
dsmonHostControlOwner OwnerString,
dsHostControlStatus
dsmonHostControlStatus RowStatus
}
dsHostControlIndex
dsmonHostControlIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An arbitrary and unique index for this dsHostControlEntry."
dsmonHostControlEntry."
::= { dsHostControlEntry dsmonHostControlEntry 1 }
dsHostControlDataSource
dsmonHostControlDataSource OBJECT-TYPE
SYNTAX DataSource
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The source of data for the associated dsHostTable. dsmonHostTable.
The statistics in this group reflect all IPv4 and IPv6
packets on the local network segment attached to the
identified interface.
This object may not be modified if the associated
dsHostControlStatus
dsmonHostControlStatus object is equal to active(1)."
::= { dsHostControlEntry dsmonHostControlEntry 2 }
dsHostControlMaxDesiredEntries
dsmonHostControlMaxDesiredEntries OBJECT-TYPE
SYNTAX Integer32 (-1 | 1..2147483647)
UNITS "table entries"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The maximum number of entries that are desired in the
dsHostTable
dsmonHostTable on behalf of this control entry. The probe
will not create more than this number of associated entries
in the table, but may choose to create fewer entries in this
table for any reason including the lack of resources.
If this value is set to -1, the probe may create any number
of entries in this table.
This object may not be modified if the associated
dsHostControlStatus
dsmonHostControlStatus object is equal to active(1)."
::= { dsHostControlEntry dsmonHostControlEntry 3 }
dsHostControlNumAddrBits
dsmonHostControlNumAddrBits OBJECT-TYPE
SYNTAX Integer32 (8..32)
UNITS "bits"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The number of 'leftmost' contiguous bits in the IPv4 host
address (as identified by the dsHostAddress dsmonHostAddress object) that
should be maintained in this collection.
If this object has a value less than '32', then 'm'
rightmost bits, where 'm' is equal to '32 -
dsHostControlNumAddrBits',
dsmonHostControlNumAddrBits', will be cleared to zero for
counting purposes only. The 'leftmost' bit is the most
significant bit of the first network-byte-order octet of the
address.
Note that this object only affects IPv4 host entries in the
associated dsHostTable. dsmonHostTable. IPv6 entries are not affected by
this object.
This object may not be modified if the associated
dsHostControlStatus
dsmonHostControlStatus object is equal to active(1)."
DEFVAL { 32 }
::= { dsHostControlEntry dsmonHostControlEntry 4 }
dsHostControlDroppedFrames
dsmonHostControlDroppedFrames OBJECT-TYPE
SYNTAX Counter32
UNITS "frames"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of frames which were received by the probe
and therefore not accounted for in the *StatsDropEvents, but
for which the probe chose not to count for the associated
dsHost
dsmonHost entries for whatever reason. Most often, this
event occurs when the probe is out of some resources and
decides to shed load from this collection.
This count does not include packets that were not counted
because they had MAC-layer errors.
Note that if the dsHostTable dsmonHostTable is inactive because no
appropriate protocols are enabled in the protocol directory,
this value should be 0.
Note that, unlike the dropEvents counter, this number is the
exact number of frames dropped."
::= { dsHostControlEntry dsmonHostControlEntry 5 }
dsHostControlInserts
dsmonHostControlInserts OBJECT-TYPE
SYNTAX Counter32
UNITS "table entries"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times a dsHost dsmonHost entry has been inserted
into the dsHost dsmonHost table. If an entry is inserted, then
deleted, and then inserted, this counter will be incremented
by 2.
To allow for efficient implementation strategies, agents may
delay updating this object for short periods of time. For
example, an implementation strategy may allow internal data
structures to differ from those visible via SNMP for short
periods of time. This counter may reflect the internal data
structures for those short periods of time.
Note that the table size can be determined by subtracting
dsHostControlDeletes
dsmonHostControlDeletes from dsHostControlInserts." dsmonHostControlInserts."
::= { dsHostControlEntry dsmonHostControlEntry 6 }
dsHostControlDeletes
dsmonHostControlDeletes OBJECT-TYPE
SYNTAX Counter32
UNITS "table entries"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times a dsHost dsmonHost entry has been deleted from
the dsHost dsmonHost table (for any reason). If an entry is
deleted, then inserted, and then deleted, this counter will
be incremented by 2.
To allow for efficient implementation strategies, agents may
delay updating this object for short periods of time. For
example, an implementation strategy may allow internal data
structures to differ from those visible via SNMP for short
periods of time. This counter may reflect the internal data
structures for those short periods of time.
Note that the table size can be determined by subtracting
dsHostControlDeletes
dsmonHostControlDeletes from dsHostControlInserts." dsmonHostControlInserts."
::= { dsHostControlEntry dsmonHostControlEntry 7 }
dsHostControlCreateTime
dsmonHostControlCreateTime OBJECT-TYPE
SYNTAX LastCreateTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime when this control entry was last
activated. This can be used by the management station to
ensure that
detect if the table has not been deleted and recreated between polls."
polls. ***"
::= { dsHostControlEntry dsmonHostControlEntry 8 }
dsHostControlOwner
dsmonHostControlOwner OBJECT-TYPE
SYNTAX OwnerString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The entity that configured this entry and is therefore
using the resources assigned to it."
::= { dsHostControlEntry dsmonHostControlEntry 9 }
dsHostControlStatus
dsmonHostControlStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this dsHostControlEntry. dsmonHostControlEntry.
An entry may not exist in the active state unless all
objects in the entry have an appropriate value.
If this object is not equal to active(1), all associated
entries in the dsHostTable dsmonHostTable shall be deleted."
::= { dsHostControlEntry dsmonHostControlEntry 10 }
--
-- IP Host Statistics Table
--
dsHostTable
dsmonHostTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsHostEntry DsmonHostEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A collection of statistics for a particular IPv4 or IPv6
address that has been discovered on a particular dataSource.
The probe will add to this table all IP addresses seen as
the source or destination address in all packets with no MAC
errors, and will increment octet and packet counts in the
table for all packets with no MAC errors."
::= { dsHostObjects dsmonHostObjects 2 }
dsHostEntry
dsmonHostEntry OBJECT-TYPE
SYNTAX DsHostEntry DsmonHostEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A list of information on Differentiated Services DSCP
usage, containing packet and octet counters for each DSCP
configured for collection per host address, as identified in
each monitored packet.
The dsHostControlIndex dsmonHostControlIndex value in the index identifies the
dsHostControlEntry
dsmonHostControlEntry on whose behalf this entry was
created. The length of the dsHostAddress dsmonHostAddress field
identifies the network layer protocol as either IPv4 or
IPv6.
Only entries with non-zero statistics will be returned by
the agent, in order to reduce the amount of polling required
to retrieve data from this table. An entry will be created
when a packet of that type, IP address, and DSCP value is
detected by the agent.
An example of the indexing of this entry is
dsHostOutPkts.1.24873.32.4.171.69.120.0"
dsmonHostOutPkts.1.24873.32.4.171.69.120.0"
INDEX { dsHostControlIndex,
dsHostTimeMark,
dsHostDsCodept,
dsHostAddress dsmonHostControlIndex,
dsmonHostTimeMark,
dsmonHostDsCodept,
dsmonHostAddress }
::= { dsHostTable dsmonHostTable 1 }
DsHostEntry
DsmonHostEntry ::= SEQUENCE {
dsHostTimeMark
dsmonHostTimeMark TimeFilter,
dsHostDsCodept
dsmonHostDsCodept DSCodePoint,
dsHostAddress
dsmonHostAddress OCTET STRING,
dsHostInPkts
dsmonHostInPkts ZeroBasedCounter32,
dsHostInOctets
dsmonHostInOctets ZeroBasedCounter32,
dsHostInOvflPkts
dsmonHostInOvflPkts ZeroBasedCounter32,
dsHostInOvflOctets
dsmonHostInOvflOctets ZeroBasedCounter32,
dsHostInHCPkts
dsmonHostInHCPkts ZeroBasedCounter64,
dsHostInHCOctets
dsmonHostInHCOctets ZeroBasedCounter64,
dsHostOutPkts
dsmonHostOutPkts ZeroBasedCounter32,
dsHostOutOctets
dsmonHostOutOctets ZeroBasedCounter32,
dsHostOutOvflPkts
dsmonHostOutOvflPkts ZeroBasedCounter32,
dsHostOutOvflOctets
dsmonHostOutOvflOctets ZeroBasedCounter32,
dsHostOutHCPkts
dsmonHostOutHCPkts ZeroBasedCounter64,
dsHostOutHCOctets
dsmonHostOutHCOctets ZeroBasedCounter64,
dsHostCreateTime
dsmonHostCreateTime LastCreateTime
}
dsHostTimeMark
dsmonHostTimeMark OBJECT-TYPE
SYNTAX TimeFilter
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The Time Filter index for this table. This object may be
used by a management station to retrieve only rows which
have been created or modified since a particular time. Note
that the current value for a row are always returned and the
TimeFilter is not a historical data archiving mechanism.
Refer to RFC 2021 [RFC2021] for a detailed description of
TimeFilter operation."
::= { dsHostEntry dsmonHostEntry 1 }
dsHostDsCodept
dsmonHostDsCodept OBJECT-TYPE
SYNTAX DSCodePoint
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The DSCP value associated with the aggregated statistics
for a particular IP host."
::= { dsHostEntry dsmonHostEntry 2 }
dsHostAddress
dsmonHostAddress OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (4 | 16))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The network address for this dsHostEntry. dsmonHostEntry.
The length of the address string is used to determine if
this entry represents an IPv4 or IPv6 address. For example,
if the length of this object is '4', then this object is
encoded as an IPv4 address in network byte order.
Note that IPv4 addresses may have some 'rightmost' bits
cleared to zero for counting purposes, as specified by the
associated dsHostControlNumHostBits dsmonHostControlNumHostBits object."
::= { dsHostEntry dsmonHostEntry 3 }
dsHostInPkts
dsmonHostInPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of packets without errors, using the identified
DSCP and transmitted to this address, since it was added to
the dsHostTable. dsmonHostTable. Note that this is the number of link-layer link-
layer packets, so if a single network-layer packet is
fragmented into several link-layer frames, this counter is
incremented several times."
::= { dsHostEntry dsmonHostEntry 4 }
dsHostInOctets
dsmonHostInOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of octets, transmitted to this address and using
the identified DSCP, since it was added to the dsHostTable
dsmonHostTable (excluding framing bits but including FCS
octets), excluding those octets in packets that contained
errors.
Note this doesn't count just those octets in the particular
protocol frames, but includes the entire packet that
contained the protocol."
::= { dsHostEntry dsmonHostEntry 5 }
dsHostInOvflPkts
dsmonHostInOvflPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated dsHostInPkts dsmonHostInPkts counter
has overflowed. Note that this object will only be
instantiated if the associated dsHostInHCPkts dsmonHostInHCPkts object is
also instantiated for a particular dataSource."
::= { dsHostEntry dsmonHostEntry 6 }
dsHostInOvflOctets
dsmonHostInOvflOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated dsHostInOctets dsmonHostInOctets
counter has overflowed. Note that this object will only be
instantiated if the associated dsHostInHCOctets dsmonHostInHCOctets object is
also instantiated for a particular dataSource."
::= { dsHostEntry dsmonHostEntry 7 }
dsHostInHCPkts
dsmonHostInHCPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter64
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The 64-bit version of the dsHostInPkts dsmonHostInPkts object.
Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular
dataSource."
::= { dsHostEntry dsmonHostEntry 8 }
dsHostInHCOctets
dsmonHostInHCOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter64
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The 64-bit version of the dsHostInOctets dsmonHostInOctets object.
Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular
dataSource."
::= { dsHostEntry dsmonHostEntry 9 }
dsHostOutPkts
dsmonHostOutPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of packets without errors, using the identified
DSCP and transmitted by this address, since it was added to
the dsHostTable. dsmonHostTable. Note that this is the number of link-layer link-
layer packets, so if a single network-layer packet is
fragmented into several link-layer frames, this counter is
incremented several times."
::= { dsHostEntry dsmonHostEntry 10 }
dsHostOutOctets
dsmonHostOutOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of octets, transmitted by this address and using
the identified DSCP, since it was added to the dsHostTable
dsmonHostTable (excluding framing bits but including FCS
octets), excluding those octets in packets that contained
errors.
Note this doesn't count just those octets in the particular
protocol frames, but includes the entire packet that
contained the protocol."
::= { dsHostEntry dsmonHostEntry 11 }
dsHostOutOvflPkts
dsmonHostOutOvflPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated dsHostOutPkts dsmonHostOutPkts counter
has overflowed. Note that this object will only be
instantiated if the associated dsHostOutHCPkts dsmonHostOutHCPkts object is
also instantiated for a particular dataSource."
::= { dsHostEntry dsmonHostEntry 12 }
dsHostOutOvflOctets
dsmonHostOutOvflOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated dsHostOutOctets dsmonHostOutOctets
counter has overflowed. Note that this object will only be
instantiated if the associated dsHostOutHCOctets dsmonHostOutHCOctets object
is also instantiated for a particular dataSource."
::= { dsHostEntry dsmonHostEntry 13 }
dsHostOutHCPkts
dsmonHostOutHCPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter64
UNITS "packets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The 64-bit version of the dsHostOutPkts dsmonHostOutPkts object.
Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular
dataSource."
::= { dsHostEntry dsmonHostEntry 14 }
dsHostOutHCOctets
dsmonHostOutHCOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter64
UNITS "octets"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The 64-bit version of the dsHostOutOctets dsmonHostOutOctets object.
Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular
dataSource."
::= { dsHostEntry dsmonHostEntry 15 }
dsHostCreateTime
dsmonHostCreateTime OBJECT-TYPE
SYNTAX LastCreateTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime when this dsHost dsmonHost entry was last
instantiated by the agent. This can be used by the
management station to ensure that the entry has not been
deleted and recreated between polls."
::= { dsHostEntry dsmonHostEntry 16 }
--
-- DSCP Per-Protocol Per-Host Statistics TopN Control Table
--
dsHostTopNControlTable
dsmonHostTopNControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsHostTopNControlEntry DsmonHostTopNControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A set of parameters that control the creation of a report
of the top N dsHost dsmonHost entries according to a selected
metric."
::= { dsHostObjects dsmonHostObjects 3 }
dsHostTopNControlEntry
dsmonHostTopNControlEntry OBJECT-TYPE
SYNTAX DsHostTopNControlEntry DsmonHostTopNControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row in the dsHostTopNControlTable. dsmonHostTopNControlTable.
Entries are created and deleted from this table by
management action only, using the dsHostTopNControlStatus dsmonHostTopNControlStatus
RowStatus object.
Activation of a control row in this table will cause an
associated dsHostTopNTable dsmonHostTopNTable to be created and maintained
by the agent."
INDEX { dsHostTopNControlIndex dsmonHostTopNControlIndex }
::= { dsHostTopNControlTable dsmonHostTopNControlTable 1 }
DsHostTopNControlEntry
DsmonHostTopNControlEntry ::= SEQUENCE {
dsHostTopNControlIndex
dsmonHostTopNControlIndex Integer32,
dsHostTopNControlHostIndex
dsmonHostTopNControlHostIndex Integer32,
dsHostTopNControlRateBase
dsmonHostTopNControlRateBase INTEGER,
dsHostTopNControlTimeRemaining
dsmonHostTopNControlTimeRemaining Integer32,
dsHostTopNControlGeneratedReports
dsmonHostTopNControlGeneratedReports Counter32,
dsHostTopNControlDuration
dsmonHostTopNControlDuration Integer32,
dsHostTopNControlRequestedSize
dsmonHostTopNControlRequestedSize Integer32,
dsHostTopNControlGrantedSize
dsmonHostTopNControlGrantedSize Integer32,
dsHostTopNControlStartTime
dsmonHostTopNControlStartTime TimeStamp,
dsHostTopNControlOwner
dsmonHostTopNControlOwner OwnerString,
dsHostTopNControlStatus
dsmonHostTopNControlStatus RowStatus
}
dsHostTopNControlIndex
dsmonHostTopNControlIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An index that uniquely identifies an entry in the
dsHostTopNControlTable.
dsmonHostTopNControlTable. Each such entry defines one Top
N report prepared for one RMON dataSource."
::= { dsHostTopNControlEntry dsmonHostTopNControlEntry 1 }
dsHostTopNControlHostIndex
dsmonHostTopNControlHostIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The dsHostTable dsmonHostTable for which a top N report will be
prepared on behalf of this entry. The dsHostTable dsmonHostTable is
identified by the value of the dsHostControlIndex dsmonHostControlIndex for
that table - that value is used here to identify the
particular table.
This object may not be modified if the associated
dsHostTopNControlStatus
dsmonHostTopNControlStatus object is equal to active(1)."
::= { dsHostTopNControlEntry dsmonHostTopNControlEntry 2 }
dsHostTopNControlRateBase
dsmonHostTopNControlRateBase OBJECT-TYPE
SYNTAX INTEGER {
dsHostTopNInPkts(1),
dsHostTopNInOctets(2),
dsHostTopNOutPkts(3),
dsHostTopNOutOctets(4),
dsHostTopNTotalPkts(5),
dsHostTopNTotalOctets(6),
dsHostTopNInHCPkts(7),
dsHostTopNInHCOctets(8),
dsHostTopNOutHCPkts(9),
dsHostTopNOutHCOctets(10),
dsHostTopNTotalHCPkts(11),
dsHostTopNTotalHCOctets(12)
dsmonHostTopNInPkts(1),
dsmonHostTopNInOctets(2),
dsmonHostTopNOutPkts(3),
dsmonHostTopNOutOctets(4),
dsmonHostTopNTotalPkts(5),
dsmonHostTopNTotalOctets(6),
dsmonHostTopNInHCPkts(7),
dsmonHostTopNInHCOctets(8),
dsmonHostTopNOutHCPkts(9),
dsmonHostTopNOutHCOctets(10),
dsmonHostTopNTotalHCPkts(11),
dsmonHostTopNTotalHCOctets(12)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The variable(s) for each dsHost dsmonHost that the dsHostTopNRate
dsmonHostTopNRate and
dsHostTopNHCRate dsmonHostTopNHCRate variables are
based upon. Each dsHostTopN dsmonHostTopN report generated on behalf
of this control entry will be ranked in descending order,
based on the associated
dsHostTable dsmonHostTable counter(s),
identified by this object.
The following table identifies the dsHostTable dsmonHostTable counters
associated with each enumeration:
Enumeration RateBase MIB Objects
----------- --------------------
dsHostTopNInPkts dsHostInPkts
dsHostTopNInOctets dsHostInOctets
dsHostTopNOutPkts dsHostOutPkts
dsHostTopNOutOctets dsHostOutOctets
dsHostTopNTotalPkts dsHostInPkts
dsmonHostTopNInPkts dsmonHostInPkts
dsmonHostTopNInOctets dsmonHostInOctets
dsmonHostTopNOutPkts dsmonHostOutPkts
dsmonHostTopNOutOctets dsmonHostOutOctets
dsmonHostTopNTotalPkts dsmonHostInPkts +
dsHostOutPkts
dsHostTopNTotalOctets dsHostInOctets
dsmonHostOutPkts
dsmonHostTopNTotalOctets dsmonHostInOctets +
dsHostOutOctets
dsHostTopNInHCPkts dsHostInHCPkts
dsHostTopNInHCOctets dsHostInHCOctets
dsHostTopNOutHCPkts dsHostOutHCPkts
dsHostTopNOutHCOctets dsHostOutHCPkts
dsHostTopNTotalHCPkts dsHostInHCPkts
dsmonHostOutOctets
dsmonHostTopNInHCPkts dsmonHostInHCPkts
dsmonHostTopNInHCOctets dsmonHostInHCOctets
dsmonHostTopNOutHCPkts dsmonHostOutHCPkts
dsmonHostTopNOutHCOctets dsmonHostOutHCPkts
dsmonHostTopNTotalHCPkts dsmonHostInHCPkts +
dsHostOutHCPkts
dsHostTopNTotalHCOctets dsHostInHCOctets
dsmonHostOutHCPkts
dsmonHostTopNTotalHCOctets dsmonHostInHCOctets +
dsHostOutHCOctets
dsmonHostOutHCOctets
The following enumerations are only available if the agent
supports High Capacity RMON collection:
dsHostTopNInHCPkts
dsHostTopNInHCOctets
dsHostTopNOutHCPkts
dsHostTopNOutHCOctets
dsHostTopNTotalHCPkts
dsHostTopNTotalHCOctets
dsmonHostTopNInHCPkts
dsmonHostTopNInHCOctets
dsmonHostTopNOutHCPkts
dsmonHostTopNOutHCOctets
dsmonHostTopNTotalHCPkts
dsmonHostTopNTotalHCOctets
It is an implementation-specific matter whether an agent can
detect an overflow condition resulting from the addition of
two counter delta values for the following enumerations:
dsHostTopNTotalPkts
dsHostTopNTotalOctets
dsHostTopNTotalHCPkts
dsHostTopNTotalHCOctets
dsmonHostTopNTotalPkts
dsmonHostTopNTotalOctets
dsmonHostTopNTotalHCPkts
dsmonHostTopNTotalHCOctets
In the event such an overflow condition can be detected by
the agent, the associated dsHostTopNRate,
dsHostTopNRateOvfl, dsmonHostTopNRate,
dsmonHostTopNRateOvfl, and/or dsHostTopNHCRate dsmonHostTopNHCRate objects
should be set to their maximum value.
This object may not be modified if the associated
dsHostTopNControlStatus
dsmonHostTopNControlStatus object is equal to active(1)."
::= { dsHostTopNControlEntry dsmonHostTopNControlEntry 3 }
dsHostTopNControlTimeRemaining
dsmonHostTopNControlTimeRemaining OBJECT-TYPE
SYNTAX Integer32 (0..2147483647)
UNITS "seconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The number of seconds left in the report currently being
collected. When this object is modified by the management
station, a new collection is started, possibly aborting a
currently running report. The new value is used as the
requested duration of this report, and is immediately loaded
into the associated dsHostTopNControlDuration dsmonHostTopNControlDuration object.
When the report finishes, the probe will automatically start
another collection with the same initial value of
dsHostTopNControlTimeRemaining.
dsmonHostTopNControlTimeRemaining. Thus the management
station may simply read the resulting reports repeatedly,
checking the startTime and duration each time to ensure that
a report was not missed or that the report parameters were
not changed.
While the value of this object is non-zero, it decrements by
one per second until it reaches zero. At the time that this
object decrements to zero, the report is made accessible in
the dsHostTopNTable, dsmonHostTopNTable, overwriting any report that may be
there.
When this object is modified by the management station, any
associated entries in the dsHostTopNTable dsmonHostTopNTable shall be
deleted."
DEFVAL { 1800 }
::= { dsHostTopNControlEntry dsmonHostTopNControlEntry 4 }
dsHostTopNControlGeneratedReports
dsmonHostTopNControlGeneratedReports OBJECT-TYPE
SYNTAX Counter32
UNITS "reports"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of reports that have been generated by this
entry."
::= { dsHostTopNControlEntry dsmonHostTopNControlEntry 5 }
dsHostTopNControlDuration
dsmonHostTopNControlDuration OBJECT-TYPE
SYNTAX Integer32
UNITS "seconds"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of seconds that this report has collected during
the last sampling interval.
When the associated dsHostTopNControlTimeRemaining dsmonHostTopNControlTimeRemaining object
is set, this object shall be set by the probe to the same
value and shall not be modified until the next time the
dsHostTopNControlTimeRemaining
dsmonHostTopNControlTimeRemaining is set.
This value shall be zero if no reports have been requested
for this dsHostTopNControlEntry." dsmonHostTopNControlEntry."
::= { dsHostTopNControlEntry dsmonHostTopNControlEntry 6 }
dsHostTopNControlRequestedSize
dsmonHostTopNControlRequestedSize OBJECT-TYPE
SYNTAX Integer32 (0..2147483647)
UNITS "table entries"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The maximum number of dsHost dsmonHost entries requested for this
report.
When this object is created or modified, the probe should
set dsHostTopNControlGrantedSize dsmonHostTopNControlGrantedSize as closely to this
object as is possible for the particular probe
implementation and available resources."
DEFVAL { 150 }
::= { dsHostTopNControlEntry dsmonHostTopNControlEntry 7 }
dsHostTopNControlGrantedSize
dsmonHostTopNControlGrantedSize OBJECT-TYPE
SYNTAX Integer32 (0..2147483647)
UNITS "table entries"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum number of dsHost dsmonHost entries in this report.
When the associated dsHostTopNControlRequestedSize dsmonHostTopNControlRequestedSize object
is created or modified, the probe should set this object as
closely to the requested value as is possible for the
particular implementation and available resources. The probe
must not lower this value except as a result of a set to the
associated dsHostTopNControlRequestedSize dsmonHostTopNControlRequestedSize object.
When the associated dsHostTopNControlRequestedSize dsmonHostTopNControlRequestedSize object
is created or modified, the probe should set this object as
closely to the requested value as is possible for the
particular implementation and available resources. The probe
must not lower this value except as a result of a set to the
associated dsHostTopNControlRequestedSize dsmonHostTopNControlRequestedSize object.
Protocol entries with the highest value of dsHostTopNRate dsmonHostTopNRate
or
dsHostTopNHCRate dsmonHostTopNHCRate (depending on the value of the
associated
dsHostTopNControlRateBase dsmonHostTopNControlRateBase object) shall be
placed in this table in decreasing order of this rate until
there is no more room or until there are no more dsHost dsmonHost
entries."
::= { dsHostTopNControlEntry dsmonHostTopNControlEntry 8 }
dsHostTopNControlStartTime
dsmonHostTopNControlStartTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime when this top N report was last
started. In other words, this is the time that the
associated dsHostTopNControlTimeRemaining dsmonHostTopNControlTimeRemaining object was
modified to start the requested report or the time the
report was last automatically (re)started.
This object may be used by the management station to
determine if a report was missed or not."
::= { dsHostTopNControlEntry dsmonHostTopNControlEntry 9 }
dsHostTopNControlOwner
dsmonHostTopNControlOwner OBJECT-TYPE
SYNTAX OwnerString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The entity that configured this entry and is therefore
using the resources assigned to it."
::= { dsHostTopNControlEntry dsmonHostTopNControlEntry 10 }
dsHostTopNControlStatus
dsmonHostTopNControlStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this dsHostTopNControlEntry. dsmonHostTopNControlEntry.
An entry may not exist in the active state unless all
objects in the entry have an appropriate value.
If this object is not equal to active(1), all associated
entries in the dsHostTopNTable dsmonHostTopNTable shall be deleted by the
agent."
::= { dsHostTopNControlEntry dsmonHostTopNControlEntry 11 }
--
-- dsHost dsmonHost TopN Table
--
dsHostTopNTable
dsmonHostTopNTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsHostTopNEntry DsmonHostTopNEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A set of statistics for those dsHost dsmonHost entries that have
counted the highest number of octets or packets.
Note that dsHost dsmonHost entries which did not increment at all
during the report interval are not included in dsHostTopN dsmonHostTopN
reports."
::= { dsHostObjects dsmonHostObjects 4 }
dsHostTopNEntry
dsmonHostTopNEntry OBJECT-TYPE
SYNTAX DsHostTopNEntry DsmonHostTopNEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row in the dsHostTopNTable. dsmonHostTopNTable.
The dsHostTopNControlIndex dsmonHostTopNControlIndex value in the index identifies
the
dsHostTopNControlEntry dsmonHostTopNControlEntry on whose behalf this entry was
created."
INDEX { dsHostTopNControlIndex, dsHostTopNIndex dsmonHostTopNControlIndex, dsmonHostTopNIndex }
::= { dsHostTopNTable dsmonHostTopNTable 1 }
DsHostTopNEntry
DsmonHostTopNEntry ::= SEQUENCE {
dsHostTopNIndex
dsmonHostTopNIndex Integer32,
dsHostTopNAddress
dsmonHostTopNAddress OCTET STRING,
dsHostTopNDsCodept
dsmonHostTopNDsCodept DSCodePoint,
dsHostTopNRate
dsmonHostTopNRate Gauge32,
dsHostTopNRateOvfl
dsmonHostTopNRateOvfl Gauge32,
dsHostTopNHCRate
dsmonHostTopNHCRate Counter64 -- Gauge64
}
dsHostTopNIndex
dsmonHostTopNIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An index that uniquely identifies an entry in the
dsHostTopNTable
dsmonHostTopNTable among those in the same report. This
index is between 1 and N, where N is the number of entries
in this report."
::= { dsHostTopNEntry dsmonHostTopNEntry 1 }
dsHostTopNAddress
dsmonHostTopNAddress OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (4 | 16))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The network address of the IP host identified in this
entry. The length of this field identifies the network
layer protocol as either IPv4 or IPv6. Addresses are
encoded in network byte order."
::= { dsHostTopNEntry dsmonHostTopNEntry 2 }
dsHostTopNDsCodept
dsmonHostTopNDsCodept OBJECT-TYPE
SYNTAX DSCodePoint
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The DSCP value associated with host identified in this
entry."
::= { dsHostTopNEntry dsmonHostTopNEntry 3 }
dsHostTopNRate
dsmonHostTopNRate OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The amount of change in the selected variable during this
sampling interval. The selected variable is this host's
instance of the object selected by
dsHostTopNControlRateBase.
dsmonHostTopNControlRateBase.
If the associated dsHostTopNControlRateBase dsmonHostTopNControlRateBase indicates a
High Capacity RMON enumeration, (e.g. 'dsHostTopNInHCPkts'),
'dsmonHostTopNInHCPkts'), then this object will contain the
the least significant 32 bits of the associated dsHostTopNHCRate
dsmonHostTopNHCRate object."
::= { dsHostTopNEntry dsmonHostTopNEntry 4 }
dsHostTopNRateOvfl
dsmonHostTopNRateOvfl OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The most significant 32 bits of the associated
dsHostTopNHCRate
dsmonHostTopNHCRate object.
If the associated dsHostTopNControlRateBase dsmonHostTopNControlRateBase is equal to
any of the High Capacity RMON enumerations (e.g.
'dsHostTopNInHCPkts'),
'dsmonHostTopNInHCPkts'), then this object will contain the
upper 32 bits of the associated dsHostTopNHCRate dsmonHostTopNHCRate object.
If the associated dsHostTopNControlRateBase dsmonHostTopNControlRateBase is not equal
to any of High Capacity RMON enumerations, then this object
will contain the value zero.
The agent may choose not to instantiate this object if High
Capacity RMON collection is not supported."
::= { dsHostTopNEntry dsmonHostTopNEntry 5 }
dsHostTopNHCRate
dsmonHostTopNHCRate OBJECT-TYPE
SYNTAX Counter64 -- Gauge64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The amount of change in the selected variable during this
sampling interval. The selected variable is this host's
instance of the object selected by
dsHostTopNControlRateBase.
dsmonHostTopNControlRateBase.
If the associated dsHostTopNControlRateBase dsmonHostTopNControlRateBase is not equal
to any of the High Capacity RMON enumerations (e.g.,
'dsHostTopNInPkts'),
'dsmonHostTopNInPkts'), then this object will contain the
value zero, and the associated dsHostTopNRate dsmonHostTopNRate object will
contain the change in the selected variable during the
sampling interval.
The agent may choose not to instantiate this object if High
Capacity RMON collection is not supported."
::= { dsHostTopNEntry dsmonHostTopNEntry 6 }
--
-- Notifications Section
-- (none defined)
--
--
-- Conformance Section
--
dsMonCompliances
dsmonCompliances OBJECT IDENTIFIER ::= { dsMonConformance dsmonConformance 1 }
dsMonGroups
dsmonGroups OBJECT IDENTIFIER ::= { dsMonConformance dsmonConformance 2 }
dsMonCompliance
dsmonCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"Describes the requirements for conformance to the
Differentiated Services Monitoring MIB."
MODULE -- this module
MANDATORY-GROUPS { dsStatsGroup, dsHostGroup dsmonStatsGroup, dsmonHostGroup }
GROUP dsStatsHCGroup dsmonStatsHCGroup
DESCRIPTION
"The dsStatsHCGroup dsmonStatsHCGroup is mandatory for systems which
implement the dsStatsGroup dsmonStatsGroup and also implement High
Capacity RMON monitoring."
GROUP dsPdistGroup dsmonPdistGroup
DESCRIPTION
"The dsPdistGroup dsmonPdistGroup is mandatory for systems which
implement DSCP monitoring and the protocolDirTable from the
RMON-2 MIB [RFC2021]."
GROUP dsPdistHCGroup dsmonPdistHCGroup
DESCRIPTION
"The dsPdistHCGroup dsmonPdistHCGroup is mandatory for systems which
implement the dsPdistGroup dsmonPdistGroup and also implement High
Capacity RMON monitoring."
GROUP dsHostHCGroup dsmonHostHCGroup
DESCRIPTION
"The dsHostHCGroup dsmonHostHCGroup is mandatory for systems which
implement the dsHostGroup dsmonHostGroup and also implement High
Capacity RMON monitoring."
::= { dsMonCompliances dsmonCompliances 1 }
dsStatsGroup
dsmonStatsGroup OBJECT-GROUP
OBJECTS {
dsStatsControlDataSource,
dsStatsControlDroppedFrames,
dsStatsControlCreateTime,
dsStatsControlOwner,
dsStatsControlStatus,
dsStatsInPkts,
dsStatsInOctets,
dsStatsOutPkts,
dsStatsOutOctets
dsmonStatsControlDataSource,
dsmonStatsControlDroppedFrames,
dsmonStatsControlCreateTime,
dsmonStatsControlOwner,
dsmonStatsControlStatus,
dsmonStatsInPkts,
dsmonStatsInOctets,
dsmonStatsOutPkts,
dsmonStatsOutOctets
}
STATUS current
DESCRIPTION
"A collection of objects providing per DSCP statistics."
::= { dsMonGroups dsmonGroups 1 }
dsStatsHCGroup
dsmonStatsHCGroup OBJECT-GROUP
OBJECTS {
dsStatsInOvflPkts,
dsStatsInOvflOctets,
dsStatsInHCPkts,
dsStatsInHCOctets,
dsStatsOutOvflPkts,
dsStatsOutOvflOctets,
dsStatsOutHCPkts,
dsStatsOutHCOctets
dsmonStatsInOvflPkts,
dsmonStatsInOvflOctets,
dsmonStatsInHCPkts,
dsmonStatsInHCOctets,
dsmonStatsOutOvflPkts,
dsmonStatsOutOvflOctets,
dsmonStatsOutHCPkts,
dsmonStatsOutHCOctets
}
STATUS current
DESCRIPTION
"A collection of objects providing per DSCP statistics for
high capacity data sources."
::= { dsMonGroups dsmonGroups 2 }
dsPdistGroup
dsmonPdistGroup OBJECT-GROUP
OBJECTS {
dsPdistControlDataSource,
dsPdistControlMaxDesiredEntries,
dsPdistControlCollectMode,
dsPdistControlDroppedFrames,
dsPdistControlInserts,
dsPdistControlDeletes,
dsPdistControlCreateTime,
dsPdistControlOwner,
dsPdistControlStatus,
dsPdistStatsPkts,
dsPdistStatsOctets,
dsPdistStatsCreateTime,
dsPdistTopNControlPdistIndex,
dsPdistTopNControlRateBase,
dsPdistTopNControlTimeRemaining,
dsPdistTopNControlGeneratedReports,
dsPdistTopNControlDuration,
dsPdistTopNControlRequestedSize,
dsPdistTopNControlGrantedSize,
dsPdistTopNControlStartTime,
dsPdistTopNControlOwner,
dsPdistTopNControlStatus,
dsPdistTopNProtocolDirLocalIndex,
dsPdistTopNDsCodept,
dsPdistTopNRate
dsmonPdistControlDataSource,
dsmonPdistControlMaxDesiredEntries,
dsmonPdistControlDroppedFrames,
dsmonPdistControlInserts,
dsmonPdistControlDeletes,
dsmonPdistControlCreateTime,
dsmonPdistControlOwner,
dsmonPdistControlStatus,
dsmonPdistStatsPkts,
dsmonPdistStatsOctets,
dsmonPdistStatsCreateTime,
dsmonPdistTopNControlPdistIndex,
dsmonPdistTopNControlRateBase,
dsmonPdistTopNControlTimeRemaining,
dsmonPdistTopNControlGeneratedReports,
dsmonPdistTopNControlDuration,
dsmonPdistTopNControlRequestedSize,
dsmonPdistTopNControlGrantedSize,
dsmonPdistTopNControlStartTime,
dsmonPdistTopNControlOwner,
dsmonPdistTopNControlStatus,
dsmonPdistTopNProtocolDirLocalIndex,
dsmonPdistTopNDsCodept,
dsmonPdistTopNRate
}
STATUS current
DESCRIPTION
"A collection of objects providing per protocol DSCP
monitoring extensions to the RMON-2 MIB."
::= { dsMonGroups dsmonGroups 3 }
dsPdistHCGroup
dsmonPdistHCGroup OBJECT-GROUP
OBJECTS {
dsPdistStatsOvflPkts,
dsPdistStatsOvflOctets,
dsPdistStatsHCPkts,
dsPdistStatsHCOctets,
dsPdistTopNRateOvfl,
dsPdistTopNHCRate
dsmonPdistStatsOvflPkts,
dsmonPdistStatsOvflOctets,
dsmonPdistStatsHCPkts,
dsmonPdistStatsHCOctets,
dsmonPdistTopNRateOvfl,
dsmonPdistTopNHCRate
}
STATUS current
DESCRIPTION
"A collection of objects providing per protocol DSCP
monitoring extensions to the RMON-2 MIB for High Capacicy
networks."
::= { dsMonGroups dsmonGroups 4 }
dsHostGroup
dsmonHostGroup OBJECT-GROUP
OBJECTS {
dsHostControlDataSource,
dsHostControlMaxDesiredEntries,
dsHostControlNumAddrBits,
dsHostControlDroppedFrames,
dsHostControlInserts,
dsHostControlDeletes,
dsHostControlCreateTime,
dsHostControlOwner,
dsHostControlStatus,
dsHostInPkts,
dsHostInOctets,
dsHostOutPkts,
dsHostOutOctets,
dsHostCreateTime,
dsHostTopNControlHostIndex,
dsHostTopNControlRateBase,
dsHostTopNControlTimeRemaining,
dsHostTopNControlGeneratedReports,
dsHostTopNControlDuration,
dsHostTopNControlRequestedSize,
dsHostTopNControlGrantedSize,
dsHostTopNControlStartTime,
dsHostTopNControlOwner,
dsHostTopNControlStatus,
dsHostTopNAddress,
dsHostTopNDsCodept,
dsHostTopNRate
dsmonHostControlDataSource,
dsmonHostControlMaxDesiredEntries,
dsmonHostControlNumAddrBits,
dsmonHostControlDroppedFrames,
dsmonHostControlInserts,
dsmonHostControlDeletes,
dsmonHostControlCreateTime,
dsmonHostControlOwner,
dsmonHostControlStatus,
dsmonHostInPkts,
dsmonHostInOctets,
dsmonHostOutPkts,
dsmonHostOutOctets,
dsmonHostCreateTime,
dsmonHostTopNControlHostIndex,
dsmonHostTopNControlRateBase,
dsmonHostTopNControlTimeRemaining,
dsmonHostTopNControlGeneratedReports,
dsmonHostTopNControlDuration,
dsmonHostTopNControlRequestedSize,
dsmonHostTopNControlGrantedSize,
dsmonHostTopNControlStartTime,
dsmonHostTopNControlOwner,
dsmonHostTopNControlStatus,
dsmonHostTopNAddress,
dsmonHostTopNDsCodept,
dsmonHostTopNRate
}
STATUS current
DESCRIPTION
"A collection of objects providing per IP Host DSCP
monitoring functions."
::= { dsMonGroups dsmonGroups 5 }
dsHostHCGroup
dsmonHostHCGroup OBJECT-GROUP
OBJECTS {
dsHostInOvflPkts,
dsHostInOvflOctets,
dsHostInHCPkts,
dsHostInHCOctets,
dsHostOutOvflPkts,
dsHostOutOvflOctets,
dsHostOutHCPkts,
dsHostOutHCOctets,
dsHostTopNRateOvfl,
dsHostTopNHCRate
dsmonHostInOvflPkts,
dsmonHostInOvflOctets,
dsmonHostInHCPkts,
dsmonHostInHCOctets,
dsmonHostOutOvflPkts,
dsmonHostOutOvflOctets,
dsmonHostOutHCPkts,
dsmonHostOutHCOctets,
dsmonHostTopNRateOvfl,
dsmonHostTopNHCRate
}
STATUS current
DESCRIPTION
"A collection of objects providing per IP Host DSCP
monitoring functions for High Capacity networks."
::= { dsMonGroups dsmonGroups 6 }
END
7. Intellectual Property
The IETF takes no position regarding the validity or scope of any
intellectual property or other rights that might be claimed to pertain
to the implementation or use of the technology described in this
document or the extent to which any license under such rights might or
might not be available; neither does it represent that it has made any
effort to identify any such rights. Information on the IETF's
procedures with respect to rights in standards-track and standards-
related documentation can be found in BCP-11. Copies of claims of
rights made available for publication and any assurances of licenses to
be made available, or the result of an attempt made to obtain a general
license or permission for the use of such proprietary rights by
implementors or users of this specification can be obtained from the
IETF Secretariat."
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary rights
which may cover technology that may be required to practice this
standard. Please address the information to the IETF Executive
Director.
8. Acknowledgements
This memo has been produced with a great deal of assistance from Keith
McCloghrie and Bijendra Jain.
9. References
[HC-RMON]
S. Waldbusser, "Remote Network Monitoring Management Information
Base for High Capacity Networks", draft-ietf-rmonmib-hcrmon-05.txt,
International Network Services, February 1999.
[RFC1155]
Rose, M., and K. McCloghrie, "Structure and Identification of
Management Information for TCP/IP-based Internets", RFC 1155,
Performance Systems International, Hughes LAN Systems, May 1990.
[RFC1157]
Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network
Management Protocol", RFC 1157, SNMP Research, Performance Systems
International, Performance Systems International, MIT Laboratory
for Computer Science, May 1990.
[RFC1212]
Rose, M., and K. McCloghrie, "Concise MIB Definitions", RFC 1212,
Performance Systems International, Hughes LAN Systems, March 1991.
[RFC1215]
M. Rose, "A Convention for Defining Traps for use with the SNMP",
RFC 1215, Performance Systems International, March 1991.
[RFC1901]
SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
Waldbusser, "Introduction to Community-based SNMPv2", RFC 1901,
SNMP Research, Inc., Cisco Systems, Inc., Dover Beach Consulting,
Inc., International Network Services, January 1996.
[RFC1905]
SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
Waldbusser, "Protocol Operations for Version 2 of the Simple
Network Management Protocol (SNMPv2)", RFC 1905, SNMP Research,
Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc.,
International Network Services, January 1996.
[RFC1906]
SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
Waldbusser, "Transport Mappings for Version 2 of the Simple Network
Management Protocol (SNMPv2)", RFC 1906, SNMP Research, Inc., Cisco
Systems, Inc., Dover Beach Consulting, Inc., International Network
Services, January 1996.
[RFC2021]
S. Waldbusser, "Remote Network Monitoring MIB (RMON-2)", RFC 2021,
International Network Services, January 1997.
[RFC2026]
Bradner, S., "The Internet Standards Process -- Revision 3", RFC
2026, Harvard University, October, 1996.
[RFC2074]
Bierman, A., and R. Iddon, "Remote Network Monitoring MIB Protocol
Identifiers", RFC 2074, Cisco Systems, AXON Networks, Inc., January
1997.
[RFC2474]
Nichols, K., Blake, S., Baker, F., and D. L. Black, "Definition of
the Differentiated Services Field (DS Field) in the IPv4 and IPv6
Headers", RFC 2474, Cisco Systems, Torrent Networking Technologies,
EMC Corporation, December, 1998.
[RFC2475]
Blake, S., Black, D., Carlson, M., Davies, E., Wang, Z., and W.
Weiss, "An Architecture for Differentiated Services", RFC 2475,
Torrent Networking Technologies, EMC Corporation, Sun Microsystems,
Nortel UK, Bell Labs Lucent Technologies, Lucent Technologies,
December, 1998.
[RFC2570]
Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction to
Version 3 of the Internet-standard Network Management Framework",
RFC 2570, SNMP Research, Inc., TIS Labs at Network Associates,
Inc., Ericsson, Cisco Systems, April 1999.
[RFC2571]
Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for
Describing SNMP Management Frameworks", RFC 2571, Cabletron
Systems, Inc., BMC Software, Inc., IBM T. J. Watson Research, April
1999.
[RFC2572]
Case, J., Harrington D., Presuhn R., and B. Wijnen, "Message
Processing and Dispatching for the Simple Network Management
Protocol (SNMP)", RFC 2572, SNMP Research, Inc., Cabletron Systems,
Inc., BMC Software, Inc., IBM T. J. Watson Research, April 1999.
[RFC2573]
Levi, D., Meyer, P., and B. Stewart, "SNMPv3 Applications", RFC
2573, SNMP Research, Inc., Secure Computing Corporation, Cisco
Systems, April 1999.
[RFC2574]
Blumenthal, U., and B. Wijnen, "User-based Security Model (USM) for
version 3 of the Simple Network Management Protocol (SNMPv3)", RFC
2574, IBM T. J. Watson Research, April 1999.
[RFC2575]
Wijnen, B., Presuhn, R., and K. McCloghrie, "View-based Access
Control Model (VACM) for the Simple Network Management Protocol
(SNMP)", RFC 2575, IBM T. J. Watson Research, BMC Software, Inc.,
Cisco Systems, Inc., April 1999.
[RFC2578]
McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M.,
and S. Waldbusser, "Structure of Management Information Version 2
(SMIv2)", RFC 2578, STD 58, Cisco Systems, SNMPinfo, TU
Braunschweig, SNMP Research, First Virtual Holdings, International
Network Services, April 1999.
[RFC2579]
McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M.,
and S. Waldbusser, "Textual Conventions for SMIv2", RFC 2579, STD
58, Cisco Systems, SNMPinfo, TU Braunschweig, SNMP Research, First
Virtual Holdings, International Network Services, April 1999.
[RFC2580]
McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M.,
and S. Waldbusser, "Conformance Statements for SMIv2", RFC 2580,
STD 58, Cisco Systems, SNMPinfo, TU Braunschweig, SNMP Research,
First Virtual Holdings, International Network Services, April 1999.
10. Security Considerations
There are a number of management objects defined in this MIB that have a
MAX-ACCESS clause of read-write and/or read-create. Such objects may be
considered sensitive or vulnerable in some network environments. The
support for SET operations in a non-secure environment without proper
protection can have a negative effect on network operations.
There are a number of managed objects in this MIB that may contain
sensitive information. These are:
dsPdistStatsPkts
dsPdistStatsOctets
dsPdistStatsHCPkts
dsPdistStatsHCOctets
dsmonPdistStatsPkts
dsmonPdistStatsOctets
dsmonPdistStatsHCPkts
dsmonPdistStatsHCOctets
dsmonPdistTopNRate
dsmonPdistTopNHCRate
These objects expose some basic statistics about the DCSP distribution
for each protocol detected on a particular network interface.
dsHostInPkts
dsHostInOctets
dsHostInHCPkts
dsHostInHCOctets
dsHostOutPkts
dsHostOutOctets
dsHostOutHCPkts
dsHostOutHCOctets
dsmonHostInPkts
dsmonHostInOctets
dsmonHostInHCPkts
dsmonHostInHCOctets
dsmonHostOutPkts
dsmonHostOutOctets
dsmonHostOutHCPkts
dsmonHostOutHCOctets
dsmonHostTopNRate
dsmonHostTopNHCRate
These objects expose some basic statistics about the DCSP distribution
for each IP host detected on a particular network interface.
dsmonHostTopNAddress
This object exposes IP addresses in use on the monitored network
interfaces.
It is thus important to control even GET access to these objects and
possibly to even encrypt the values of these object when sending them
over the network via SNMP. Not all versions of SNMP provide features
for such a secure environment.
SNMPv1 by itself is not a secure environment. Even if the network
itself is secure (for example by using IPSec), even then, there is no
control as to who on the secure network is allowed to access and GET/SET
(read/change/create/delete) the objects in this MIB.
It is recommended that the implementers consider the security features
as provided by the SNMPv3 framework. Specifically, the use of the User-
based Security Model RFC 2574 [RFC2574] and the View-based Access
Control Model RFC 2575 [RFC2575] is recommended.
It is then a customer/user responsibility to ensure that the SNMP entity
giving access to an instance of this MIB, is properly configured to give
access to the objects only to those principals (users) that have
legitimate rights to indeed GET or SET (change/create/delete) them.
11. Author's Address
Andy Bierman
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA USA 95134
Phone: +1 408-527-3711
Email: abierman@cisco.com
12. Full Copyright Statement
Copyright (C) The Internet Society (1999). 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."