< draft-bierman-dsmon-mib-01.txt   draft-bierman-dsmon-mib-02.txt >
Internet Draft Andy Bierman Internet Draft Andy Bierman
Cisco Systems, Inc. Cisco Systems, Inc.
11 June 1999 27 August 1999
Remote Monitoring MIB Extensions for Remote Monitoring MIB Extensions for
Differentiated Services Enabled Networks Differentiated Services Enabled Networks
<draft-bierman-dsmon-mib-01.txt> <draft-bierman-dsmon-mib-02.txt>
Status of this Memo Status of this Memo
This document is an Internet-Draft and is in full conformance with all This document is an Internet-Draft and is in full conformance with all
provisions of Section 10 of RFC2026 [RFC2026]. provisions of Section 10 of RFC2026 [RFC2026].
Internet-Drafts are working documents of the Internet Engineering Task Internet-Drafts are working documents of the Internet Engineering Task
Force (IETF), its areas, and its working groups. Note that other groups Force (IETF), its areas, and its working groups. Note that other groups
may also distribute working documents as Internet-Drafts. may also distribute working documents as Internet-Drafts.
skipping to change at page 2, line ? skipping to change at page 2, line ?
5 Overview ........................................................ 3 5 Overview ........................................................ 3
5.1 Terms ......................................................... 4 5.1 Terms ......................................................... 4
5.2 Relationship to Differentiated Services ....................... 4 5.2 Relationship to Differentiated Services ....................... 4
5.3 Relationship to the Remote Monitoring MIBs .................... 5 5.3 Relationship to the Remote Monitoring MIBs .................... 5
5.4 MIB Structure ................................................. 6 5.4 MIB Structure ................................................. 6
5.4.1 DS Statistics Group ......................................... 7 5.4.1 DS Statistics Group ......................................... 7
5.4.2 DS Protocol Distribution Group .............................. 7 5.4.2 DS Protocol Distribution Group .............................. 7
5.4.3 DS Host Distribution Group .................................. 8 5.4.3 DS Host Distribution Group .................................. 8
6 Definitions ..................................................... 9 6 Definitions ..................................................... 9
7 Intellectual Property ........................................... 59 7 Intellectual Property ........................................... 59
8 Acknowledgements ................................................ 59 8 Acknowledgements ................................................ 60
9 References ...................................................... 59 9 References ...................................................... 60
10 Security Considerations ........................................ 62 10 Security Considerations ........................................ 63
11 Author's Address ............................................... 63 11 Author's Address ............................................... 64
12 Full Copyright Statement ....................................... 63 12 Full Copyright Statement ....................................... 64
4. The SNMP Network Management Framework 4. The SNMP Network Management Framework
The SNMP Management Framework presently consists of five major The SNMP Management Framework presently consists of five major
components: components:
o An overall architecture, described in RFC 2571 [RFC2571]. o An overall architecture, described in RFC 2571 [RFC2571].
o Mechanisms for describing and naming objects and events for the o Mechanisms for describing and naming objects and events for the
purpose of management. The first version of this Structure of purpose of management. The first version of this Structure of
skipping to change at page 6, line 42 skipping to change at page 6, line 42
TopN Reports TopN Reports
The DS-MON MIB uses the same TopN reporting MIB structure as the The DS-MON MIB uses the same TopN reporting MIB structure as the
RMON-2 MIB [RFC2021]. TopN reporting can greatly reduce the polling RMON-2 MIB [RFC2021]. TopN reporting can greatly reduce the polling
overhead required to analyze DSCP usage patterns. overhead required to analyze DSCP usage patterns.
5.4. MIB Structure 5.4. MIB Structure
The DS-MON MIB contains three groups of MIB objects: The DS-MON MIB contains three groups of MIB objects:
- dsStatObjects group - dsmonStatsObjects group
Report DSCP distribution statistics for a particular RMON Report DSCP distribution statistics for a particular RMON
dataSource. dataSource.
- dsPdistObjects group - dsmonPdistObjects group
Report DSCP distribution statistics for each protocol detected on a Report DSCP distribution statistics for each protocol detected on a
particular RMON dataSource. particular RMON dataSource.
- dsHostObjects group - dsmonHostObjects group
Report IP host address distribution statistics for each DSCP, Report IP host address distribution statistics for each DSCP,
detected on a particular RMON dataSource. detected on a particular RMON dataSource.
5.4.1. DS Statistics Group 5.4.1. DS Statistics Group
This group contains two tables, the dsStatsControlTable and the This group contains two tables, the dsmonStatsControlTable and the
dsStatsTable, and supports DSCP distribution statistics for half and dsmonStatsTable, and supports DSCP distribution statistics for half and
full-duplex, low and high speed interfaces. Packet and octets full-duplex, low and high speed interfaces. Packet and octets
distributions (by DSCP) are maintained in the dsStatsTable for each distributions (by DSCP) are maintained in the dsmonStatsTable for each
active control row in the dsStatsControlTable. active control row in the dsmonStatsControlTable.
This group provides the lowest statistics granularity in the DS-MON MIB. This group provides the lowest statistics granularity in the DS-MON MIB.
It is expected than NMS applications will analyze certain DS deployment It is expected than NMS applications will analyze certain DS deployment
or performance problems by first examining the DSCP distribution for an or performance problems by first examining the DSCP distribution for an
entire interface with this group. entire interface with this group.
5.4.2. DS Protocol Distribution Group 5.4.2. DS Protocol Distribution Group
This group contains two tables for statistics collection, This group contains two tables for statistics collection,
(dsPdistControlTable and dsPdistStatsTable), and two tables for a 'Top (dsmonPdistControlTable and dsmonPdistStatsTable), and two tables for a
N' reporting function for the collected statistics 'Top N' reporting function for the collected statistics
(dsPdistTopNControlTable and dsPdistTopNTable). (dsmonPdistTopNControlTable and dsmonPdistTopNTable).
The dsPdistControlTable and dsPdistStatsTable tables provide DSCP The dsmonPdistControlTable and dsmonPdistStatsTable tables provide DSCP
distribution statistics for each selected protocol encapsulation in distribution statistics for each selected protocol encapsulation in
packets monitored on a particular dataSource. Packet and octets packets monitored on a particular dataSource. Packet and octets
distributions (per protocol per DSCP) are maintained in the distributions (per protocol per DSCP) are maintained in the
dsPdistStatsTable for each active control row in the dsmonPdistStatsTable for each active control row in the
dsPdistControlTable. dsmonPdistControlTable.
Due the potentially large number of entries, the DS Protocol Due the potentially large number of entries, the DS Protocol
Distribution is different from the RMON-2 protocol distribution group in Distribution is different from the RMON-2 protocol distribution group in
several ways: several ways:
- maximum desired entries parameter added to the control table - maximum desired entries parameter added to the control table
- inserts and deletes counters added to the control table - inserts and deletes counters added to the control table
- support for LRU garbage collection in the dsPdistStatsTable - support for LRU garbage collection in the dsmonPdistStatsTable
- TimeFilter index added to the dsPdistStatsTable - TimeFilter index added to the dsmonPdistStatsTable
- selection of protocols to count by a special 'collect mode' - the selection of protocols is not configurable. Rather than select
enumeration. Rather than select individual protocols to monitor, a individual protocols to monitor, (e.g., via a 'supportedOn/Off'
simplified configuration mechanism is provided. Since DSCP usage extension to the protocolDirTable [RFC 2021]), a simplified
statistics are most interesting at the network and application configuration mechanism is provided. Since DSCP usage statistics
layers, the dsPdistControlCollectMode object selects protocols by are most interesting at the application layer, the
network layer, application layer, or both. dsmonPdistStatsTable is 'hardwired' to select only application
layer (i.e., 'terminal') protocols for statistical analysis.
The TopN feature requires two additional tables: the The TopN feature requires two additional tables: the
dsPdistTopNControlTable and the dsPdistTopNTable, and supports periodic dsmonPdistTopNControlTable and the dsmonPdistTopNTable, and supports
usage reporting for the statistics maintained in the dsPdistStatsTable. periodic usage reporting for the statistics maintained in the
This feature allows for simple periodic retrieval of the most used dsmonPdistStatsTable. This feature allows for simple periodic retrieval
protocol/DSCP combinations. of the most used application/DSCP combinations.
5.4.3. DS Host Distribution Group 5.4.3. DS Host Distribution Group
This group contains two tables for statistics collection, This group contains two tables for statistics collection,
(dsHostControlTable and dsHostTable), and two tables for a 'Top N' (dsmonHostControlTable and dsmonHostTable), and two tables for a 'Top N'
reporting function for the collected statistics (dsHostTopNControlTable reporting function for the collected statistics
and dsHostTopNTable). (dsmonHostTopNControlTable and dsmonHostTopNTable).
The dsHostControlTable and dsHostTables provide IP host distribution The dsmonHostControlTable and dsmonHostTables provide IP host
statistics for each DSCP detected in packets monitored on a particular distribution statistics for each DSCP detected in packets monitored on a
dataSource. particular dataSource.
It is expected than NMS applications will analyze certain DS deployment It is expected than NMS applications will analyze certain DS deployment
or performance problems by first determining the high priority DSCP or performance problems by first determining the high priority DSCP
values to examine (beyond the scope of this document) and then examining values to examine (beyond the scope of this document) and then examining
the dsHostTable statistics to determine which IP hosts are using the the dsmonHostTable statistics to determine which IP hosts are using the
selected DSCP(s). selected DSCP(s).
Packet and octets distributions (in and out, per DSCP per IP host) are Packet and octets distributions (in and out, per DSCP per IP host) are
maintained in the dsHostTable for each active control row in the maintained in the dsmonHostTable for each active control row in the
dsHostControlTable. dsmonHostControlTable.
The DS Host Distribution is different from the RMON-2 network layer host The DS Host Distribution is different from the RMON-2 network layer host
group in two ways: group in two ways:
- there is no protocolDirLocalIndex in the dsHostTable INDEX, since - there is no protocolDirLocalIndex in the dsmonHostTable INDEX,
only IPv4 and IPv6 packets contain a DS field, the protocol (IPv4 since only IPv4 and IPv6 packets contain a DS field, the protocol
or IPv6) is determined by the length of each dsHostAddress (IPv4 or IPv6) is determined by the length of each dsmonHostAddress
instance. instance.
- the dsHostControlTable supports limited IPv4 subnet aggregation by - the dsmonHostControlTable supports limited IPv4 subnet aggregation
allowing the number of 'monitored address bits' in each address to by allowing the number of 'monitored address bits' in each address
be configured for each collection. The agent will zero out the to be configured for each collection. The agent will zero out the
selected number of rightmost IPv4 address bits for counting selected number of rightmost IPv4 address bits for counting
purposes. This configuration parameter can dramatically reduce the purposes. This configuration parameter can dramatically reduce the
number of entries which must be maintained by the agent, which number of entries which must be maintained by the agent, which
should reduce CPU and memory resource requirements on the agent, should reduce CPU and memory resource requirements on the agent,
and reduce polling overhead on the network and the management and reduce polling overhead on the network and the management
station. station.
The TopN feature requires two additional tables: the The TopN feature requires two additional tables: the
dsHostTopNControlTable and the dsHostTopNTable. and supports periodic dsmonHostTopNControlTable and the dsmonHostTopNTable. and supports
usage reporting for the statistics maintained in the dsHostTable. This periodic usage reporting for the statistics maintained in the
feature allows for simple periodic retrieval of the most used IP- dsmonHostTable. This feature allows for simple periodic retrieval of
host/DSCP combinations. the most used IP-host/DSCP combinations.
6. Definitions 6. Definitions
-- RMON-2 Extensions for the Monitoring of Differentiated Services -- RMON-2 Extensions for the Monitoring of Differentiated Services
-- Enabled Networks -- Enabled Networks
-- --
-- IP DIFFSERV DSCP statistics -- IP DIFFSERV DSCP statistics
-- * Per DSCP -- * Per DSCP
-- * Per Protocol Per DSCP -- * Per Protocol Per DSCP
-- * Per DSCP Per IP Host Address -- * Per DSCP Per IP Host Address
skipping to change at page 10, line 6 skipping to change at page 10, line 6
RowStatus, TimeStamp, TEXTUAL-CONVENTION RowStatus, TimeStamp, TEXTUAL-CONVENTION
FROM SNMPv2-TC FROM SNMPv2-TC
OwnerString OwnerString
FROM IF-MIB FROM IF-MIB
protocolDirLocalIndex, LastCreateTime, protocolDirLocalIndex, LastCreateTime,
DataSource, ZeroBasedCounter32, TimeFilter DataSource, ZeroBasedCounter32, TimeFilter
FROM RMON2-MIB FROM RMON2-MIB
ZeroBasedCounter64 ZeroBasedCounter64
FROM HC-RMON-MIB; FROM HC-RMON-MIB;
dsMonMIB MODULE-IDENTITY dsmonMIB MODULE-IDENTITY
LAST-UPDATED "9906100000Z" LAST-UPDATED "9908260000Z"
ORGANIZATION "Cisco Systems, Inc." ORGANIZATION "Cisco Systems, Inc."
CONTACT-INFO CONTACT-INFO
" Andy Bierman " Andy Bierman
Cisco Systems, Inc. Cisco Systems, Inc.
Postal: 170 West Tasman Drive Postal: 170 West Tasman Drive
San Jose, CA USA 95134 San Jose, CA USA 95134
Tel: +1 408 527-3711 Tel: +1 408 527-3711
E-mail: abierman@cisco.com" E-mail: abierman@cisco.com"
DESCRIPTION DESCRIPTION
"This module defines Remote Monitoring MIB extensions for "This module defines Remote Monitoring MIB extensions for
Differentiated Services enabled networks." Differentiated Services enabled networks."
::= { experimental 999999 } ::= { experimental 999999 }
dsMonObjects OBJECT IDENTIFIER ::= { dsMonMIB 1 } dsmonObjects OBJECT IDENTIFIER ::= { dsmonMIB 1 }
dsMonNotifications OBJECT IDENTIFIER ::= { dsMonMIB 2 } dsmonNotifications OBJECT IDENTIFIER ::= { dsmonMIB 2 }
dsMonConformance OBJECT IDENTIFIER ::= { dsMonMIB 3 } dsmonConformance OBJECT IDENTIFIER ::= { dsmonMIB 3 }
dsStatObjects OBJECT IDENTIFIER ::= { dsMonObjects 1 } dsmonStatsObjects OBJECT IDENTIFIER ::= { dsmonObjects 1 }
dsPdistObjects OBJECT IDENTIFIER ::= { dsMonObjects 2 } dsmonPdistObjects OBJECT IDENTIFIER ::= { dsmonObjects 2 }
dsHostObjects OBJECT IDENTIFIER ::= { dsMonObjects 3 } dsmonHostObjects OBJECT IDENTIFIER ::= { dsmonObjects 3 }
-- --
-- Extensions to the RMON-2 MIB for Differentiated Services -- Extensions to the RMON-2 MIB for Differentiated Services
-- Monitoring -- Monitoring
-- --
-- In order to maintain the RMON 'look-and-feel', some of -- In order to maintain the RMON 'look-and-feel', some of
-- the text from the RMON-2 and HC-RMON MIBs by -- the text from the RMON-2 and HC-RMON MIBs by
-- Steve Waldbusser has been used in this MIB.
-- --
-- --
-- Textual Convention to define a DSCP for -- Textual Convention to define a DSCP for
-- monitoring purposes -- monitoring purposes
-- --
DSCodePoint ::= TEXTUAL-CONVENTION DSCodePoint ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
skipping to change at page 11, line 20 skipping to change at page 11, line 20
-- *********************************************************** -- ***********************************************************
-- * * -- * *
-- * P E R - D A T A S O U C E C O L L E C T I O N S * -- * 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 -- DSCP Per-DataSource Statistics Control Table
-- --
dsStatsControlTable OBJECT-TYPE dsmonStatsControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsStatsControlEntry SYNTAX SEQUENCE OF DsmonStatsControlEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Controls the setup of per-data source per-DSCP distribution "Controls the setup of per-data source per-DSCP distribution
statistics." statistics."
::= { dsStatObjects 1 } ::= { dsmonStatsObjects 1 }
dsStatsControlEntry OBJECT-TYPE dsmonStatsControlEntry OBJECT-TYPE
SYNTAX DsStatsControlEntry SYNTAX DsmonStatsControlEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A conceptual row in the dsStatsControlTable. "A conceptual row in the dsmonStatsControlTable.
Entries are created and deleted from this table by Entries are created and deleted from this table by
management action only, using the dsStatsControlStatus management action only, using the dsmonStatsControlStatus
RowStatus object. RowStatus object.
Activation of a control row in this table will cause an Activation of a control row in this table will cause an
associated dsStatsTable to be created and maintained by the associated dsmonStatsTable to be created and maintained by
agent." the agent."
INDEX { dsStatsControlIndex } INDEX { dsmonStatsControlIndex }
::= { dsStatsControlTable 1 } ::= { dsmonStatsControlTable 1 }
DsStatsControlEntry ::= SEQUENCE { DsmonStatsControlEntry ::= SEQUENCE {
dsStatsControlIndex Integer32, dsmonStatsControlIndex Integer32,
dsStatsControlDataSource DataSource, dsmonStatsControlDataSource DataSource,
dsStatsControlDroppedFrames Counter32, dsmonStatsControlDroppedFrames Counter32,
dsStatsControlCreateTime LastCreateTime, dsmonStatsControlCreateTime LastCreateTime,
dsStatsControlOwner OwnerString, dsmonStatsControlOwner OwnerString,
dsStatsControlStatus RowStatus dsmonStatsControlStatus RowStatus
} }
dsStatsControlIndex OBJECT-TYPE dsmonStatsControlIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535) SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An arbitrary and unique index for this "An arbitrary and unique index for this
dsStatsControlEntry." dsmonStatsControlEntry."
::= { dsStatsControlEntry 1 } ::= { dsmonStatsControlEntry 1 }
dsStatsControlDataSource OBJECT-TYPE dsmonStatsControlDataSource OBJECT-TYPE
SYNTAX DataSource SYNTAX DataSource
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The source of data for the this per-protocol DSCP "The source of data for the this per-protocol DSCP
distribution. distribution.
The statistics in this group reflect all IPv4 and IPv6 The statistics in this group reflect all IPv4 and IPv6
packets on the local network segment attached to the packets on the local network segment attached to the
identified interface. identified interface.
This object may not be modified if the associated This object may not be modified if the associated
dsStatsControlStatus object is equal to active(1)." dsmonStatsControlStatus object is equal to active(1)."
::= { dsStatsControlEntry 2 } ::= { dsmonStatsControlEntry 2 }
dsStatsControlDroppedFrames OBJECT-TYPE dsmonStatsControlDroppedFrames OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
UNITS "frames"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The total number of frames which were received by the probe "The total number of frames which were received by the probe
and therefore not accounted for in the *StatsDropEvents, but and therefore not accounted for in the *StatsDropEvents, but
for which the probe chose not to count for this entry for for which the probe chose not to count for this entry for
whatever reason. Most often, this event occurs when the whatever reason. Most often, this event occurs when the
probe is out of some resources and decides to shed load from probe is out of some resources and decides to shed load from
this collection. this collection.
This count does not include packets that were not counted This count does not include packets that were not counted
because they had MAC-layer errors. because they had MAC-layer errors.
Note that, unlike the dropEvents counter, this number is the Note that, unlike the dropEvents counter, this number is the
exact number of frames dropped." exact number of frames dropped."
::= { dsStatsControlEntry 3 } ::= { dsmonStatsControlEntry 3 }
dsStatsControlCreateTime OBJECT-TYPE dsmonStatsControlCreateTime OBJECT-TYPE
SYNTAX LastCreateTime SYNTAX LastCreateTime
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of sysUpTime when this control entry was last "The value of sysUpTime when this control entry was last
activated. This can be used by the management station to activated. This can be used by the management station to
ensure that the table has not been deleted and recreated detect if the table has been deleted and recreated between
between polls." polls."
::= { dsStatsControlEntry 4 } ::= { dsmonStatsControlEntry 4 }
dsStatsControlOwner OBJECT-TYPE dsmonStatsControlOwner OBJECT-TYPE
SYNTAX OwnerString SYNTAX OwnerString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The entity that configured this entry and is therefore "The entity that configured this entry and is therefore
using the resources assigned to it." using the resources assigned to it."
::= { dsStatsControlEntry 5 } ::= { dsmonStatsControlEntry 5 }
dsStatsControlStatus OBJECT-TYPE dsmonStatsControlStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row. "The status of this row.
An entry may not exist in the active state unless all An entry may not exist in the active state unless all
objects in the entry have an appropriate value. objects in the entry have an appropriate value.
If this object is not equal to active(1), all associated If this object is not equal to active(1), all associated
entries in the dsStatsTable shall be deleted." entries in the dsmonStatsTable shall be deleted."
::= { dsStatsControlEntry 6 } ::= { dsmonStatsControlEntry 6 }
-- --
-- DSCP Per-DataSource Statistics Table -- DSCP Per-DataSource Statistics Table
-- --
dsmonStatsTable OBJECT-TYPE
dsStatsTable OBJECT-TYPE SYNTAX SEQUENCE OF DsmonStatsEntry
SYNTAX SEQUENCE OF DsStatsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A list of information on Per Protocol DSCP usage. "A list of information on Per Protocol DSCP usage.
The following table defines per-DSCP statistics for full The following table defines per-DSCP statistics for full
and/or half-duplex links as well as high capacity links. and/or half-duplex links as well as high capacity links.
For half-duplex links, or full-duplex-capable links For half-duplex links, or full-duplex-capable links
operating in half-duplex mode, the dsStatsIn* objects shall operating in half-duplex mode, the dsmonStatsIn* objects
be used and the dsStatsOut* objects will not increment. shall be used and the dsmonStatsOut* objects will not
increment.
For full-duplex links, the dsOut* objects will be present. For full-duplex links, the dsmonStatsOut* objects will be
Whenever possible, the probe should count packets moving present. Whenever possible, the probe should count packets
away from the closest terminating equipment as output moving away from the closest terminating equipment as output
packets. Failing that, the probe should count packets moving packets. Failing that, the probe should count packets moving
away from the DTE as output packets." away from the DTE as output packets."
::= { dsStatObjects 2 } ::= { dsmonStatsObjects 2 }
dsStatsEntry OBJECT-TYPE dsmonStatsEntry OBJECT-TYPE
SYNTAX DsStatsEntry SYNTAX DsmonStatsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A list of information on Differentiated Services DSCP "A list of information on Differentiated Services DSCP
usage, containing inbound and outbound packet and octet usage, containing inbound and outbound packet and octet
counters for each DSCP configured for collection. counters for each DSCP configured for collection.
The dsStatsControlIndex value in the index identifies the The dsmonStatsControlIndex value in the index identifies the
dsStatsControlEntry on whose behalf this entry was created. dsmonStatsControlEntry on whose behalf this entry was
created.
Only entries with non-zero statistics will be returned by Only entries with non-zero statistics will be returned by
the agent, in order to reduce the amount of polling required the agent, in order to reduce the amount of polling required
to retrieve data from this table. That is, an entry will be to retrieve data from this table. That is, an entry will be
created when a packet with the indicated DSCP value is created when a packet with the indicated DSCP value is
detected by the agent. detected by the agent.
Note that only protocols which are encapsulated in IPv4 or Note that only protocols which are encapsulated in IPv4 or
IPv6 packets will be counted in this table. IPv6 packets will be counted in this table.
An example of the indexing of this entry is An example of the indexing of this entry is
dsStatsOutPkts.1.16" dsmonStatsOutPkts.1.16"
INDEX { dsStatsControlIndex, dsStatsDsCodept } INDEX { dsmonStatsControlIndex, dsmonStatsDsCodept }
::= { dsStatsTable 1 } ::= { dsmonStatsTable 1 }
DsStatsEntry ::= SEQUENCE { DsmonStatsEntry ::= SEQUENCE {
dsStatsDsCodept DSCodePoint, dsmonStatsDsCodept DSCodePoint,
dsStatsInPkts ZeroBasedCounter32, dsmonStatsInPkts ZeroBasedCounter32,
dsStatsInOctets ZeroBasedCounter32, dsmonStatsInOctets ZeroBasedCounter32,
dsStatsInOvflPkts ZeroBasedCounter32, dsmonStatsInOvflPkts ZeroBasedCounter32,
dsStatsInOvflOctets ZeroBasedCounter32, dsmonStatsInOvflOctets ZeroBasedCounter32,
dsStatsInHCPkts ZeroBasedCounter64, dsmonStatsInHCPkts ZeroBasedCounter64,
dsStatsInHCOctets ZeroBasedCounter64, dsmonStatsInHCOctets ZeroBasedCounter64,
dsStatsOutPkts ZeroBasedCounter32, dsmonStatsOutPkts ZeroBasedCounter32,
dsStatsOutOctets ZeroBasedCounter32, dsmonStatsOutOctets ZeroBasedCounter32,
dsStatsOutOvflPkts ZeroBasedCounter32, dsmonStatsOutOvflPkts ZeroBasedCounter32,
dsStatsOutOvflOctets ZeroBasedCounter32, dsmonStatsOutOvflOctets ZeroBasedCounter32,
dsStatsOutHCPkts ZeroBasedCounter64, dsmonStatsOutHCPkts ZeroBasedCounter64,
dsStatsOutHCOctets ZeroBasedCounter64 dsmonStatsOutHCOctets ZeroBasedCounter64
} }
dsStatsDsCodept OBJECT-TYPE dsmonStatsDsCodept OBJECT-TYPE
SYNTAX DSCodePoint SYNTAX DSCodePoint
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The DSCP value associated with the aggregated statistics "The DSCP value associated with the aggregated statistics
for a particular data source." for a particular data source."
::= { dsStatsEntry 1 } ::= { dsmonStatsEntry 1 }
dsStatsInPkts OBJECT-TYPE dsmonStatsInPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of packets using a particular DSCP value, "The number of packets using a particular DSCP value,
received on a half-duplex link or on the inbound connection received on a half-duplex link or on the inbound connection
of a full-duplex link." of a full-duplex link."
::= { dsStatsEntry 2 } ::= { dsmonStatsEntry 2 }
dsStatsInOctets OBJECT-TYPE dsmonStatsInOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of octets in packets, using a particular DSCP "The number of octets in packets, using a particular DSCP
value, received on a half-duplex link or on the inbound value, received on a half-duplex link or on the inbound
connection of a full-duplex link." connection of a full-duplex link."
::= { dsStatsEntry 3 } ::= { dsmonStatsEntry 3 }
dsStatsInOvflPkts OBJECT-TYPE dsmonStatsInOvflPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times the associated dsStatsInPkts counter "The number of times the associated dsmonStatsInPkts counter
has overflowed. Note that this object will only be has overflowed. Note that this object will only be
instantiated if the associated dsStatsInHCPkts object is instantiated if the associated dsmonStatsInHCPkts object is
also instantiated for a particular dataSource." also instantiated for a particular dataSource."
::= { dsStatsEntry 4 } ::= { dsmonStatsEntry 4 }
dsStatsInOvflOctets OBJECT-TYPE dsmonStatsInOvflOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times the associated dsStatsInOctets counter "The number of times the associated dsmonStatsInOctets
has overflowed. Note that this object will only be counter has overflowed. Note that this object will only be
instantiated if the associated dsStatsInHCOctets object is instantiated if the associated dsmonStatsInHCOctets object
also instantiated for a particular dataSource." is also instantiated for a particular dataSource."
::= { dsStatsEntry 5 } ::= { dsmonStatsEntry 5 }
dsStatsInHCPkts OBJECT-TYPE dsmonStatsInHCPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter64 SYNTAX ZeroBasedCounter64
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The 64-bit version of the dsStatsInPkts object. "The 64-bit version of the dsmonStatsInPkts object.
Note that this object will only be instantiated if the RMON Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular agent supports High Capacity RMON for a particular
dataSource." dataSource."
::= { dsStatsEntry 6 } ::= { dsmonStatsEntry 6 }
dsStatsInHCOctets OBJECT-TYPE dsmonStatsInHCOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter64 SYNTAX ZeroBasedCounter64
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The 64-bit version of the dsStatsInOctets object. "The 64-bit version of the dsmonStatsInOctets object.
Note that this object will only be instantiated if the RMON Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular agent supports High Capacity RMON for a particular
dataSource." dataSource."
::= { dsStatsEntry 7 } ::= { dsmonStatsEntry 7 }
dsStatsOutPkts OBJECT-TYPE dsmonStatsOutPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of packets using a particular DSCP value, "The number of packets using a particular DSCP value,
received on a full-duplex link in the direction of the received on a full-duplex link in the direction of the
network." network."
::= { dsStatsEntry 8 } ::= { dsmonStatsEntry 8 }
dsStatsOutOctets OBJECT-TYPE dsmonStatsOutOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of octets in packets, using a particular DSCP "The number of octets in packets, using a particular DSCP
value, received on a full-duplex link in the direction of value, received on a full-duplex link in the direction of
the network." the network."
::= { dsStatsEntry 9 } ::= { dsmonStatsEntry 9 }
dsStatsOutOvflPkts OBJECT-TYPE dsmonStatsOutOvflPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times the associated dsStatsOutPkts counter "The number of times the associated dsmonStatsOutPkts
has overflowed. Note that this object will only be counter has overflowed. Note that this object will only be
instantiated if the associated dsStatsOutHCPkts object is instantiated if the associated dsmonStatsOutHCPkts object is
also instantiated for a particular dataSource." also instantiated for a particular dataSource."
::= { dsStatsEntry 10 } ::= { dsmonStatsEntry 10 }
dsStatsOutOvflOctets OBJECT-TYPE dsmonStatsOutOvflOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times the associated dsStatsOutOctets counter "The number of times the associated dsmonStatsOutOctets
has overflowed. Note that this object will only be counter has overflowed. Note that this object will only be
instantiated if the associated dsStatsOutHCOctets object is instantiated if the associated dsmonStatsOutHCOctets object
also instantiated for a particular dataSource." is also instantiated for a particular dataSource."
::= { dsStatsEntry 11 } ::= { dsmonStatsEntry 11 }
dsStatsOutHCPkts OBJECT-TYPE dsmonStatsOutHCPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter64 SYNTAX ZeroBasedCounter64
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The 64-bit version of the dsStatsOutPkts object. "The 64-bit version of the dsmonStatsOutPkts object.
Note that this object will only be instantiated if the RMON Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular agent supports High Capacity RMON for a particular
dataSource." dataSource."
::= { dsStatsEntry 12 } ::= { dsmonStatsEntry 12 }
dsStatsOutHCOctets OBJECT-TYPE dsmonStatsOutHCOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter64 SYNTAX ZeroBasedCounter64
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The 64-bit version of the dsStatsOutOctets object. "The 64-bit version of the dsmonStatsOutOctets object.
Note that this object will only be instantiated if the RMON Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular agent supports High Capacity RMON for a particular
dataSource." dataSource."
::= { dsStatsEntry 13 } ::= { dsmonStatsEntry 13 }
-- *********************************************************** -- ***********************************************************
-- * * -- * *
-- * P E R - P R O T O C O L C O L L E C T I O N S * -- * 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 -- DSCP Per-Protocol Statistics Control Table
-- --
dsPdistControlTable OBJECT-TYPE dsmonPdistControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsPdistControlEntry SYNTAX SEQUENCE OF DsmonPdistControlEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Controls the setup of per-protocol per-DSCP distribution "Controls the setup of per-application per-DSCP distribution
statistics." statistics."
::= { dsPdistObjects 1 } ::= { dsmonPdistObjects 1 }
dsPdistControlEntry OBJECT-TYPE dsmonPdistControlEntry OBJECT-TYPE
SYNTAX DsPdistControlEntry SYNTAX DsmonPdistControlEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A conceptual row in the dsPdistControlTable. "A conceptual row in the dsmonPdistControlTable.
Entries are created and deleted from this table by Entries are created and deleted from this table by
management action only, using the dsPdistControlStatus management action only, using the dsmonPdistControlStatus
RowStatus object. RowStatus object.
Activation of a control row in this table will cause an Activation of a control row in this table will cause an
associated dsPdistStatsTable to be created and maintained by associated dsmonPdistStatsTable to be created and maintained
the agent." by the agent."
INDEX { dsPdistControlIndex } INDEX { dsmonPdistControlIndex }
::= { dsPdistControlTable 1 } ::= { dsmonPdistControlTable 1 }
DsPdistControlEntry ::= SEQUENCE { DsmonPdistControlEntry ::= SEQUENCE {
dsPdistControlIndex Integer32, dsmonPdistControlIndex Integer32,
dsPdistControlDataSource DataSource, dsmonPdistControlDataSource DataSource,
dsPdistControlMaxDesiredEntries Integer32, dsmonPdistControlMaxDesiredEntries Integer32,
dsPdistControlCollectMode INTEGER, dsmonPdistControlDroppedFrames Counter32,
dsPdistControlDroppedFrames Counter32, dsmonPdistControlInserts Counter32,
dsPdistControlInserts Counter32, dsmonPdistControlDeletes Counter32,
dsPdistControlDeletes Counter32, dsmonPdistControlCreateTime LastCreateTime,
dsPdistControlCreateTime LastCreateTime, dsmonPdistControlOwner OwnerString,
dsPdistControlOwner OwnerString, dsmonPdistControlStatus RowStatus
dsPdistControlStatus RowStatus
} }
dsPdistControlIndex OBJECT-TYPE dsmonPdistControlIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535) SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An arbitrary and unique index for this "An arbitrary and unique index for this
dsPdistControlEntry." dsmonPdistControlEntry."
::= { dsPdistControlEntry 1 } ::= { dsmonPdistControlEntry 1 }
dsPdistControlDataSource OBJECT-TYPE dsmonPdistControlDataSource OBJECT-TYPE
SYNTAX DataSource SYNTAX DataSource
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The source of data for the this per-protocol DSCP "The source of data for the this per-protocol DSCP
distribution. distribution.
The statistics in this group reflect all IPv4 and IPv6 The statistics in this group reflect all IPv4 and IPv6
packets on the local network segment attached to the packets on the local network segment attached to the
identified interface. identified interface.
This object may not be modified if the associated This object may not be modified if the associated
dsPdistControlStatus object is equal to active(1)." dsmonPdistControlStatus object is equal to active(1)."
::= { dsPdistControlEntry 2 } ::= { dsmonPdistControlEntry 2 }
dsPdistControlMaxDesiredEntries OBJECT-TYPE dsmonPdistControlMaxDesiredEntries OBJECT-TYPE
SYNTAX Integer32 (-1 | 1..2147483647) SYNTAX Integer32 (-1 | 1..2147483647)
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The maximum number of entries that are desired in the "The maximum number of entries that are desired in the
dsPdistStatsTable on behalf of this control entry. The probe dsmonPdistStatsTable on behalf of this control entry. The
will not create more than this number of associated entries probe will not create more than this number of associated
in the table, but may choose to create fewer entries in this entries in the table, but may choose to create fewer entries
table for any reason including the lack of resources. in this table for any reason including the lack of
resources.
If this value is set to -1, the probe may create any number If this value is set to -1, the probe may create any number
of entries in this table. of entries in this table.
This object may not be modified if the associated This object may not be modified if the associated
dsPdistControlStatus object is equal to active(1)." dsmonPdistControlStatus object is equal to active(1)."
::= { dsPdistControlEntry 3 } ::= { 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 OBJECT-TYPE dsmonPdistControlDroppedFrames OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
UNITS "frames"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The total number of frames which were received by the probe "The total number of frames which were received by the probe
and therefore not accounted for in the *StatsDropEvents, but and therefore not accounted for in the *StatsDropEvents, but
for which the probe chose not to count for this entry for for which the probe chose not to count for this entry for
whatever reason. Most often, this event occurs when the whatever reason. Most often, this event occurs when the
probe is out of some resources and decides to shed load from probe is out of some resources and decides to shed load from
this collection. this collection.
This count does not include packets that were not counted This count does not include packets that were not counted
because they had MAC-layer errors. because they had MAC-layer errors.
Note that, unlike the dropEvents counter, this number is the Note that, unlike the dropEvents counter, this number is the
exact number of frames dropped." exact number of frames dropped."
::= { dsPdistControlEntry 5 } ::= { dsmonPdistControlEntry 4 }
dsPdistControlInserts OBJECT-TYPE dsmonPdistControlInserts OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
UNITS "table entries"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times a dsPdist entry has been inserted into "The number of times a dsmonPdist entry has been inserted
the dsPdistTable. If an entry is inserted, then deleted, into the dsmonPdistTable. If an entry is inserted, then
and then inserted, this counter will be incremented by 2. deleted, and then inserted, this counter will be incremented
by 2.
To allow for efficient implementation strategies, agents may To allow for efficient implementation strategies, agents may
delay updating this object for short periods of time. For delay updating this object for short periods of time. For
example, an implementation strategy may allow internal data example, an implementation strategy may allow internal data
structures to differ from those visible via SNMP for short structures to differ from those visible via SNMP for short
periods of time. This counter may reflect the internal data periods of time. This counter may reflect the internal data
structures for those short periods of time. structures for those short periods of time.
Note that the table size can be determined by subtracting Note that the table size can be determined by subtracting
dsPdistControlDeletes from dsPdistControlInserts." dsmonPdistControlDeletes from dsmonPdistControlInserts."
::= { dsPdistControlEntry 6 } ::= { dsmonPdistControlEntry 5 }
dsPdistControlDeletes OBJECT-TYPE dsmonPdistControlDeletes OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
UNITS "table entries"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times a dsPdist entry has been deleted from "The number of times a dsmonPdist entry has been deleted
the dsPdist table (for any reason). If an entry is deleted, from the dsmonPdist table (for any reason). If an entry is
then inserted, and then deleted, this counter will be deleted, then inserted, and then deleted, this counter will
incremented by 2. be incremented by 2.
To allow for efficient implementation strategies, agents may To allow for efficient implementation strategies, agents may
delay updating this object for short periods of time. For delay updating this object for short periods of time. For
example, an implementation strategy may allow internal data example, an implementation strategy may allow internal data
structures to differ from those visible via SNMP for short structures to differ from those visible via SNMP for short
periods of time. This counter may reflect the internal data periods of time. This counter may reflect the internal data
structures for those short periods of time. structures for those short periods of time.
Note that the table size can be determined by subtracting Note that the table size can be determined by subtracting
dsPdistControlDeletes from dsPdistControlInserts." dsmonPdistControlDeletes from dsmonPdistControlInserts."
::= { dsPdistControlEntry 7 } ::= { dsmonPdistControlEntry 6 }
dsPdistControlCreateTime OBJECT-TYPE dsmonPdistControlCreateTime OBJECT-TYPE
SYNTAX LastCreateTime SYNTAX LastCreateTime
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of sysUpTime when this control entry was last "The value of sysUpTime when this control entry was last
activated. This can be used by the management station to activated. This can be used by the management station to
ensure that the table has not been deleted and recreated detect if the table has been deleted and recreated between
between polls." polls."
::= { dsPdistControlEntry 8 } ::= { dsmonPdistControlEntry 7 }
dsPdistControlOwner OBJECT-TYPE dsmonPdistControlOwner OBJECT-TYPE
SYNTAX OwnerString SYNTAX OwnerString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The entity that configured this entry and is therefore "The entity that configured this entry and is therefore
using the resources assigned to it." using the resources assigned to it."
::= { dsPdistControlEntry 9 } ::= { dsmonPdistControlEntry 8 }
dsPdistControlStatus OBJECT-TYPE dsmonPdistControlStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row. "The status of this row.
An entry may not exist in the active state unless all An entry may not exist in the active state unless all
objects in the entry have an appropriate value. objects in the entry have an appropriate value.
If this object is not equal to active(1), all associated If this object is not equal to active(1), all associated
entries in the dsPdistStatsTable shall be deleted." entries in the dsmonPdistStatsTable shall be deleted."
::= { dsPdistControlEntry 10 } ::= { dsmonPdistControlEntry 9 }
-- --
-- Per-Protocol Statistics Table -- Per-Protocol Statistics Table
-- --
dsPdistStatsTable OBJECT-TYPE dsmonPdistStatsTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsPdistStatsEntry SYNTAX SEQUENCE OF DsmonPdistStatsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A list of information on Per Protocol DSCP usage." "A list of information on Per Protocol DSCP usage."
::= { dsPdistObjects 2 } ::= { dsmonPdistObjects 2 }
dsPdistStatsEntry OBJECT-TYPE dsmonPdistStatsEntry OBJECT-TYPE
SYNTAX DsPdistStatsEntry SYNTAX DsmonPdistStatsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A list of information on Differentiated Services DSCP "A list of information on Differentiated Services DSCP
usage, containing packet and octet counters for each DSCP usage, containing packet and octet counters for each DSCP
configured for collection, and each protocol (as identified configured for collection, and each protocol (as identified
by the protocolDirLocalIndex for the protocol) identified in by the protocolDirLocalIndex for the protocol) identified in
each monitored packet. each monitored packet.
The dsPdistControlIndex value in the index identifies the The dsmonPdistControlIndex value in the index identifies the
dsPdistControlEntry on whose behalf this entry was created. dsmonPdistControlEntry on whose behalf this entry was
created.
Only entries with non-zero statistics will be returned by Only entries with non-zero statistics will be returned by
the agent, in order to reduce the amount of polling required the agent, in order to reduce the amount of polling required
to retrieve data from this table. That is, an entry will be to retrieve data from this table. That is, an entry will be
created when a packet of that type and DSCP value is created when a packet of that type and DSCP value is
detected by the agent. detected by the agent.
Note that only protocols which are encapsulated in IPv4 or Note that only protocols which are encapsulated in IPv4 or
IPv6 packets will be counted in this table, as indicated by IPv6 packets will be counted in this table, as indicated by
the protocolDirTable configuration. 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 An example of the indexing of this entry is
dsPdistStatsPkts.9.29943.42.16." dsmonPdistStatsPkts.9.29943.42.16."
INDEX { dsPdistControlIndex, INDEX { dsmonPdistControlIndex,
dsPdistTimeMark, dsmonPdistTimeMark,
protocolDirLocalIndex, protocolDirLocalIndex,
dsPdistDsCodept } dsmonPdistDsCodept }
::= { dsPdistStatsTable 1 } ::= { dsmonPdistStatsTable 1 }
DsPdistStatsEntry ::= SEQUENCE { DsmonPdistStatsEntry ::= SEQUENCE {
dsPdistTimeMark TimeFilter, dsmonPdistTimeMark TimeFilter,
dsPdistDsCodept DSCodePoint, dsmonPdistDsCodept DSCodePoint,
dsPdistStatsPkts ZeroBasedCounter32, dsmonPdistStatsPkts ZeroBasedCounter32,
dsPdistStatsOctets ZeroBasedCounter32, dsmonPdistStatsOctets ZeroBasedCounter32,
dsPdistStatsOvflPkts ZeroBasedCounter32, dsmonPdistStatsOvflPkts ZeroBasedCounter32,
dsPdistStatsOvflOctets ZeroBasedCounter32, dsmonPdistStatsOvflOctets ZeroBasedCounter32,
dsPdistStatsHCPkts ZeroBasedCounter64, dsmonPdistStatsHCPkts ZeroBasedCounter64,
dsPdistStatsHCOctets ZeroBasedCounter64, dsmonPdistStatsHCOctets ZeroBasedCounter64,
dsPdistStatsCreateTime LastCreateTime dsmonPdistStatsCreateTime LastCreateTime
} }
dsPdistTimeMark OBJECT-TYPE dsmonPdistTimeMark OBJECT-TYPE
SYNTAX TimeFilter SYNTAX TimeFilter
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The Time Filter index for this table. This object may be "The Time Filter index for this table. This object may be
used by a management station to retrieve only rows which used by a management station to retrieve only rows which
have been created or modified since a particular time. Note have been created or modified since a particular time. Note
that the current value for a row are always returned and the that the current value for a row are always returned and the
TimeFilter is not a historical data archiving mechanism. TimeFilter is not a historical data archiving mechanism.
Refer to RFC 2021 [RFC2021] for a detailed description of Refer to RFC 2021 [RFC2021] for a detailed description of
TimeFilter operation." TimeFilter operation."
::= { dsPdistStatsEntry 1 } ::= { dsmonPdistStatsEntry 1 }
dsPdistDsCodept OBJECT-TYPE dsmonPdistDsCodept OBJECT-TYPE
SYNTAX DSCodePoint SYNTAX DSCodePoint
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The DSCP value associated with the aggregated statistics "The DSCP value associated with the aggregated statistics
for a particular protocol." for a particular protocol."
::= { dsmonPdistStatsEntry 2 }
::= { dsPdistStatsEntry 2 } dsmonPdistStatsPkts OBJECT-TYPE
dsPdistStatsPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of packets, monitored by this agent, and "The number of packets, monitored by this agent, and
identified to be using a particular DSCP value in the DS identified to be using a particular DSCP value in the DS
header, on behalf of the protocol identified by the header, on behalf of the protocol identified by the
associated protocolDirLocalIndex value." associated protocolDirLocalIndex value."
::= { dsPdistStatsEntry 3 } ::= { dsmonPdistStatsEntry 3 }
dsPdistStatsOctets OBJECT-TYPE dsmonPdistStatsOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of octets in packets, monitored by this agent "The number of octets in packets, monitored by this agent
and identified to be using a particular DSCP value in the DS and identified to be using a particular DSCP value in the DS
header, on behalf of the protocol identified by the header, on behalf of the protocol identified by the
associated protocolDirLocalIndex value. associated protocolDirLocalIndex value.
Note that this object doesn't count just those octets in the Note that this object doesn't count just those octets in the
particular protocol frames, but includes the entire packet particular protocol frames, but includes the entire packet
that contained the protocol." that contained the protocol."
::= { dsPdistStatsEntry 4 } ::= { dsmonPdistStatsEntry 4 }
dsPdistStatsOvflPkts OBJECT-TYPE dsmonPdistStatsOvflPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times the associated dsPdistStatsPkts counter "The number of times the associated dsmonPdistStatsPkts
has overflowed. Note that this object will only be counter has overflowed. Note that this object will only be
instantiated if the associated dsPdistStatsHCPkts object is instantiated if the associated dsmonPdistStatsHCPkts object
also instantiated for a particular dataSource." is also instantiated for a particular dataSource."
::= { dsPdistStatsEntry 5 } ::= { dsmonPdistStatsEntry 5 }
dsPdistStatsOvflOctets OBJECT-TYPE dsmonPdistStatsOvflOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times the associated dsPdistStatsOctets "The number of times the associated dsmonPdistStatsOctets
counter has overflowed. Note that this object will only be counter has overflowed. Note that this object will only be
instantiated if the associated dsPdistStatsHCOctets object instantiated if the associated dsmonPdistStatsHCOctets
is also instantiated for a particular dataSource." object is also instantiated for a particular dataSource."
::= { dsPdistStatsEntry 6 } ::= { dsmonPdistStatsEntry 6 }
dsPdistStatsHCPkts OBJECT-TYPE dsmonPdistStatsHCPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter64 SYNTAX ZeroBasedCounter64
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The 64-bit version of the dsPdistStatsPkts object. "The 64-bit version of the dsmonPdistStatsPkts object.
Note that this object will only be instantiated if the RMON Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular agent supports High Capacity RMON for a particular
dataSource." dataSource."
::= { dsPdistStatsEntry 7 } ::= { dsmonPdistStatsEntry 7 }
dsPdistStatsHCOctets OBJECT-TYPE dsmonPdistStatsHCOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter64 SYNTAX ZeroBasedCounter64
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The 64-bit version of the dsPdistStatsOctets object. "The 64-bit version of the dsmonPdistStatsOctets object.
Note that this object will only be instantiated if the RMON Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular agent supports High Capacity RMON for a particular
dataSource." dataSource."
::= { dsPdistStatsEntry 8 } ::= { dsmonPdistStatsEntry 8 }
dsPdistStatsCreateTime OBJECT-TYPE dsmonPdistStatsCreateTime OBJECT-TYPE
SYNTAX LastCreateTime SYNTAX LastCreateTime
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of sysUpTime when this dsPdistStats entry was "The value of sysUpTime when this dsmonPdistStats entry was
last instantiated by the agent. This can be used by the last instantiated by the agent. This can be used by the
management station to ensure that the entry has not been management station to detect if the entry has been deleted
deleted and recreated between polls." and recreated between polls."
::= { dsPdistStatsEntry 9 } ::= { dsmonPdistStatsEntry 9 }
-- --
-- Per-Protocol Statistics TopN Control Table -- Per-Protocol Statistics TopN Control Table
-- --
dsPdistTopNControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsPdistTopNControlEntry dsmonPdistTopNControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsmonPdistTopNControlEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A set of parameters that control the creation of a report "A set of parameters that control the creation of a report
of the top N dsPdist entries according to a selected of the top N dsmonPdist entries according to a selected
metric." metric."
::= { dsPdistObjects 3 } ::= { dsmonPdistObjects 3 }
dsPdistTopNControlEntry OBJECT-TYPE dsmonPdistTopNControlEntry OBJECT-TYPE
SYNTAX DsPdistTopNControlEntry SYNTAX DsmonPdistTopNControlEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A conceptual row in the dsPdistTopNControlTable. "A conceptual row in the dsmonPdistTopNControlTable.
Entries are created and deleted from this table by Entries are created and deleted from this table by
management action only, using the dsPdistTopNControlStatus management action only, using the
RowStatus object. dsmonPdistTopNControlStatus RowStatus object.
Activation of a control row in this table will cause an Activation of a control row in this table will cause an
associated dsPdistTopNTable to be created and maintained by associated dsmonPdistTopNTable to be created and maintained
the agent." by the agent."
INDEX { dsPdistTopNControlIndex } INDEX { dsmonPdistTopNControlIndex }
::= { dsPdistTopNControlTable 1 } ::= { dsmonPdistTopNControlTable 1 }
DsPdistTopNControlEntry ::= SEQUENCE { DsmonPdistTopNControlEntry ::= SEQUENCE {
dsPdistTopNControlIndex Integer32, dsmonPdistTopNControlIndex Integer32,
dsPdistTopNControlPdistIndex Integer32, dsmonPdistTopNControlPdistIndex Integer32,
dsPdistTopNControlRateBase INTEGER, dsmonPdistTopNControlRateBase INTEGER,
dsPdistTopNControlTimeRemaining Integer32, dsmonPdistTopNControlTimeRemaining Integer32,
dsPdistTopNControlGeneratedReports Counter32, dsmonPdistTopNControlGeneratedReports Counter32,
dsPdistTopNControlDuration Integer32, dsmonPdistTopNControlDuration Integer32,
dsPdistTopNControlRequestedSize Integer32, dsmonPdistTopNControlRequestedSize Integer32,
dsPdistTopNControlGrantedSize Integer32, dsmonPdistTopNControlGrantedSize Integer32,
dsPdistTopNControlStartTime TimeStamp, dsmonPdistTopNControlStartTime TimeStamp,
dsPdistTopNControlOwner OwnerString, dsmonPdistTopNControlOwner OwnerString,
dsPdistTopNControlStatus RowStatus dsmonPdistTopNControlStatus RowStatus
} }
dsPdistTopNControlIndex OBJECT-TYPE dsmonPdistTopNControlIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535) SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An index that uniquely identifies an entry in the "An index that uniquely identifies an entry in the
dsPdistTopNControlTable. Each such entry defines one Top N dsmonPdistTopNControlTable. Each such entry defines one Top
report prepared for one RMON dataSource." N report prepared for one RMON dataSource."
::= { dsPdistTopNControlEntry 1 } ::= { dsmonPdistTopNControlEntry 1 }
dsPdistTopNControlPdistIndex OBJECT-TYPE dsmonPdistTopNControlPdistIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535) SYNTAX Integer32 (1..65535)
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The dsPdistTable for which a top N report will be prepared "The dsmonPdistTable for which a top N report will be
on behalf of this entry. The dsPdistTable is identified by prepared on behalf of this entry. The dsmonPdistTable is
the value of the dsPdistControlIndex for that table - that identified by the value of the dsmonPdistControlIndex for
value is used here to identify the particular table. that table - that value is used here to identify the
particular table.
This object may not be modified if the associated This object may not be modified if the associated
dsPdistTopNControlStatus object is equal to active(1)." dsmonPdistTopNControlStatus object is equal to active(1)."
::= { dsPdistTopNControlEntry 2 } ::= { dsmonPdistTopNControlEntry 2 }
dsPdistTopNControlRateBase OBJECT-TYPE dsmonPdistTopNControlRateBase OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
dsPdistTopNPkts(1), dsmonPdistTopNPkts(1),
dsPdistTopNOctets(2), dsmonPdistTopNOctets(2),
dsPdistTopNHCPkts(3), dsmonPdistTopNHCPkts(3),
dsPdistTopNHCOctets(4) dsmonPdistTopNHCOctets(4)
} }
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The variable for each dsPdist that the dsPdistTopNRate and "The variable for each dsmonPdist that the
dsPdistTopNHCRate variables are based upon. Each dsmonPdistTopNRate and dsmonPdistTopNHCRate variables are
dsPdistTopN report generated on behalf of this control entry based upon. Each dsmonPdistTopN report generated on behalf
will be ranked in descending order, based on the associated of this control entry will be ranked in descending order,
dsPdistStatsTable counter, identified by this object. based on the associated dsmonPdistStatsTable counter,
identified by this object.
The following table identifies the dsPdistTable counter The following table identifies the dsmonPdistTable counter
associated with each enumeration: associated with each enumeration:
Enumeration RateBase MIB Object Enumeration RateBase MIB Object
----------- ------------------- ----------- -------------------
dsPdistTopNPkts dsPdistStatsPkts dsmonPdistTopNPkts dsmonPdistStatsPkts
dsPdistTopNOctets dsPdistStatsOctets dsmonPdistTopNOctets dsmonPdistStatsOctets
dsPdistTopNHCPkts dsPdistStatsHCPkts dsmonPdistTopNHCPkts dsmonPdistStatsHCPkts
dsPdistTopNHCOctets dsPdistStatsHCOctets dsmonPdistTopNHCOctets dsmonPdistStatsHCOctets
Note that the dsPdistTopNHCPkts and dsPdistTopNHCOctets
enumerations are only available if the agent supports High Note that the dsmonPdistTopNHCPkts and
Capacity RMON collection. dsmonPdistTopNHCOctets enumerations are only available if
the agent supports High Capacity RMON collection.
This object may not be modified if the associated This object may not be modified if the associated
dsPdistTopNControlStatus object is equal to active(1)." dsmonPdistTopNControlStatus object is equal to active(1)."
::= { dsPdistTopNControlEntry 3 } ::= { dsmonPdistTopNControlEntry 3 }
dsPdistTopNControlTimeRemaining OBJECT-TYPE dsmonPdistTopNControlTimeRemaining OBJECT-TYPE
SYNTAX Integer32 (0..2147483647) SYNTAX Integer32 (0..2147483647)
UNITS "seconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of seconds left in the report currently being "The number of seconds left in the report currently being
collected. When this object is modified by the management collected. When this object is modified by the management
station, a new collection is started, possibly aborting a station, a new collection is started, possibly aborting a
currently running report. The new value is used as the currently running report. The new value is used as the
requested duration of this report, and is immediately loaded requested duration of this report, and is immediately loaded
into the associated dsPdistTopNControlDuration object. into the associated dsmonPdistTopNControlDuration object.
When the report finishes, the probe will automatically start When the report finishes, the probe will automatically start
another collection with the same initial value of another collection with the same initial value of
dsPdistTopNControlTimeRemaining. Thus the management dsmonPdistTopNControlTimeRemaining. Thus the management
station may simply read the resulting reports repeatedly, station may simply read the resulting reports repeatedly,
checking the startTime and duration each time to ensure that checking the startTime and duration each time to ensure that
a report was not missed or that the report parameters were a report was not missed or that the report parameters were
not changed. not changed.
While the value of this object is non-zero, it decrements by While the value of this object is non-zero, it decrements by
one per second until it reaches zero. At the time that this one per second until it reaches zero. At the time that this
object decrements to zero, the report is made accessible in object decrements to zero, the report is made accessible in
the dsPdistTopNTable, overwriting any report that may be the dsmonPdistTopNTable, overwriting any report that may be
there. there.
When this object is modified by the management station, any When this object is modified by the management station, any
associated entries in the dsPdistTopNTable shall be associated entries in the dsmonPdistTopNTable shall be
deleted." deleted."
DEFVAL { 1800 } DEFVAL { 1800 }
::= { dsPdistTopNControlEntry 4 } ::= { dsmonPdistTopNControlEntry 4 }
dsPdistTopNControlGeneratedReports OBJECT-TYPE dsmonPdistTopNControlGeneratedReports OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
UNITS "reports"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of reports that have been generated by this "The number of reports that have been generated by this
entry." entry."
::= { dsPdistTopNControlEntry 5 } ::= { dsmonPdistTopNControlEntry 5 }
dsPdistTopNControlDuration OBJECT-TYPE dsmonPdistTopNControlDuration OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
UNITS "seconds"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of seconds that this report has collected during "The number of seconds that this report has collected during
the last sampling interval. the last sampling interval.
When the associated dsPdistTopNControlTimeRemaining object When the associated dsmonPdistTopNControlTimeRemaining
is set, this object shall be set by the probe to the same object is set, this object shall be set by the probe to the
value and shall not be modified until the next time the same value and shall not be modified until the next time the
dsPdistTopNControlTimeRemaining is set. dsmonPdistTopNControlTimeRemaining is set.
This value shall be zero if no reports have been requested This value shall be zero if no reports have been requested
for this dsPdistTopNControlEntry." for this dsmonPdistTopNControlEntry."
::= { dsPdistTopNControlEntry 6 } ::= { dsmonPdistTopNControlEntry 6 }
dsPdistTopNControlRequestedSize OBJECT-TYPE dsmonPdistTopNControlRequestedSize OBJECT-TYPE
SYNTAX Integer32 (0..2147483647) SYNTAX Integer32 (0..2147483647)
UNITS "table entries"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The maximum number of dsPdist entries requested for this "The maximum number of dsmonPdist entries requested for this
report. report.
When this object is created or modified, the probe should When this object is created or modified, the probe should
set dsPdistTopNControlGrantedSize as closely to this object set dsmonPdistTopNControlGrantedSize as closely to this
as is possible for the particular probe implementation and object as is possible for the particular probe
available resources." implementation and available resources."
DEFVAL { 150 } DEFVAL { 150 }
::= { dsPdistTopNControlEntry 7 } ::= { dsmonPdistTopNControlEntry 7 }
dsPdistTopNControlGrantedSize OBJECT-TYPE dsmonPdistTopNControlGrantedSize OBJECT-TYPE
SYNTAX Integer32 (0..2147483647) SYNTAX Integer32 (0..2147483647)
UNITS "table entries"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The maximum number of dsPdist entries in this report. "The maximum number of dsmonPdist entries in this report.
When the associated dsPdistTopNControlRequestedSize object When the associated dsmonPdistTopNControlRequestedSize
is created or modified, the probe should set this object as object is created or modified, the probe should set this
closely to the requested value as is possible for the object as closely to the requested value as is possible for
particular implementation and available resources. The probe the particular implementation and available resources. The
must not lower this value except as a result of a set to the probe must not lower this value except as a result of a set
associated dsPdistTopNControlRequestedSize object. to the associated dsmonPdistTopNControlRequestedSize object.
When the associated dsPdistTopNControlRequestedSize object When the associated dsmonPdistTopNControlRequestedSize
is created or modified, the probe should set this object as object is created or modified, the probe should set this
closely to the requested value as is possible for the object as closely to the requested value as is possible for
particular implementation and available resources. The probe the particular implementation and available resources. The
must not lower this value except as a result of a set to the probe must not lower this value except as a result of a set
associated dsPdistTopNControlRequestedSize object. to the associated dsmonPdistTopNControlRequestedSize object.
Protocol entries with the highest value of dsPdistTopNRate Protocol entries with the highest value of
or dsPdistTopNHCRate (depending on the value of the dsmonPdistTopNRate or dsmonPdistTopNHCRate (depending on the
associated dsPdistTopNControlRateBase object) shall be value of the associated dsmonPdistTopNControlRateBase
placed in this table in decreasing order of this rate until object) shall be placed in this table in decreasing order of
there is no more room or until there are no more dsPdist this rate until there is no more room or until there are no
entries." more dsmonPdist entries."
::= { dsPdistTopNControlEntry 8 } ::= { dsmonPdistTopNControlEntry 8 }
dsPdistTopNControlStartTime OBJECT-TYPE dsmonPdistTopNControlStartTime OBJECT-TYPE
SYNTAX TimeStamp SYNTAX TimeStamp
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of sysUpTime when this top N report was last "The value of sysUpTime when this top N report was last
started. In other words, this is the time that the started. In other words, this is the time that the
associated dsPdistTopNControlTimeRemaining object was associated dsmonPdistTopNControlTimeRemaining object was
modified to start the requested report or the time the modified to start the requested report or the time the
report was last automatically (re)started. report was last automatically (re)started.
This object may be used by the management station to This object may be used by the management station to
determine if a report was missed or not." determine if a report was missed or not."
::= { dsPdistTopNControlEntry 9 } ::= { dsmonPdistTopNControlEntry 9 }
dsPdistTopNControlOwner OBJECT-TYPE dsmonPdistTopNControlOwner OBJECT-TYPE
SYNTAX OwnerString SYNTAX OwnerString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The entity that configured this entry and is therefore "The entity that configured this entry and is therefore
using the resources assigned to it." using the resources assigned to it."
::= { dsPdistTopNControlEntry 10 } ::= { dsmonPdistTopNControlEntry 10 }
dsPdistTopNControlStatus OBJECT-TYPE dsmonPdistTopNControlStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this dsPdistTopNControlEntry. "The status of this dsmonPdistTopNControlEntry.
An entry may not exist in the active state unless all An entry may not exist in the active state unless all
objects in the entry have an appropriate value. objects in the entry have an appropriate value.
If this object is not equal to active(1), all associated If this object is not equal to active(1), all associated
entries in the dsPdistTopNTable shall be deleted by the entries in the dsmonPdistTopNTable shall be deleted by the
agent." agent."
::= { dsPdistTopNControlEntry 11 } ::= { dsmonPdistTopNControlEntry 11 }
-- --
-- dsmonPdist TopN Table
-- --
dsPdistTopNTable OBJECT-TYPE dsmonPdistTopNTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsPdistTopNEntry SYNTAX SEQUENCE OF DsmonPdistTopNEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A set of statistics for those protocol distribution entries "A set of statistics for those protocol distribution entries
that have counted the highest number of octets or packets. that have counted the highest number of octets or packets.
Note that dsPdist entries which did not increment at all Note that dsmonPdist entries which did not increment at all
during the report interval are not included in dsPdistTopN during the report interval are not included in
reports." dsmonPdistTopN reports."
::= { dsPdistObjects 4 } ::= { dsmonPdistObjects 4 }
dsPdistTopNEntry OBJECT-TYPE dsmonPdistTopNEntry OBJECT-TYPE
SYNTAX DsPdistTopNEntry SYNTAX DsmonPdistTopNEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A conceptual row in the dsPdistTopNTable. "A conceptual row in the dsmonPdistTopNTable.
The dsPdistTopNControlIndex value in the index identifies The dsmonPdistTopNControlIndex value in the index identifies
the dsPdistTopNControlEntry on whose behalf this entry was the dsmonPdistTopNControlEntry on whose behalf this entry
created." was created."
INDEX { dsPdistTopNControlIndex, dsPdistTopNIndex } INDEX { dsmonPdistTopNControlIndex, dsmonPdistTopNIndex }
::= { dsPdistTopNTable 1 } ::= { dsmonPdistTopNTable 1 }
DsPdistTopNEntry ::= SEQUENCE { DsmonPdistTopNEntry ::= SEQUENCE {
dsPdistTopNIndex Integer32, dsmonPdistTopNIndex Integer32,
dsPdistTopNProtocolDirLocalIndex Integer32, dsmonPdistTopNProtocolDirLocalIndex Integer32,
dsPdistTopNDsCodept DSCodePoint, dsmonPdistTopNDsCodept DSCodePoint,
dsPdistTopNRate Gauge32, dsmonPdistTopNRate Gauge32,
dsPdistTopNRateOvfl Gauge32, dsmonPdistTopNRateOvfl Gauge32,
dsPdistTopNHCRate Counter64 -- Gauge64 dsmonPdistTopNHCRate Counter64 -- Gauge64
} }
dsPdistTopNIndex OBJECT-TYPE dsmonPdistTopNIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535) SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An index that uniquely identifies an entry in the "An index that uniquely identifies an entry in the
dsPdistTopNTable among those in the same report. This index dsmonPdistTopNTable among those in the same report. This
is between 1 and N, where N is the number of entries in this index is between 1 and N, where N is the number of entries
report." in this report."
::= { dsPdistTopNEntry 1 } ::= { dsmonPdistTopNEntry 1 }
dsPdistTopNProtocolDirLocalIndex OBJECT-TYPE dsmonPdistTopNProtocolDirLocalIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The protocolDirLocalIndex value which identifies the "The protocolDirLocalIndex value which identifies the
protocol associated with this entry." protocol associated with this entry."
::= { dsPdistTopNEntry 2 } ::= { dsmonPdistTopNEntry 2 }
dsPdistTopNDsCodept OBJECT-TYPE dsmonPdistTopNDsCodept OBJECT-TYPE
SYNTAX DSCodePoint SYNTAX DSCodePoint
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The DSCP value associated with protocol identified in this "The DSCP value associated with protocol identified in this
entry." entry."
::= { dsPdistTopNEntry 3 } ::= { dsmonPdistTopNEntry 3 }
dsPdistTopNRate OBJECT-TYPE dsmonPdistTopNRate OBJECT-TYPE
SYNTAX Gauge32 SYNTAX Gauge32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The amount of change in the selected variable during this "The amount of change in the selected variable during this
sampling interval. The selected variable is this protocol's sampling interval. The selected variable is this protocol's
instance of the object selected by instance of the object selected by
dsPdistTopNControlRateBase. dsmonPdistTopNControlRateBase.
If the associated dsPdistTopNControlRateBase is equal to If the associated dsmonPdistTopNControlRateBase is equal to
'dsPdistTopNHCPkts' or 'dsPdistTopNHCOctets', then this 'dsmonPdistTopNHCPkts' or 'dsmonPdistTopNHCOctets', then
object will contain the the least significant 32 bits of the this object will contain the the least significant 32 bits
associated dsPdistTopNHCRate object." of the associated dsmonPdistTopNHCRate object."
::= { dsPdistTopNEntry 4 } ::= { dsmonPdistTopNEntry 4 }
dsPdistTopNRateOvfl OBJECT-TYPE dsmonPdistTopNRateOvfl OBJECT-TYPE
SYNTAX Gauge32 SYNTAX Gauge32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The most significant 32 bits of the associated "The most significant 32 bits of the associated
dsPdistTopNHCRate object. dsmonPdistTopNHCRate object.
If the associated dsPdistTopNControlRateBase is equal to If the associated dsmonPdistTopNControlRateBase is equal to
'dsPdistTopNHCPkts' or 'dsPdistTopNHCOctets', then this 'dsmonPdistTopNHCPkts' or 'dsmonPdistTopNHCOctets', then
object will contain the upper 32 bits of the associated this object will contain the upper 32 bits of the associated
dsPdistTopNHCRate object. dsmonPdistTopNHCRate object.
If the associated dsPdistTopNControlRateBase is equal to If the associated dsmonPdistTopNControlRateBase is equal to
'dsPdistTopNPkts' or 'dsPdistTopNOctets', then this object 'dsmonPdistTopNPkts' or 'dsmonPdistTopNOctets', then this
will contain the value zero. object will contain the value zero.
The agent may choose not to instantiate this object if High The agent may choose not to instantiate this object if High
Capacity RMON collection is not supported." Capacity RMON collection is not supported."
::= { dsPdistTopNEntry 5 } ::= { dsmonPdistTopNEntry 5 }
dsPdistTopNHCRate OBJECT-TYPE dsmonPdistTopNHCRate OBJECT-TYPE
SYNTAX Counter64 -- Gauge64 SYNTAX Counter64 -- Gauge64
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The amount of change in the selected variable during this "The amount of change in the selected variable during this
sampling interval. The selected variable is this protocol's sampling interval. The selected variable is this protocol's
instance of the object selected by instance of the object selected by
dsPdistTopNControlRateBase. dsmonPdistTopNControlRateBase.
If the associated dsPdistTopNControlRateBase is equal to If the associated dsmonPdistTopNControlRateBase is equal to
'dsPdistTopNPkts' or 'dsPdistTopNOctets', then this object 'dsmonPdistTopNPkts' or 'dsmonPdistTopNOctets', then this
will contain the value zero, and the associated object will contain the value zero, and the associated
dsPdistTopNRate object will contain the change in the dsmonPdistTopNRate object will contain the change in the
selected variable during the sampling interval. selected variable during the sampling interval.
The agent may choose not to instantiate this object if High The agent may choose not to instantiate this object if High
Capacity RMON collection is not supported." Capacity RMON collection is not supported."
::= { dsPdistTopNEntry 6 } ::= { dsmonPdistTopNEntry 6 }
-- *********************************************************** -- ***********************************************************
-- * * -- * *
-- * P E R - H O S T C O L L E C T I O N S * -- * P E R - H O S T C O L L E C T I O N S *
-- * * -- * *
-- *********************************************************** -- ***********************************************************
-- --
-- IP Host Statistics Control Table -- IP Host Statistics Control Table
-- --
dsHostControlTable OBJECT-TYPE dsmonHostControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsHostControlEntry SYNTAX SEQUENCE OF DsmonHostControlEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Controls setup of per DSCP, per IP host distribution "Controls setup of per DSCP, per IP host distribution
statistics." statistics."
::= { dsHostObjects 1 } ::= { dsmonHostObjects 1 }
dsHostControlEntry OBJECT-TYPE dsmonHostControlEntry OBJECT-TYPE
SYNTAX DsHostControlEntry SYNTAX DsmonHostControlEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A conceptual row in the dsHostControlTable. "A conceptual row in the dsmonHostControlTable.
Entries are created and deleted from this table by Entries are created and deleted from this table by
management action only, using the dsHostControlStatus management action only, using the dsmonHostControlStatus
RowStatus object. RowStatus object.
Activation of a control row in this table will cause an Activation of a control row in this table will cause an
associated dsHostTable to be created and maintained by the associated dsmonHostTable to be created and maintained by
agent." the agent."
INDEX { dsHostControlIndex } INDEX { dsmonHostControlIndex }
::= { dsHostControlTable 1 } ::= { dsmonHostControlTable 1 }
DsHostControlEntry ::= SEQUENCE { DsmonHostControlEntry ::= SEQUENCE {
dsHostControlIndex Integer32, dsmonHostControlIndex Integer32,
dsHostControlDataSource DataSource, dsmonHostControlDataSource DataSource,
dsHostControlMaxDesiredEntries Integer32, dsmonHostControlMaxDesiredEntries Integer32,
dsHostControlNumAddrBits Integer32, dsmonHostControlNumAddrBits Integer32,
dsHostControlDroppedFrames Counter32, dsmonHostControlDroppedFrames Counter32,
dsHostControlInserts Counter32, dsmonHostControlInserts Counter32,
dsHostControlDeletes Counter32, dsmonHostControlDeletes Counter32,
dsHostControlCreateTime LastCreateTime, dsmonHostControlCreateTime LastCreateTime,
dsHostControlOwner OwnerString, dsmonHostControlOwner OwnerString,
dsHostControlStatus RowStatus dsmonHostControlStatus RowStatus
} }
dsHostControlIndex OBJECT-TYPE dsmonHostControlIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535) SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An arbitrary and unique index for this dsHostControlEntry." "An arbitrary and unique index for this
::= { dsHostControlEntry 1 } dsmonHostControlEntry."
::= { dsmonHostControlEntry 1 }
dsHostControlDataSource OBJECT-TYPE dsmonHostControlDataSource OBJECT-TYPE
SYNTAX DataSource SYNTAX DataSource
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The source of data for the associated dsHostTable. "The source of data for the associated dsmonHostTable.
The statistics in this group reflect all IPv4 and IPv6 The statistics in this group reflect all IPv4 and IPv6
packets on the local network segment attached to the packets on the local network segment attached to the
identified interface. identified interface.
This object may not be modified if the associated This object may not be modified if the associated
dsHostControlStatus object is equal to active(1)." dsmonHostControlStatus object is equal to active(1)."
::= { dsHostControlEntry 2 } ::= { dsmonHostControlEntry 2 }
dsHostControlMaxDesiredEntries OBJECT-TYPE dsmonHostControlMaxDesiredEntries OBJECT-TYPE
SYNTAX Integer32 (-1 | 1..2147483647) SYNTAX Integer32 (-1 | 1..2147483647)
UNITS "table entries"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The maximum number of entries that are desired in the "The maximum number of entries that are desired in the
dsHostTable on behalf of this control entry. The probe will dsmonHostTable on behalf of this control entry. The probe
not create more than this number of associated entries in will not create more than this number of associated entries
the table, but may choose to create fewer entries in this in the table, but may choose to create fewer entries in this
table for any reason including the lack of resources. table for any reason including the lack of resources.
If this value is set to -1, the probe may create any number If this value is set to -1, the probe may create any number
of entries in this table. of entries in this table.
This object may not be modified if the associated This object may not be modified if the associated
dsHostControlStatus object is equal to active(1)." dsmonHostControlStatus object is equal to active(1)."
::= { dsHostControlEntry 3 } ::= { dsmonHostControlEntry 3 }
dsHostControlNumAddrBits OBJECT-TYPE dsmonHostControlNumAddrBits OBJECT-TYPE
SYNTAX Integer32 (8..32) SYNTAX Integer32 (8..32)
UNITS "bits"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of 'leftmost' contiguous bits in the IPv4 host "The number of 'leftmost' contiguous bits in the IPv4 host
address (as identified by the dsHostAddress object) that address (as identified by the dsmonHostAddress object) that
should be maintained in this collection. should be maintained in this collection.
If this object has a value less than '32', then 'm' If this object has a value less than '32', then 'm'
rightmost bits, where 'm' is equal to '32 - rightmost bits, where 'm' is equal to '32 -
dsHostControlNumAddrBits', will be cleared to zero for dsmonHostControlNumAddrBits', will be cleared to zero for
counting purposes only. The 'leftmost' bit is the most counting purposes only. The 'leftmost' bit is the most
significant bit of the first network-byte-order octet of the significant bit of the first network-byte-order octet of the
address. address.
Note that this object only affects IPv4 host entries in the Note that this object only affects IPv4 host entries in the
associated dsHostTable. IPv6 entries are not affected by associated dsmonHostTable. IPv6 entries are not affected by
this object. this object.
This object may not be modified if the associated This object may not be modified if the associated
dsHostControlStatus object is equal to active(1)." dsmonHostControlStatus object is equal to active(1)."
DEFVAL { 32 } DEFVAL { 32 }
::= { dsHostControlEntry 4 } ::= { dsmonHostControlEntry 4 }
dsHostControlDroppedFrames OBJECT-TYPE dsmonHostControlDroppedFrames OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
UNITS "frames"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The total number of frames which were received by the probe "The total number of frames which were received by the probe
and therefore not accounted for in the *StatsDropEvents, but and therefore not accounted for in the *StatsDropEvents, but
for which the probe chose not to count for the associated for which the probe chose not to count for the associated
dsHost entries for whatever reason. Most often, this event dsmonHost entries for whatever reason. Most often, this
occurs when the probe is out of some resources and decides event occurs when the probe is out of some resources and
to shed load from this collection. decides to shed load from this collection.
This count does not include packets that were not counted This count does not include packets that were not counted
because they had MAC-layer errors. because they had MAC-layer errors.
Note that if the dsHostTable is inactive because no Note that if the dsmonHostTable is inactive because no
appropriate protocols are enabled in the protocol directory, appropriate protocols are enabled in the protocol directory,
this value should be 0. this value should be 0.
Note that, unlike the dropEvents counter, this number is the Note that, unlike the dropEvents counter, this number is the
exact number of frames dropped." exact number of frames dropped."
::= { dsHostControlEntry 5 } ::= { dsmonHostControlEntry 5 }
dsHostControlInserts OBJECT-TYPE dsmonHostControlInserts OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
UNITS "table entries"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times a dsHost entry has been inserted into "The number of times a dsmonHost entry has been inserted
the dsHost table. If an entry is inserted, then deleted, into the dsmonHost table. If an entry is inserted, then
and then inserted, this counter will be incremented by 2. deleted, and then inserted, this counter will be incremented
by 2.
To allow for efficient implementation strategies, agents may To allow for efficient implementation strategies, agents may
delay updating this object for short periods of time. For delay updating this object for short periods of time. For
example, an implementation strategy may allow internal data example, an implementation strategy may allow internal data
structures to differ from those visible via SNMP for short structures to differ from those visible via SNMP for short
periods of time. This counter may reflect the internal data periods of time. This counter may reflect the internal data
structures for those short periods of time. structures for those short periods of time.
Note that the table size can be determined by subtracting Note that the table size can be determined by subtracting
dsHostControlDeletes from dsHostControlInserts." dsmonHostControlDeletes from dsmonHostControlInserts."
::= { dsHostControlEntry 6 } ::= { dsmonHostControlEntry 6 }
dsHostControlDeletes OBJECT-TYPE dsmonHostControlDeletes OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
UNITS "table entries"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times a dsHost entry has been deleted from "The number of times a dsmonHost entry has been deleted from
the dsHost table (for any reason). If an entry is deleted, the dsmonHost table (for any reason). If an entry is
then inserted, and then deleted, this counter will be deleted, then inserted, and then deleted, this counter will
incremented by 2. be incremented by 2.
To allow for efficient implementation strategies, agents may To allow for efficient implementation strategies, agents may
delay updating this object for short periods of time. For delay updating this object for short periods of time. For
example, an implementation strategy may allow internal data example, an implementation strategy may allow internal data
structures to differ from those visible via SNMP for short structures to differ from those visible via SNMP for short
periods of time. This counter may reflect the internal data periods of time. This counter may reflect the internal data
structures for those short periods of time. structures for those short periods of time.
Note that the table size can be determined by subtracting Note that the table size can be determined by subtracting
dsHostControlDeletes from dsHostControlInserts." dsmonHostControlDeletes from dsmonHostControlInserts."
::= { dsHostControlEntry 7 } ::= { dsmonHostControlEntry 7 }
dsHostControlCreateTime OBJECT-TYPE dsmonHostControlCreateTime OBJECT-TYPE
SYNTAX LastCreateTime SYNTAX LastCreateTime
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of sysUpTime when this control entry was last "The value of sysUpTime when this control entry was last
activated. This can be used by the management station to activated. This can be used by the management station to
ensure that the table has not been deleted and recreated detect if the table has been deleted and recreated between
between polls." polls. ***"
::= { dsHostControlEntry 8 } ::= { dsmonHostControlEntry 8 }
dsHostControlOwner OBJECT-TYPE dsmonHostControlOwner OBJECT-TYPE
SYNTAX OwnerString SYNTAX OwnerString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The entity that configured this entry and is therefore "The entity that configured this entry and is therefore
using the resources assigned to it." using the resources assigned to it."
::= { dsHostControlEntry 9 } ::= { dsmonHostControlEntry 9 }
dsHostControlStatus OBJECT-TYPE dsmonHostControlStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this dsHostControlEntry. "The status of this dsmonHostControlEntry.
An entry may not exist in the active state unless all An entry may not exist in the active state unless all
objects in the entry have an appropriate value. objects in the entry have an appropriate value.
If this object is not equal to active(1), all associated If this object is not equal to active(1), all associated
entries in the dsHostTable shall be deleted." entries in the dsmonHostTable shall be deleted."
::= { dsHostControlEntry 10 } ::= { dsmonHostControlEntry 10 }
-- --
-- IP Host Statistics Table -- IP Host Statistics Table
-- --
dsHostTable OBJECT-TYPE dsmonHostTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsHostEntry SYNTAX SEQUENCE OF DsmonHostEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of statistics for a particular IPv4 or IPv6 "A collection of statistics for a particular IPv4 or IPv6
address that has been discovered on a particular dataSource. address that has been discovered on a particular dataSource.
The probe will add to this table all IP addresses seen as The probe will add to this table all IP addresses seen as
the source or destination address in all packets with no MAC the source or destination address in all packets with no MAC
errors, and will increment octet and packet counts in the errors, and will increment octet and packet counts in the
table for all packets with no MAC errors." table for all packets with no MAC errors."
::= { dsHostObjects 2 } ::= { dsmonHostObjects 2 }
dsHostEntry OBJECT-TYPE dsmonHostEntry OBJECT-TYPE
SYNTAX DsHostEntry SYNTAX DsmonHostEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A list of information on Differentiated Services DSCP "A list of information on Differentiated Services DSCP
usage, containing packet and octet counters for each DSCP usage, containing packet and octet counters for each DSCP
configured for collection per host address, as identified in configured for collection per host address, as identified in
each monitored packet. each monitored packet.
The dsHostControlIndex value in the index identifies the The dsmonHostControlIndex value in the index identifies the
dsHostControlEntry on whose behalf this entry was created. dsmonHostControlEntry on whose behalf this entry was
The length of the dsHostAddress field identifies the network created. The length of the dsmonHostAddress field
layer protocol as either IPv4 or IPv6. identifies the network layer protocol as either IPv4 or
IPv6.
Only entries with non-zero statistics will be returned by Only entries with non-zero statistics will be returned by
the agent, in order to reduce the amount of polling required the agent, in order to reduce the amount of polling required
to retrieve data from this table. An entry will be created to retrieve data from this table. An entry will be created
when a packet of that type, IP address, and DSCP value is when a packet of that type, IP address, and DSCP value is
detected by the agent. detected by the agent.
An example of the indexing of this entry is 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, INDEX { dsmonHostControlIndex,
dsHostTimeMark, dsmonHostTimeMark,
dsHostDsCodept, dsmonHostDsCodept,
dsHostAddress } dsmonHostAddress }
::= { dsHostTable 1 } ::= { dsmonHostTable 1 }
DsHostEntry ::= SEQUENCE { DsmonHostEntry ::= SEQUENCE {
dsHostTimeMark TimeFilter, dsmonHostTimeMark TimeFilter,
dsHostDsCodept DSCodePoint, dsmonHostDsCodept DSCodePoint,
dsHostAddress OCTET STRING, dsmonHostAddress OCTET STRING,
dsHostInPkts ZeroBasedCounter32, dsmonHostInPkts ZeroBasedCounter32,
dsHostInOctets ZeroBasedCounter32, dsmonHostInOctets ZeroBasedCounter32,
dsHostInOvflPkts ZeroBasedCounter32, dsmonHostInOvflPkts ZeroBasedCounter32,
dsHostInOvflOctets ZeroBasedCounter32, dsmonHostInOvflOctets ZeroBasedCounter32,
dsHostInHCPkts ZeroBasedCounter64, dsmonHostInHCPkts ZeroBasedCounter64,
dsHostInHCOctets ZeroBasedCounter64, dsmonHostInHCOctets ZeroBasedCounter64,
dsHostOutPkts ZeroBasedCounter32, dsmonHostOutPkts ZeroBasedCounter32,
dsHostOutOctets ZeroBasedCounter32, dsmonHostOutOctets ZeroBasedCounter32,
dsHostOutOvflPkts ZeroBasedCounter32, dsmonHostOutOvflPkts ZeroBasedCounter32,
dsHostOutOvflOctets ZeroBasedCounter32, dsmonHostOutOvflOctets ZeroBasedCounter32,
dsHostOutHCPkts ZeroBasedCounter64, dsmonHostOutHCPkts ZeroBasedCounter64,
dsHostOutHCOctets ZeroBasedCounter64, dsmonHostOutHCOctets ZeroBasedCounter64,
dsHostCreateTime LastCreateTime dsmonHostCreateTime LastCreateTime
} }
dsHostTimeMark OBJECT-TYPE dsmonHostTimeMark OBJECT-TYPE
SYNTAX TimeFilter SYNTAX TimeFilter
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The Time Filter index for this table. This object may be "The Time Filter index for this table. This object may be
used by a management station to retrieve only rows which used by a management station to retrieve only rows which
have been created or modified since a particular time. Note have been created or modified since a particular time. Note
that the current value for a row are always returned and the that the current value for a row are always returned and the
TimeFilter is not a historical data archiving mechanism. TimeFilter is not a historical data archiving mechanism.
Refer to RFC 2021 [RFC2021] for a detailed description of Refer to RFC 2021 [RFC2021] for a detailed description of
TimeFilter operation." TimeFilter operation."
::= { dsHostEntry 1 } ::= { dsmonHostEntry 1 }
dsHostDsCodept OBJECT-TYPE dsmonHostDsCodept OBJECT-TYPE
SYNTAX DSCodePoint SYNTAX DSCodePoint
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The DSCP value associated with the aggregated statistics "The DSCP value associated with the aggregated statistics
for a particular IP host." for a particular IP host."
::= { dsHostEntry 2 } ::= { dsmonHostEntry 2 }
dsHostAddress OBJECT-TYPE dsmonHostAddress OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (4 | 16)) SYNTAX OCTET STRING (SIZE (4 | 16))
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The network address for this dsHostEntry. "The network address for this dsmonHostEntry.
The length of the address string is used to determine if The length of the address string is used to determine if
this entry represents an IPv4 or IPv6 address. For example, this entry represents an IPv4 or IPv6 address. For example,
if the length of this object is '4', then this object is if the length of this object is '4', then this object is
encoded as an IPv4 address in network byte order. encoded as an IPv4 address in network byte order.
Note that IPv4 addresses may have some 'rightmost' bits Note that IPv4 addresses may have some 'rightmost' bits
cleared to zero for counting purposes, as specified by the cleared to zero for counting purposes, as specified by the
associated dsHostControlNumHostBits object." associated dsmonHostControlNumHostBits object."
::= { dsHostEntry 3 } ::= { dsmonHostEntry 3 }
dsHostInPkts OBJECT-TYPE dsmonHostInPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of packets without errors, using the identified "The number of packets without errors, using the identified
DSCP and transmitted to this address, since it was added to DSCP and transmitted to this address, since it was added to
the dsHostTable. Note that this is the number of link-layer the dsmonHostTable. Note that this is the number of link-
packets, so if a single network-layer packet is fragmented layer packets, so if a single network-layer packet is
into several link-layer frames, this counter is incremented fragmented into several link-layer frames, this counter is
several times." incremented several times."
::= { dsHostEntry 4 } ::= { dsmonHostEntry 4 }
dsHostInOctets OBJECT-TYPE dsmonHostInOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of octets, transmitted to this address and using "The number of octets, transmitted to this address and using
the identified DSCP, since it was added to the dsHostTable the identified DSCP, since it was added to the
(excluding framing bits but including FCS octets), excluding dsmonHostTable (excluding framing bits but including FCS
those octets in packets that contained errors. octets), excluding those octets in packets that contained
errors.
Note this doesn't count just those octets in the particular Note this doesn't count just those octets in the particular
protocol frames, but includes the entire packet that protocol frames, but includes the entire packet that
contained the protocol." contained the protocol."
::= { dsHostEntry 5 } ::= { dsmonHostEntry 5 }
dsHostInOvflPkts OBJECT-TYPE dsmonHostInOvflPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times the associated dsHostInPkts counter has "The number of times the associated dsmonHostInPkts counter
overflowed. Note that this object will only be instantiated has overflowed. Note that this object will only be
if the associated dsHostInHCPkts object is also instantiated instantiated if the associated dsmonHostInHCPkts object is
for a particular dataSource." also instantiated for a particular dataSource."
::= { dsHostEntry 6 } ::= { dsmonHostEntry 6 }
dsHostInOvflOctets OBJECT-TYPE dsmonHostInOvflOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times the associated dsHostInOctets counter "The number of times the associated dsmonHostInOctets
has overflowed. Note that this object will only be counter has overflowed. Note that this object will only be
instantiated if the associated dsHostInHCOctets object is instantiated if the associated dsmonHostInHCOctets object is
also instantiated for a particular dataSource." also instantiated for a particular dataSource."
::= { dsHostEntry 7 } ::= { dsmonHostEntry 7 }
dsHostInHCPkts OBJECT-TYPE dsmonHostInHCPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter64 SYNTAX ZeroBasedCounter64
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The 64-bit version of the dsHostInPkts object. "The 64-bit version of the dsmonHostInPkts object.
Note that this object will only be instantiated if the RMON Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular agent supports High Capacity RMON for a particular
dataSource." dataSource."
::= { dsHostEntry 8 } ::= { dsmonHostEntry 8 }
dsHostInHCOctets OBJECT-TYPE dsmonHostInHCOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter64 SYNTAX ZeroBasedCounter64
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The 64-bit version of the dsHostInOctets object. "The 64-bit version of the dsmonHostInOctets object.
Note that this object will only be instantiated if the RMON Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular agent supports High Capacity RMON for a particular
dataSource." dataSource."
::= { dsHostEntry 9 } ::= { dsmonHostEntry 9 }
dsHostOutPkts OBJECT-TYPE dsmonHostOutPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of packets without errors, using the identified "The number of packets without errors, using the identified
DSCP and transmitted by this address, since it was added to DSCP and transmitted by this address, since it was added to
the dsHostTable. Note that this is the number of link-layer the dsmonHostTable. Note that this is the number of link-
packets, so if a single network-layer packet is fragmented layer packets, so if a single network-layer packet is
into several link-layer frames, this counter is incremented fragmented into several link-layer frames, this counter is
several times." incremented several times."
::= { dsHostEntry 10 } ::= { dsmonHostEntry 10 }
dsHostOutOctets OBJECT-TYPE dsmonHostOutOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of octets, transmitted by this address and using "The number of octets, transmitted by this address and using
the identified DSCP, since it was added to the dsHostTable the identified DSCP, since it was added to the
(excluding framing bits but including FCS octets), excluding dsmonHostTable (excluding framing bits but including FCS
those octets in packets that contained errors. octets), excluding those octets in packets that contained
errors.
Note this doesn't count just those octets in the particular Note this doesn't count just those octets in the particular
protocol frames, but includes the entire packet that protocol frames, but includes the entire packet that
contained the protocol." contained the protocol."
::= { dsHostEntry 11 } ::= { dsmonHostEntry 11 }
dsHostOutOvflPkts OBJECT-TYPE dsmonHostOutOvflPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times the associated dsHostOutPkts counter "The number of times the associated dsmonHostOutPkts counter
has overflowed. Note that this object will only be has overflowed. Note that this object will only be
instantiated if the associated dsHostOutHCPkts object is instantiated if the associated dsmonHostOutHCPkts object is
also instantiated for a particular dataSource." also instantiated for a particular dataSource."
::= { dsHostEntry 12 } ::= { dsmonHostEntry 12 }
dsHostOutOvflOctets OBJECT-TYPE dsmonHostOutOvflOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter32 SYNTAX ZeroBasedCounter32
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of times the associated dsHostOutOctets counter "The number of times the associated dsmonHostOutOctets
has overflowed. Note that this object will only be counter has overflowed. Note that this object will only be
instantiated if the associated dsHostOutHCOctets object is instantiated if the associated dsmonHostOutHCOctets object
also instantiated for a particular dataSource." is also instantiated for a particular dataSource."
::= { dsHostEntry 13 } ::= { dsmonHostEntry 13 }
dsHostOutHCPkts OBJECT-TYPE dsmonHostOutHCPkts OBJECT-TYPE
SYNTAX ZeroBasedCounter64 SYNTAX ZeroBasedCounter64
UNITS "packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The 64-bit version of the dsHostOutPkts object. "The 64-bit version of the dsmonHostOutPkts object.
Note that this object will only be instantiated if the RMON Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular agent supports High Capacity RMON for a particular
dataSource." dataSource."
::= { dsHostEntry 14 } ::= { dsmonHostEntry 14 }
dsHostOutHCOctets OBJECT-TYPE dsmonHostOutHCOctets OBJECT-TYPE
SYNTAX ZeroBasedCounter64 SYNTAX ZeroBasedCounter64
UNITS "octets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The 64-bit version of the dsHostOutOctets object. "The 64-bit version of the dsmonHostOutOctets object.
Note that this object will only be instantiated if the RMON Note that this object will only be instantiated if the RMON
agent supports High Capacity RMON for a particular agent supports High Capacity RMON for a particular
dataSource." dataSource."
::= { dsHostEntry 15 } ::= { dsmonHostEntry 15 }
dsHostCreateTime OBJECT-TYPE dsmonHostCreateTime OBJECT-TYPE
SYNTAX LastCreateTime SYNTAX LastCreateTime
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of sysUpTime when this dsHost entry was last "The value of sysUpTime when this dsmonHost entry was last
instantiated by the agent. This can be used by the instantiated by the agent. This can be used by the
management station to ensure that the entry has not been management station to ensure that the entry has not been
deleted and recreated between polls." deleted and recreated between polls."
::= { dsHostEntry 16 } ::= { dsmonHostEntry 16 }
-- --
-- DSCP Per-Protocol Per-Host Statistics TopN Control Table -- DSCP Per-Protocol Per-Host Statistics TopN Control Table
-- --
dsHostTopNControlTable OBJECT-TYPE dsmonHostTopNControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsHostTopNControlEntry SYNTAX SEQUENCE OF DsmonHostTopNControlEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A set of parameters that control the creation of a report "A set of parameters that control the creation of a report
of the top N dsHost entries according to a selected metric." of the top N dsmonHost entries according to a selected
metric."
::= { dsHostObjects 3 } ::= { dsmonHostObjects 3 }
dsHostTopNControlEntry OBJECT-TYPE dsmonHostTopNControlEntry OBJECT-TYPE
SYNTAX DsHostTopNControlEntry SYNTAX DsmonHostTopNControlEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A conceptual row in the dsHostTopNControlTable. "A conceptual row in the dsmonHostTopNControlTable.
Entries are created and deleted from this table by Entries are created and deleted from this table by
management action only, using the dsHostTopNControlStatus management action only, using the dsmonHostTopNControlStatus
RowStatus object. RowStatus object.
Activation of a control row in this table will cause an Activation of a control row in this table will cause an
associated dsHostTopNTable to be created and maintained by associated dsmonHostTopNTable to be created and maintained
the agent." by the agent."
INDEX { dsHostTopNControlIndex } INDEX { dsmonHostTopNControlIndex }
::= { dsHostTopNControlTable 1 } ::= { dsmonHostTopNControlTable 1 }
DsHostTopNControlEntry ::= SEQUENCE { DsmonHostTopNControlEntry ::= SEQUENCE {
dsHostTopNControlIndex Integer32, dsmonHostTopNControlIndex Integer32,
dsHostTopNControlHostIndex Integer32, dsmonHostTopNControlHostIndex Integer32,
dsHostTopNControlRateBase INTEGER, dsmonHostTopNControlRateBase INTEGER,
dsHostTopNControlTimeRemaining Integer32, dsmonHostTopNControlTimeRemaining Integer32,
dsHostTopNControlGeneratedReports Counter32, dsmonHostTopNControlGeneratedReports Counter32,
dsHostTopNControlDuration Integer32, dsmonHostTopNControlDuration Integer32,
dsHostTopNControlRequestedSize Integer32, dsmonHostTopNControlRequestedSize Integer32,
dsHostTopNControlGrantedSize Integer32, dsmonHostTopNControlGrantedSize Integer32,
dsHostTopNControlStartTime TimeStamp, dsmonHostTopNControlStartTime TimeStamp,
dsHostTopNControlOwner OwnerString, dsmonHostTopNControlOwner OwnerString,
dsHostTopNControlStatus RowStatus dsmonHostTopNControlStatus RowStatus
} }
dsHostTopNControlIndex OBJECT-TYPE dsmonHostTopNControlIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535) SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An index that uniquely identifies an entry in the "An index that uniquely identifies an entry in the
dsHostTopNControlTable. Each such entry defines one Top N dsmonHostTopNControlTable. Each such entry defines one Top
report prepared for one RMON dataSource." N report prepared for one RMON dataSource."
::= { dsHostTopNControlEntry 1 } ::= { dsmonHostTopNControlEntry 1 }
dsHostTopNControlHostIndex OBJECT-TYPE dsmonHostTopNControlHostIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535) SYNTAX Integer32 (1..65535)
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The dsHostTable for which a top N report will be prepared "The dsmonHostTable for which a top N report will be
on behalf of this entry. The dsHostTable is identified by prepared on behalf of this entry. The dsmonHostTable is
the value of the dsHostControlIndex for that table - that identified by the value of the dsmonHostControlIndex for
value is used here to identify the particular table. that table - that value is used here to identify the
particular table.
This object may not be modified if the associated This object may not be modified if the associated
dsHostTopNControlStatus object is equal to active(1)." dsmonHostTopNControlStatus object is equal to active(1)."
::= { dsHostTopNControlEntry 2 } ::= { dsmonHostTopNControlEntry 2 }
dsHostTopNControlRateBase OBJECT-TYPE dsmonHostTopNControlRateBase OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
dsHostTopNInPkts(1), dsmonHostTopNInPkts(1),
dsHostTopNInOctets(2), dsmonHostTopNInOctets(2),
dsHostTopNOutPkts(3), dsmonHostTopNOutPkts(3),
dsHostTopNOutOctets(4), dsmonHostTopNOutOctets(4),
dsHostTopNTotalPkts(5), dsmonHostTopNTotalPkts(5),
dsHostTopNTotalOctets(6), dsmonHostTopNTotalOctets(6),
dsHostTopNInHCPkts(7), dsmonHostTopNInHCPkts(7),
dsHostTopNInHCOctets(8), dsmonHostTopNInHCOctets(8),
dsHostTopNOutHCPkts(9), dsmonHostTopNOutHCPkts(9),
dsHostTopNOutHCOctets(10), dsmonHostTopNOutHCOctets(10),
dsHostTopNTotalHCPkts(11), dsmonHostTopNTotalHCPkts(11),
dsHostTopNTotalHCOctets(12) dsmonHostTopNTotalHCOctets(12)
} }
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The variable(s) for each dsHost that the dsHostTopNRate and "The variable(s) for each dsmonHost that the
dsHostTopNHCRate variables are based upon. Each dsHostTopN dsmonHostTopNRate and dsmonHostTopNHCRate variables are
report generated on behalf of this control entry will be based upon. Each dsmonHostTopN report generated on behalf
ranked in descending order, based on the associated of this control entry will be ranked in descending order,
dsHostTable counter(s), identified by this object. based on the associated dsmonHostTable counter(s),
identified by this object.
The following table identifies the dsHostTable counters The following table identifies the dsmonHostTable counters
associated with each enumeration: associated with each enumeration:
Enumeration RateBase MIB Objects Enumeration RateBase MIB Objects
----------- -------------------- ----------- --------------------
dsHostTopNInPkts dsHostInPkts dsmonHostTopNInPkts dsmonHostInPkts
dsHostTopNInOctets dsHostInOctets dsmonHostTopNInOctets dsmonHostInOctets
dsHostTopNOutPkts dsHostOutPkts dsmonHostTopNOutPkts dsmonHostOutPkts
dsHostTopNOutOctets dsHostOutOctets dsmonHostTopNOutOctets dsmonHostOutOctets
dsHostTopNTotalPkts dsHostInPkts + dsmonHostTopNTotalPkts dsmonHostInPkts +
dsHostOutPkts dsmonHostOutPkts
dsHostTopNTotalOctets dsHostInOctets + dsmonHostTopNTotalOctets dsmonHostInOctets +
dsHostOutOctets dsmonHostOutOctets
dsHostTopNInHCPkts dsHostInHCPkts dsmonHostTopNInHCPkts dsmonHostInHCPkts
dsHostTopNInHCOctets dsHostInHCOctets dsmonHostTopNInHCOctets dsmonHostInHCOctets
dsHostTopNOutHCPkts dsHostOutHCPkts dsmonHostTopNOutHCPkts dsmonHostOutHCPkts
dsHostTopNOutHCOctets dsHostOutHCPkts dsmonHostTopNOutHCOctets dsmonHostOutHCPkts
dsHostTopNTotalHCPkts dsHostInHCPkts + dsmonHostTopNTotalHCPkts dsmonHostInHCPkts +
dsHostOutHCPkts dsmonHostOutHCPkts
dsHostTopNTotalHCOctets dsHostInHCOctets + dsmonHostTopNTotalHCOctets dsmonHostInHCOctets +
dsHostOutHCOctets dsmonHostOutHCOctets
The following enumerations are only available if the agent The following enumerations are only available if the agent
supports High Capacity RMON collection: supports High Capacity RMON collection:
dsHostTopNInHCPkts dsmonHostTopNInHCPkts
dsHostTopNInHCOctets dsmonHostTopNInHCOctets
dsHostTopNOutHCPkts dsmonHostTopNOutHCPkts
dsHostTopNOutHCOctets dsmonHostTopNOutHCOctets
dsHostTopNTotalHCPkts dsmonHostTopNTotalHCPkts
dsHostTopNTotalHCOctets dsmonHostTopNTotalHCOctets
It is an implementation-specific matter whether an agent can It is an implementation-specific matter whether an agent can
detect an overflow condition resulting from the addition of detect an overflow condition resulting from the addition of
two counter delta values for the following enumerations: two counter delta values for the following enumerations:
dsHostTopNTotalPkts dsmonHostTopNTotalPkts
dsHostTopNTotalOctets dsmonHostTopNTotalOctets
dsHostTopNTotalHCPkts dsmonHostTopNTotalHCPkts
dsHostTopNTotalHCOctets dsmonHostTopNTotalHCOctets
In the event such an overflow condition can be detected by In the event such an overflow condition can be detected by
the agent, the associated dsHostTopNRate, the agent, the associated dsmonHostTopNRate,
dsHostTopNRateOvfl, and/or dsHostTopNHCRate objects should dsmonHostTopNRateOvfl, and/or dsmonHostTopNHCRate objects
be set to their maximum value. should be set to their maximum value.
This object may not be modified if the associated This object may not be modified if the associated
dsHostTopNControlStatus object is equal to active(1)." dsmonHostTopNControlStatus object is equal to active(1)."
::= { dsHostTopNControlEntry 3 } ::= { dsmonHostTopNControlEntry 3 }
dsHostTopNControlTimeRemaining OBJECT-TYPE dsmonHostTopNControlTimeRemaining OBJECT-TYPE
SYNTAX Integer32 (0..2147483647) SYNTAX Integer32 (0..2147483647)
UNITS "seconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of seconds left in the report currently being "The number of seconds left in the report currently being
collected. When this object is modified by the management collected. When this object is modified by the management
station, a new collection is started, possibly aborting a station, a new collection is started, possibly aborting a
currently running report. The new value is used as the currently running report. The new value is used as the
requested duration of this report, and is immediately loaded requested duration of this report, and is immediately loaded
into the associated dsHostTopNControlDuration object. into the associated dsmonHostTopNControlDuration object.
When the report finishes, the probe will automatically start When the report finishes, the probe will automatically start
another collection with the same initial value of another collection with the same initial value of
dsHostTopNControlTimeRemaining. Thus the management station dsmonHostTopNControlTimeRemaining. Thus the management
may simply read the resulting reports repeatedly, checking station may simply read the resulting reports repeatedly,
the startTime and duration each time to ensure that a report checking the startTime and duration each time to ensure that
was not missed or that the report parameters were not a report was not missed or that the report parameters were
changed. not changed.
While the value of this object is non-zero, it decrements by While the value of this object is non-zero, it decrements by
one per second until it reaches zero. At the time that this one per second until it reaches zero. At the time that this
object decrements to zero, the report is made accessible in object decrements to zero, the report is made accessible in
the dsHostTopNTable, overwriting any report that may be the dsmonHostTopNTable, overwriting any report that may be
there. there.
When this object is modified by the management station, any When this object is modified by the management station, any
associated entries in the dsHostTopNTable shall be deleted." associated entries in the dsmonHostTopNTable shall be
deleted."
DEFVAL { 1800 } DEFVAL { 1800 }
::= { dsHostTopNControlEntry 4 } ::= { dsmonHostTopNControlEntry 4 }
dsHostTopNControlGeneratedReports OBJECT-TYPE dsmonHostTopNControlGeneratedReports OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
UNITS "reports"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of reports that have been generated by this "The number of reports that have been generated by this
entry." entry."
::= { dsHostTopNControlEntry 5 } ::= { dsmonHostTopNControlEntry 5 }
dsHostTopNControlDuration OBJECT-TYPE dsmonHostTopNControlDuration OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
UNITS "seconds"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of seconds that this report has collected during "The number of seconds that this report has collected during
the last sampling interval. the last sampling interval.
When the associated dsHostTopNControlTimeRemaining object is When the associated dsmonHostTopNControlTimeRemaining object
set, this object shall be set by the probe to the same value is set, this object shall be set by the probe to the same
and shall not be modified until the next time the value and shall not be modified until the next time the
dsHostTopNControlTimeRemaining is set. dsmonHostTopNControlTimeRemaining is set.
This value shall be zero if no reports have been requested This value shall be zero if no reports have been requested
for this dsHostTopNControlEntry." for this dsmonHostTopNControlEntry."
::= { dsHostTopNControlEntry 6 } ::= { dsmonHostTopNControlEntry 6 }
dsHostTopNControlRequestedSize OBJECT-TYPE dsmonHostTopNControlRequestedSize OBJECT-TYPE
SYNTAX Integer32 (0..2147483647) SYNTAX Integer32 (0..2147483647)
UNITS "table entries"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The maximum number of dsHost entries requested for this "The maximum number of dsmonHost entries requested for this
report. report.
When this object is created or modified, the probe should When this object is created or modified, the probe should
set dsHostTopNControlGrantedSize as closely to this object set dsmonHostTopNControlGrantedSize as closely to this
as is possible for the particular probe implementation and object as is possible for the particular probe
available resources." implementation and available resources."
DEFVAL { 150 } DEFVAL { 150 }
::= { dsHostTopNControlEntry 7 } ::= { dsmonHostTopNControlEntry 7 }
dsHostTopNControlGrantedSize OBJECT-TYPE dsmonHostTopNControlGrantedSize OBJECT-TYPE
SYNTAX Integer32 (0..2147483647) SYNTAX Integer32 (0..2147483647)
UNITS "table entries"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The maximum number of dsHost entries in this report. "The maximum number of dsmonHost entries in this report.
When the associated dsHostTopNControlRequestedSize object is When the associated dsmonHostTopNControlRequestedSize object
created or modified, the probe should set this object as is created or modified, the probe should set this object as
closely to the requested value as is possible for the closely to the requested value as is possible for the
particular implementation and available resources. The probe particular implementation and available resources. The probe
must not lower this value except as a result of a set to the must not lower this value except as a result of a set to the
associated dsHostTopNControlRequestedSize object. associated dsmonHostTopNControlRequestedSize object.
When the associated dsHostTopNControlRequestedSize object is When the associated dsmonHostTopNControlRequestedSize object
created or modified, the probe should set this object as is created or modified, the probe should set this object as
closely to the requested value as is possible for the closely to the requested value as is possible for the
particular implementation and available resources. The probe particular implementation and available resources. The probe
must not lower this value except as a result of a set to the must not lower this value except as a result of a set to the
associated dsHostTopNControlRequestedSize object. associated dsmonHostTopNControlRequestedSize object.
Protocol entries with the highest value of dsHostTopNRate or Protocol entries with the highest value of dsmonHostTopNRate
dsHostTopNHCRate (depending on the value of the associated or dsmonHostTopNHCRate (depending on the value of the
dsHostTopNControlRateBase object) shall be placed in this associated dsmonHostTopNControlRateBase object) shall be
table in decreasing order of this rate until there is no placed in this table in decreasing order of this rate until
more room or until there are no more dsHost entries." there is no more room or until there are no more dsmonHost
::= { dsHostTopNControlEntry 8 } entries."
::= { dsmonHostTopNControlEntry 8 }
dsHostTopNControlStartTime OBJECT-TYPE dsmonHostTopNControlStartTime OBJECT-TYPE
SYNTAX TimeStamp SYNTAX TimeStamp
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of sysUpTime when this top N report was last "The value of sysUpTime when this top N report was last
started. In other words, this is the time that the started. In other words, this is the time that the
associated dsHostTopNControlTimeRemaining object was associated dsmonHostTopNControlTimeRemaining object was
modified to start the requested report or the time the modified to start the requested report or the time the
report was last automatically (re)started. report was last automatically (re)started.
This object may be used by the management station to This object may be used by the management station to
determine if a report was missed or not." determine if a report was missed or not."
::= { dsHostTopNControlEntry 9 } ::= { dsmonHostTopNControlEntry 9 }
dsHostTopNControlOwner OBJECT-TYPE dsmonHostTopNControlOwner OBJECT-TYPE
SYNTAX OwnerString SYNTAX OwnerString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The entity that configured this entry and is therefore "The entity that configured this entry and is therefore
using the resources assigned to it." using the resources assigned to it."
::= { dsHostTopNControlEntry 10 } ::= { dsmonHostTopNControlEntry 10 }
dsHostTopNControlStatus OBJECT-TYPE dsmonHostTopNControlStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this dsHostTopNControlEntry. "The status of this dsmonHostTopNControlEntry.
An entry may not exist in the active state unless all An entry may not exist in the active state unless all
objects in the entry have an appropriate value. objects in the entry have an appropriate value.
If this object is not equal to active(1), all associated If this object is not equal to active(1), all associated
entries in the dsHostTopNTable shall be deleted by the entries in the dsmonHostTopNTable shall be deleted by the
agent." agent."
::= { dsHostTopNControlEntry 11 } ::= { dsmonHostTopNControlEntry 11 }
-- --
-- dsmonHost TopN Table
-- --
dsHostTopNTable OBJECT-TYPE dsmonHostTopNTable OBJECT-TYPE
SYNTAX SEQUENCE OF DsHostTopNEntry SYNTAX SEQUENCE OF DsmonHostTopNEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A set of statistics for those dsHost entries that have "A set of statistics for those dsmonHost entries that have
counted the highest number of octets or packets. counted the highest number of octets or packets.
Note that dsHost entries which did not increment at all Note that dsmonHost entries which did not increment at all
during the report interval are not included in dsHostTopN during the report interval are not included in dsmonHostTopN
reports." reports."
::= { dsHostObjects 4 } ::= { dsmonHostObjects 4 }
dsHostTopNEntry OBJECT-TYPE dsmonHostTopNEntry OBJECT-TYPE
SYNTAX DsHostTopNEntry SYNTAX DsmonHostTopNEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A conceptual row in the dsHostTopNTable. "A conceptual row in the dsmonHostTopNTable.
The dsHostTopNControlIndex value in the index identifies the The dsmonHostTopNControlIndex value in the index identifies
dsHostTopNControlEntry on whose behalf this entry was the dsmonHostTopNControlEntry on whose behalf this entry was
created." created."
INDEX { dsHostTopNControlIndex, dsHostTopNIndex } INDEX { dsmonHostTopNControlIndex, dsmonHostTopNIndex }
::= { dsHostTopNTable 1 } ::= { dsmonHostTopNTable 1 }
DsHostTopNEntry ::= SEQUENCE { DsmonHostTopNEntry ::= SEQUENCE {
dsHostTopNIndex Integer32, dsmonHostTopNIndex Integer32,
dsHostTopNAddress OCTET STRING, dsmonHostTopNAddress OCTET STRING,
dsHostTopNDsCodept DSCodePoint, dsmonHostTopNDsCodept DSCodePoint,
dsHostTopNRate Gauge32, dsmonHostTopNRate Gauge32,
dsHostTopNRateOvfl Gauge32, dsmonHostTopNRateOvfl Gauge32,
dsHostTopNHCRate Counter64 -- Gauge64 dsmonHostTopNHCRate Counter64 -- Gauge64
} }
dsHostTopNIndex OBJECT-TYPE dsmonHostTopNIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535) SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An index that uniquely identifies an entry in the "An index that uniquely identifies an entry in the
dsHostTopNTable among those in the same report. This index dsmonHostTopNTable among those in the same report. This
is between 1 and N, where N is the number of entries in this index is between 1 and N, where N is the number of entries
report." in this report."
::= { dsHostTopNEntry 1 } ::= { dsmonHostTopNEntry 1 }
dsHostTopNAddress OBJECT-TYPE dsmonHostTopNAddress OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (4 | 16)) SYNTAX OCTET STRING (SIZE (4 | 16))
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The network address of the IP host identified in this "The network address of the IP host identified in this
entry. The length of this field identifies the network entry. The length of this field identifies the network
layer protocol as either IPv4 or IPv6. Addresses are layer protocol as either IPv4 or IPv6. Addresses are
encoded in network byte order." encoded in network byte order."
::= { dsHostTopNEntry 2 } ::= { dsmonHostTopNEntry 2 }
dsHostTopNDsCodept OBJECT-TYPE dsmonHostTopNDsCodept OBJECT-TYPE
SYNTAX DSCodePoint SYNTAX DSCodePoint
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The DSCP value associated with host identified in this "The DSCP value associated with host identified in this
entry." entry."
::= { dsHostTopNEntry 3 } ::= { dsmonHostTopNEntry 3 }
dsHostTopNRate OBJECT-TYPE dsmonHostTopNRate OBJECT-TYPE
SYNTAX Gauge32 SYNTAX Gauge32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The amount of change in the selected variable during this "The amount of change in the selected variable during this
sampling interval. The selected variable is this host's sampling interval. The selected variable is this host's
instance of the object selected by instance of the object selected by
dsHostTopNControlRateBase. dsmonHostTopNControlRateBase.
If the associated dsHostTopNControlRateBase indicates a High If the associated dsmonHostTopNControlRateBase indicates a
Capacity RMON enumeration, (e.g. 'dsHostTopNInHCPkts'), then High Capacity RMON enumeration, (e.g.
this object will contain the the least significant 32 bits 'dsmonHostTopNInHCPkts'), then this object will contain the
of the associated dsHostTopNHCRate object." the least significant 32 bits of the associated
::= { dsHostTopNEntry 4 } dsmonHostTopNHCRate object."
::= { dsmonHostTopNEntry 4 }
dsHostTopNRateOvfl OBJECT-TYPE dsmonHostTopNRateOvfl OBJECT-TYPE
SYNTAX Gauge32 SYNTAX Gauge32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The most significant 32 bits of the associated "The most significant 32 bits of the associated
dsHostTopNHCRate object. dsmonHostTopNHCRate object.
If the associated dsHostTopNControlRateBase is equal to any If the associated dsmonHostTopNControlRateBase is equal to
of the High Capacity RMON enumerations (e.g. any of the High Capacity RMON enumerations (e.g.
'dsHostTopNInHCPkts'), then this object will contain the 'dsmonHostTopNInHCPkts'), then this object will contain the
upper 32 bits of the associated dsHostTopNHCRate object. upper 32 bits of the associated dsmonHostTopNHCRate object.
If the associated dsHostTopNControlRateBase is not equal to If the associated dsmonHostTopNControlRateBase is not equal
any of High Capacity RMON enumerations, then this object to any of High Capacity RMON enumerations, then this object
will contain the value zero. will contain the value zero.
The agent may choose not to instantiate this object if High The agent may choose not to instantiate this object if High
Capacity RMON collection is not supported." Capacity RMON collection is not supported."
::= { dsHostTopNEntry 5 } ::= { dsmonHostTopNEntry 5 }
dsHostTopNHCRate OBJECT-TYPE dsmonHostTopNHCRate OBJECT-TYPE
SYNTAX Counter64 -- Gauge64 SYNTAX Counter64 -- Gauge64
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The amount of change in the selected variable during this "The amount of change in the selected variable during this
sampling interval. The selected variable is this host's sampling interval. The selected variable is this host's
instance of the object selected by instance of the object selected by
dsHostTopNControlRateBase. dsmonHostTopNControlRateBase.
If the associated dsHostTopNControlRateBase is not equal to If the associated dsmonHostTopNControlRateBase is not equal
any of the High Capacity RMON enumerations (e.g., to any of the High Capacity RMON enumerations (e.g.,
'dsHostTopNInPkts'), then this object will contain the value 'dsmonHostTopNInPkts'), then this object will contain the
zero, and the associated dsHostTopNRate object will contain value zero, and the associated dsmonHostTopNRate object will
the change in the selected variable during the sampling contain the change in the selected variable during the
interval. sampling interval.
The agent may choose not to instantiate this object if High The agent may choose not to instantiate this object if High
Capacity RMON collection is not supported." Capacity RMON collection is not supported."
::= { dsHostTopNEntry 6 } ::= { dsmonHostTopNEntry 6 }
-- --
-- Notifications Section -- Notifications Section
-- (none defined) -- (none defined)
-- --
-- --
-- Conformance Section -- Conformance Section
-- --
dsMonCompliances OBJECT IDENTIFIER ::= { dsMonConformance 1 } dsmonCompliances OBJECT IDENTIFIER ::= { dsmonConformance 1 }
dsMonGroups OBJECT IDENTIFIER ::= { dsMonConformance 2 } dsmonGroups OBJECT IDENTIFIER ::= { dsmonConformance 2 }
dsmonCompliance MODULE-COMPLIANCE
dsMonCompliance MODULE-COMPLIANCE
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Describes the requirements for conformance to the "Describes the requirements for conformance to the
Differentiated Services Monitoring MIB." Differentiated Services Monitoring MIB."
MODULE -- this module MODULE -- this module
MANDATORY-GROUPS { dsStatsGroup, dsHostGroup } MANDATORY-GROUPS { dsmonStatsGroup, dsmonHostGroup }
GROUP dsStatsHCGroup GROUP dsmonStatsHCGroup
DESCRIPTION DESCRIPTION
"The dsStatsHCGroup is mandatory for systems which implement "The dsmonStatsHCGroup is mandatory for systems which
the dsStatsGroup and also implement High Capacity RMON implement the dsmonStatsGroup and also implement High
monitoring." Capacity RMON monitoring."
GROUP dsPdistGroup GROUP dsmonPdistGroup
DESCRIPTION DESCRIPTION
"The dsPdistGroup is mandatory for systems which implement "The dsmonPdistGroup is mandatory for systems which
DSCP monitoring and the protocolDirTable from the RMON-2 MIB implement DSCP monitoring and the protocolDirTable from the
[RFC2021]." RMON-2 MIB [RFC2021]."
GROUP dsPdistHCGroup GROUP dsmonPdistHCGroup
DESCRIPTION DESCRIPTION
"The dsPdistHCGroup is mandatory for systems which implement "The dsmonPdistHCGroup is mandatory for systems which
the dsPdistGroup and also implement High Capacity RMON implement the dsmonPdistGroup and also implement High
monitoring." Capacity RMON monitoring."
GROUP dsHostHCGroup GROUP dsmonHostHCGroup
DESCRIPTION DESCRIPTION
"The dsHostHCGroup is mandatory for systems which implement "The dsmonHostHCGroup is mandatory for systems which
the dsHostGroup and also implement High Capacity RMON implement the dsmonHostGroup and also implement High
monitoring." Capacity RMON monitoring."
::= { dsMonCompliances 1 } ::= { dsmonCompliances 1 }
dsStatsGroup OBJECT-GROUP dsmonStatsGroup OBJECT-GROUP
OBJECTS { OBJECTS {
dsStatsControlDataSource, dsmonStatsControlDataSource,
dsStatsControlDroppedFrames, dsmonStatsControlDroppedFrames,
dsStatsControlCreateTime, dsmonStatsControlCreateTime,
dsStatsControlOwner, dsmonStatsControlOwner,
dsStatsControlStatus, dsmonStatsControlStatus,
dsStatsInPkts, dsmonStatsInPkts,
dsStatsInOctets, dsmonStatsInOctets,
dsStatsOutPkts, dsmonStatsOutPkts,
dsStatsOutOctets dsmonStatsOutOctets
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of objects providing per DSCP statistics." "A collection of objects providing per DSCP statistics."
::= { dsMonGroups 1 } ::= { dsmonGroups 1 }
dsStatsHCGroup OBJECT-GROUP dsmonStatsHCGroup OBJECT-GROUP
OBJECTS { OBJECTS {
dsStatsInOvflPkts, dsmonStatsInOvflPkts,
dsStatsInOvflOctets, dsmonStatsInOvflOctets,
dsStatsInHCPkts, dsmonStatsInHCPkts,
dsStatsInHCOctets, dsmonStatsInHCOctets,
dsStatsOutOvflPkts, dsmonStatsOutOvflPkts,
dsStatsOutOvflOctets, dsmonStatsOutOvflOctets,
dsStatsOutHCPkts, dsmonStatsOutHCPkts,
dsStatsOutHCOctets dsmonStatsOutHCOctets
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of objects providing per DSCP statistics for "A collection of objects providing per DSCP statistics for
high capacity data sources." high capacity data sources."
::= { dsMonGroups 2 } ::= { dsmonGroups 2 }
dsPdistGroup OBJECT-GROUP dsmonPdistGroup OBJECT-GROUP
OBJECTS { OBJECTS {
dsPdistControlDataSource, dsmonPdistControlDataSource,
dsPdistControlMaxDesiredEntries, dsmonPdistControlMaxDesiredEntries,
dsPdistControlCollectMode, dsmonPdistControlDroppedFrames,
dsPdistControlDroppedFrames, dsmonPdistControlInserts,
dsPdistControlInserts, dsmonPdistControlDeletes,
dsPdistControlDeletes, dsmonPdistControlCreateTime,
dsPdistControlCreateTime, dsmonPdistControlOwner,
dsPdistControlOwner, dsmonPdistControlStatus,
dsPdistControlStatus, dsmonPdistStatsPkts,
dsPdistStatsPkts, dsmonPdistStatsOctets,
dsPdistStatsOctets, dsmonPdistStatsCreateTime,
dsPdistStatsCreateTime, dsmonPdistTopNControlPdistIndex,
dsPdistTopNControlPdistIndex, dsmonPdistTopNControlRateBase,
dsPdistTopNControlRateBase, dsmonPdistTopNControlTimeRemaining,
dsPdistTopNControlTimeRemaining, dsmonPdistTopNControlGeneratedReports,
dsPdistTopNControlGeneratedReports, dsmonPdistTopNControlDuration,
dsPdistTopNControlDuration, dsmonPdistTopNControlRequestedSize,
dsPdistTopNControlRequestedSize, dsmonPdistTopNControlGrantedSize,
dsPdistTopNControlGrantedSize, dsmonPdistTopNControlStartTime,
dsPdistTopNControlStartTime, dsmonPdistTopNControlOwner,
dsPdistTopNControlOwner, dsmonPdistTopNControlStatus,
dsPdistTopNControlStatus, dsmonPdistTopNProtocolDirLocalIndex,
dsPdistTopNProtocolDirLocalIndex, dsmonPdistTopNDsCodept,
dsPdistTopNDsCodept, dsmonPdistTopNRate
dsPdistTopNRate
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of objects providing per protocol DSCP "A collection of objects providing per protocol DSCP
monitoring extensions to the RMON-2 MIB." monitoring extensions to the RMON-2 MIB."
::= { dsMonGroups 3 } ::= { dsmonGroups 3 }
dsPdistHCGroup OBJECT-GROUP dsmonPdistHCGroup OBJECT-GROUP
OBJECTS { OBJECTS {
dsPdistStatsOvflPkts, dsmonPdistStatsOvflPkts,
dsPdistStatsOvflOctets, dsmonPdistStatsOvflOctets,
dsPdistStatsHCPkts, dsmonPdistStatsHCPkts,
dsPdistStatsHCOctets, dsmonPdistStatsHCOctets,
dsPdistTopNRateOvfl, dsmonPdistTopNRateOvfl,
dsPdistTopNHCRate dsmonPdistTopNHCRate
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of objects providing per protocol DSCP "A collection of objects providing per protocol DSCP
monitoring extensions to the RMON-2 MIB for High Capacicy monitoring extensions to the RMON-2 MIB for High Capacicy
networks." networks."
::= { dsMonGroups 4 } ::= { dsmonGroups 4 }
dsHostGroup OBJECT-GROUP dsmonHostGroup OBJECT-GROUP
OBJECTS { OBJECTS {
dsHostControlDataSource, dsmonHostControlDataSource,
dsHostControlMaxDesiredEntries, dsmonHostControlMaxDesiredEntries,
dsHostControlNumAddrBits, dsmonHostControlNumAddrBits,
dsHostControlDroppedFrames, dsmonHostControlDroppedFrames,
dsHostControlInserts, dsmonHostControlInserts,
dsHostControlDeletes, dsmonHostControlDeletes,
dsHostControlCreateTime, dsmonHostControlCreateTime,
dsHostControlOwner, dsmonHostControlOwner,
dsHostControlStatus, dsmonHostControlStatus,
dsHostInPkts, dsmonHostInPkts,
dsHostInOctets, dsmonHostInOctets,
dsHostOutPkts, dsmonHostOutPkts,
dsHostOutOctets, dsmonHostOutOctets,
dsHostCreateTime, dsmonHostCreateTime,
dsHostTopNControlHostIndex, dsmonHostTopNControlHostIndex,
dsHostTopNControlRateBase, dsmonHostTopNControlRateBase,
dsHostTopNControlTimeRemaining, dsmonHostTopNControlTimeRemaining,
dsHostTopNControlGeneratedReports, dsmonHostTopNControlGeneratedReports,
dsHostTopNControlDuration, dsmonHostTopNControlDuration,
dsHostTopNControlRequestedSize, dsmonHostTopNControlRequestedSize,
dsHostTopNControlGrantedSize, dsmonHostTopNControlGrantedSize,
dsHostTopNControlStartTime, dsmonHostTopNControlStartTime,
dsHostTopNControlOwner, dsmonHostTopNControlOwner,
dsHostTopNControlStatus, dsmonHostTopNControlStatus,
dsHostTopNAddress, dsmonHostTopNAddress,
dsHostTopNDsCodept, dsmonHostTopNDsCodept,
dsHostTopNRate dsmonHostTopNRate
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of objects providing per IP Host DSCP "A collection of objects providing per IP Host DSCP
monitoring functions." monitoring functions."
::= { dsMonGroups 5 } ::= { dsmonGroups 5 }
dsHostHCGroup OBJECT-GROUP dsmonHostHCGroup OBJECT-GROUP
OBJECTS { OBJECTS {
dsHostInOvflPkts, dsmonHostInOvflPkts,
dsHostInOvflOctets, dsmonHostInOvflOctets,
dsHostInHCPkts, dsmonHostInHCPkts,
dsHostInHCOctets, dsmonHostInHCOctets,
dsHostOutOvflPkts, dsmonHostOutOvflPkts,
dsHostOutOvflOctets, dsmonHostOutOvflOctets,
dsHostOutHCPkts, dsmonHostOutHCPkts,
dsHostOutHCOctets, dsmonHostOutHCOctets,
dsHostTopNRateOvfl, dsmonHostTopNRateOvfl,
dsHostTopNHCRate dsmonHostTopNHCRate
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of objects providing per IP Host DSCP "A collection of objects providing per IP Host DSCP
monitoring functions for High Capacity networks." monitoring functions for High Capacity networks."
::= { dsMonGroups 6 } ::= { dsmonGroups 6 }
END END
7. Intellectual Property 7. Intellectual Property
The IETF takes no position regarding the validity or scope of any The IETF takes no position regarding the validity or scope of any
intellectual property or other rights that might be claimed to pertain intellectual property or other rights that might be claimed to pertain
to the implementation or use of the technology described in this to the implementation or use of the technology described in this
document or the extent to which any license under such rights might or 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 might not be available; neither does it represent that it has made any
effort to identify any such rights. Information on the IETF's effort to identify any such rights. Information on the IETF's
procedures with respect to rights in standards-track and standards- procedures with respect to rights in standards-track and standards-
related documentation can be found in BCP-11. Copies of claims of related documentation can be found in BCP-11. Copies of claims of
skipping to change at page 62, line 32 skipping to change at page 63, line 22
There are a number of management objects defined in this MIB that have a 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 MAX-ACCESS clause of read-write and/or read-create. Such objects may be
considered sensitive or vulnerable in some network environments. The considered sensitive or vulnerable in some network environments. The
support for SET operations in a non-secure environment without proper support for SET operations in a non-secure environment without proper
protection can have a negative effect on network operations. protection can have a negative effect on network operations.
There are a number of managed objects in this MIB that may contain There are a number of managed objects in this MIB that may contain
sensitive information. These are: sensitive information. These are:
dsPdistStatsPkts dsmonPdistStatsPkts
dsPdistStatsOctets dsmonPdistStatsOctets
dsPdistStatsHCPkts dsmonPdistStatsHCPkts
dsPdistStatsHCOctets dsmonPdistStatsHCOctets
dsmonPdistTopNRate
dsmonPdistTopNHCRate
These objects expose some basic statistics about the DCSP distribution These objects expose some basic statistics about the DCSP distribution
for each protocol detected on a particular network interface. for each protocol detected on a particular network interface.
dsHostInPkts dsmonHostInPkts
dsHostInOctets dsmonHostInOctets
dsHostInHCPkts dsmonHostInHCPkts
dsHostInHCOctets dsmonHostInHCOctets
dsHostOutPkts dsmonHostOutPkts
dsHostOutOctets dsmonHostOutOctets
dsHostOutHCPkts dsmonHostOutHCPkts
dsHostOutHCOctets dsmonHostOutHCOctets
dsmonHostTopNRate
dsmonHostTopNHCRate
These objects expose some basic statistics about the DCSP distribution These objects expose some basic statistics about the DCSP distribution
for each IP host detected on a particular network interface. 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 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 possibly to even encrypt the values of these object when sending them
over the network via SNMP. Not all versions of SNMP provide features over the network via SNMP. Not all versions of SNMP provide features
for such a secure environment. for such a secure environment.
SNMPv1 by itself is not a secure environment. Even if the network 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 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 control as to who on the secure network is allowed to access and GET/SET
(read/change/create/delete) the objects in this MIB. (read/change/create/delete) the objects in this MIB.
 End of changes. 462 change blocks. 
960 lines changed or deleted 1009 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/