CISCO-CABLE-QOS-MONITOR-MIB

        This is the MIB module for subscriber QoS monitoring 
for DOCSIS-compliant Cable Modem Termination Systems 
(CMTS).
        
Several subscriber behavior can be monitored:
1. When the subscriber requests for more resources than 
as defined by its QoS parameter set. In this case,
though requested for more rate-limiting happens in 
the CMTS, hence, the subscriber will get only as much
resources as defined by its registered QoS parameter 
set. In this mib, QoS parameter set refers to QoS 
profiles for 1.0 modems and refer to service class
names for 1.1 and 2.0 modems. 
        
2.	When the subscriber continuously utilizes the resources
to the upper limit or very near to the upper limit as 
defined by its QoS parameter set. 
        
3.	When the subscriber sometimes or never utilizes the 
resources as defined by the upper limit of the QoS 
parameter set. 
        
In the first two cases, we need to monitor the subscribers 
as upstream/downstream is a shared medium, and if all 
subscribers start consuming resources as per their peak
rate, or a percentage of it, CMTS will be hard pressed for
resources. So, even though such subscribers are using 
resources within the limits as defined by their QoS 
parameter set, from the CMTS point of view, they are 
over consuming. 
Through out this MIB, we refer to this behavior of 
subscribers as over consumption of resources and such 
subscribers will be the violating subscribers. 
        
The subscriber QoS Monitoring is a software feature 
provided on the CMTS so that the CMTS may identify such 
subscribers who over consume resources based on their QoS 
parameter set, report them to a management entity, and 
automatically mitigate the problem where possible. 
This is done by penalizing the violating subscribers by 
changing their QoS parameter set to enforced QoS 
parameter set.
        
The MIB allows to create enforce rules which are used to 
determine the over consumption of resources. The enforce 
rule contains monitoring and enforced QoS parameter set.
        
The subscribers who over consume their bandwidth are 
flagged and NMS notified of all such violations.
The MIB also provides a unified view of all over-consuming 
subscribers.
    
Source file
CISCO-CABLE-QOS-MONITOR-MIB
Last revised
Identity
ciscoCableQosMonitorMIB
Base OID
1.3.6.1.4.1.9.9.341
Imported Objects
CISCO-SMI ciscoMgmt
IF-MIB ifIndex
SNMPv2-CONF MODULE-COMPLIANCE (no object page) NOTIFICATION-GROUP (no object page) OBJECT-GROUP (no object page)
SNMPv2-SMI MODULE-IDENTITY (no object page) NOTIFICATION-TYPE (no object page) OBJECT-TYPE (no object page) Unsigned32
SNMPv2-TC DateAndTime DisplayString MacAddress RowStatus TEXTUAL-CONVENTION (no object page) TruthValue
Net-SNMP examples using the cisco MIB directory Show commands

These commands use the standard Observium installation path and load the selected MIB variant before the RFC and Net-SNMP directories.

Translate the module identity
/usr/bin/snmptranslate -Pud -Ir -On -m 'CISCO-CABLE-QOS-MONITOR-MIB' -M '/opt/observium/mibs/cisco:/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'CISCO-CABLE-QOS-MONITOR-MIB::ciscoCableQosMonitorMIB'
Walk the MIB subtree
/usr/bin/snmpbulkwalk -v2c -c '<community>' -Pud -Ir -OQUs -m 'CISCO-CABLE-QOS-MONITOR-MIB' -M '/opt/observium/mibs/cisco:/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'udp:<hostname>:161' 'CISCO-CABLE-QOS-MONITOR-MIB::ciscoCableQosMonitorMIB'
How SNMP, Net-SNMP, MIB paths, and variants work
Objects (49)
.1.3.6.1.4.1.9.9.341
.1.3.6.1.4.1.9.9.341.1
.1.3.6.1.4.1.9.9.341.1.1
.1.3.6.1.4.1.9.9.341.1.1.1
.1.3.6.1.4.1.9.9.341.1.1.1.1
OctetString
.1.3.6.1.4.1.9.9.341.1.1.1.1.1
.1.3.6.1.4.1.9.9.341.1.1.1.1.10
.1.3.6.1.4.1.9.9.341.1.1.1.1.11
Enumeration
.1.3.6.1.4.1.9.9.341.1.1.1.1.12
OctetString
.1.3.6.1.4.1.9.9.341.1.1.1.1.13
OctetString
.1.3.6.1.4.1.9.9.341.1.1.1.1.14
Enumeration
.1.3.6.1.4.1.9.9.341.1.1.1.1.15
Unsigned32
.1.3.6.1.4.1.9.9.341.1.1.1.1.16
minutesUnsigned32
.1.3.6.1.4.1.9.9.341.1.1.1.1.17
.1.3.6.1.4.1.9.9.341.1.1.1.1.18
Unsigned32
.1.3.6.1.4.1.9.9.341.1.1.1.1.19
Unsigned32
.1.3.6.1.4.1.9.9.341.1.1.1.1.2
minutesUnsigned32
.1.3.6.1.4.1.9.9.341.1.1.1.1.20
.1.3.6.1.4.1.9.9.341.1.1.1.1.21
minutesUnsigned32
.1.3.6.1.4.1.9.9.341.1.1.1.1.22
.1.3.6.1.4.1.9.9.341.1.1.1.1.23
Unsigned32
.1.3.6.1.4.1.9.9.341.1.1.1.1.3
minutesUnsigned32
.1.3.6.1.4.1.9.9.341.1.1.1.1.4
.1.3.6.1.4.1.9.9.341.1.1.1.1.5
minutesUnsigned32
.1.3.6.1.4.1.9.9.341.1.1.1.1.6
.1.3.6.1.4.1.9.9.341.1.1.1.1.7
.1.3.6.1.4.1.9.9.341.1.1.1.1.8
.1.3.6.1.4.1.9.9.341.1.1.1.1.9
.1.3.6.1.4.1.9.9.341.1.2
.1.3.6.1.4.1.9.9.341.1.2.2
.1.3.6.1.4.1.9.9.341.1.2.2.1
.1.3.6.1.4.1.9.9.341.1.2.2.1.1
.1.3.6.1.4.1.9.9.341.1.2.2.1.2
OctetString
.1.3.6.1.4.1.9.9.341.1.2.2.1.3
.1.3.6.1.4.1.9.9.341.1.2.2.1.4
.1.3.6.1.4.1.9.9.341.1.2.2.1.5
.1.3.6.1.4.1.9.9.341.1.2.2.1.6
.1.3.6.1.4.1.9.9.341.1.2.3
.1.3.6.1.4.1.9.9.341.1.3
.1.3.6.1.4.1.9.9.341.1.3.1
.1.3.6.1.4.1.9.9.341.1.3.1.1
percentUnsigned32
.1.3.6.1.4.1.9.9.341.1.3.1.1.1
percentUnsigned32
.1.3.6.1.4.1.9.9.341.1.3.1.1.2
.1.3.6.1.4.1.9.9.341.1.3.1.1.3
.1.3.6.1.4.1.9.9.341.2
.1.3.6.1.4.1.9.9.341.2.0
.1.3.6.1.4.1.9.9.341.3
.1.3.6.1.4.1.9.9.341.3.1
.1.3.6.1.4.1.9.9.341.3.2
Dependencies (7) 5 direct · 2 transitive Show tree and compile order Hide dependency details

Each imported module is resolved in the importing module's source directory first, then through the normal default-variant rules.

Dependency tree
Dependency-first compile order
  1. SNMPv2-SMIrfc
  2. CISCO-SMIcisco
  3. SNMPv2-TCrfc
  4. IANAifType-MIBrfc
  5. SNMPv2-CONFrfc
  6. SNMPv2-MIBrfc
  7. IF-MIBrfc
  8. CISCO-CABLE-QOS-MONITOR-MIBciscoselected
Type Definitions (1)
Enumeration
upstream(1)
downstream(2)
bidirection(3)
Conformance Groups (5)
Group of objects implemented in CMTS
providing enforce rule and QoS monitoring
information.
.1.3.6.1.4.1.9.9.341.3.2.1
Group of objects implemented in CMTS
providing information of enforce rule
violations.
.1.3.6.1.4.1.9.9.341.3.2.2
The notification which a CISCO-CABLE-QOS-MONITOR-MIB
is required to implement.
.1.3.6.1.4.1.9.9.341.3.2.3
Group of objects implemented in CMTS
providing enforce rule and QoS monitoring
information.
.1.3.6.1.4.1.9.9.341.3.2.4
Group of objects implemented in CMTS
providing information of interface utilization
thresholds.
.1.3.6.1.4.1.9.9.341.3.2.5
Compliance Statements (2)

OID .1.3.6.1.4.1.9.9.341.3.1.1
The compliance statement for CMTS devices that implement
the Qos Monitoring feature.
Required groups
Object refinements
ObjectAccessSyntaxDescription
ccqmCmtsEnfRuleSampleRate
Currently only the range 10 to 30 minutes
is supported.

OID .1.3.6.1.4.1.9.9.341.3.1.2
The compliance statement for CMTS devices that implement
the Qos Monitoring feature.
Required groups
Notifications / Traps (1)
NameOIDDescription
.1.3.6.1.4.1.9.9.341.2.0.1
A notification that is sent when the subscriber
if found to have violated his enforce rule. This
indicates that this subscriber was found to be
over consuming resources. If the enforce rule
associated with this subscriber has a enforced QoS
parameter set configured, the trap also indicates
that the QoS parameter set of this subscriber are
changed to the enforced QoS parameter set.