CISCO-QUEUE-MIB

All MIBs › CISCO-QUEUE-MIB

Organization: Cisco Systems, Inc.

Last Updated: 1995-05-31

Category: Cisco Devices, Quality of Service

Description: Monitors interface queue depths, drops, and scheduling statistics for traffic management on Cisco devices.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is CISCO-QUEUE-MIB?

CISCO-QUEUE-MIB is a Cisco Systems proprietary MIB managing interface output-queuing on Cisco devices. Its interface table records queue type, transmit limit, and sub-queue count, a statistics table (keyed by queue number) reports current/max depth and discard count, and a rotation table tracks octets transmitted per queue in weighted-fair/custom-queuing rotation schemes. As a performance MIB it lets an administrator watch queue depth and discard counts to confirm QoS queuing is behaving as configured under load. It is deployed on Cisco routers/switches. Engineers can download the CISCO-QUEUE-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-QUEUE-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Cisco routers/switches (interface queuing)

Monitoring Examples

An administrator monitors cQStatsDiscards alongside cQStatsMaxDepth to confirm whether a specific output queue is dropping traffic due to sustained congestion on a Cisco router.

What Can Be Monitored

per-queue depth and discard counts

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From RFC1213-MIB

ifIndex

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Gauge32
Integer32
MODULE-IDENTITY
OBJECT-TYPE

From SNMPv2-TC

TEXTUAL-CONVENTION

How to Use in IPNetwork Monitor

Example using cQStatsDiscards OID:

Select a Cisco routers/switch (interface queuing) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type cQStatsDiscards into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. The number of messages discarded from this queue since restart by reason of enqueue at a time that cQStatsDepth >= cQStatsMaxDepth. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases between polls, since a rising count of errors, failures, or discards often points to a real underlying problem. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoQueueMIB	1.3.6.1.4.1.9.9.37			This is the MIB module for objects used to manage interface queuing in Cisco devices.
ciscoQueueObjects	1.3.6.1.4.1.9.9.37.1
cQIfTable	1.3.6.1.4.1.9.9.37.1.1		not-accessible	This table contains objects that describe the queues on a Cisco Interface. An interface queue is modeled as a collection of one or more secondary queues that feed into a device's hardware queue. The hardware queue has a maximum depth set by the MCI tx-queue-limit command or equivalent. The secondary queues (also known as the 'hold queue') have maximum depths set by the hold-queue command or equivalent. This table parallels the ifTable, and indicates the type of queuing in use on the interface, number of queues, and similar parameters.
cQIfEntry	1.3.6.1.4.1.9.9.37.1.1.1		not-accessible	A list of queue attributes for an interface.
CQA cQIfQType	1.3.6.1.4.1.9.9.37.1.1.1.1	CQAlgorithm	read-only	The type of queuing used in the Hold Queue. First In First Out Queuing implies that the interface always transmits messages in the order that they are received. Priority Queuing sorts messages out by the use of access lists. Messages in a higher priority queue are always sent in preference to messages in a lower priority queue. Custom Queuing sorts messages out by the use of access lists. Sub-queues are selected in round robin order as either the sub-queue is drained or a given number of octets is moved from the sub-queue to the transmission queue. Weighted Fair Queuing sorts messages by 'conversation', which is source-destination pair of addresses and sockets or ports, as defined by the network layer protocol. Messages are removed from queues in a sequence that gives each conversation a proportion of the available bandwidth.
I32 cQIfTxLimit	1.3.6.1.4.1.9.9.37.1.1.1.2	Integer32	read-only	The maximum number of messages placed into the hardware transmission queue. This is a first come first serve queue, fed by the hold queue. If the hold queue contains information, this queue is presumably full.
I32 cQIfSubqueues	1.3.6.1.4.1.9.9.37.1.1.1.3	Integer32	read-only	The number of sub-queues of which the hold queue is built. This is a constant for each value of cQIfQType.
cQStatsTable	1.3.6.1.4.1.9.9.37.1.2		not-accessible	This table contains statistical objects that for the sub-queues of a Cisco Interface.
cQStatsEntry	1.3.6.1.4.1.9.9.37.1.2.1		not-accessible	A list of sub-queue attributes for an interface.
I32 cQStatsQNumber	1.3.6.1.4.1.9.9.37.1.2.1.1	Integer32	not-accessible	The number of the queue within the queue set. In FIFO queuing, this value is always 2. In Priority Queuing, it corresponds to the various priorities: high = 0 medium = 1 normal = 2 low = 3 In Custom Queuing, it is the queue number referenced in the access list. In Weighted Fair Queuing, it is the queue number associated with the traffic stream (conversation) identified.
G32 cQStatsDepth	1.3.6.1.4.1.9.9.37.1.2.1.2	Gauge32	read-only	The number of messages in the sub-queue.
I32 cQStatsMaxDepth	1.3.6.1.4.1.9.9.37.1.2.1.3	Integer32	read-only	The maximum number of messages permitted in the sub-queue.
C32 cQStatsDiscardsEx	1.3.6.1.4.1.9.9.37.1.2.1.4	Counter32	read-only	The number of messages discarded from this queue since restart by reason of enqueue at a time that cQStatsDepth >= cQStatsMaxDepth.
cQRotationTable	1.3.6.1.4.1.9.9.37.1.3		not-accessible	This table describes the rotation of Custom Queuing on an Interface.
cQRotationEntry	1.3.6.1.4.1.9.9.37.1.3.1		not-accessible	Custom Queuing sub-queue attributes for an interface.
I32 cQRotationOctets	1.3.6.1.4.1.9.9.37.1.3.1.1	Integer32	read-only	The number of octets which may be transmitted from a custom queuing sub-queue before it must yield to another queue.
ciscoQueueTraps	1.3.6.1.4.1.9.9.37.2
ciscoQueueConformance	1.3.6.1.4.1.9.9.37.3
cQCompliances	1.3.6.1.4.1.9.9.37.3.1
cQCompliance	1.3.6.1.4.1.9.9.37.3.1.1			The core compliance statement for all queued interfaces.
cQGroups	1.3.6.1.4.1.9.9.37.3.2
cQIfGroup	1.3.6.1.4.1.9.9.37.3.2.1			The configuration of queuing on the interface. Interface Queuing statistics (ifOutQDepth and ifOutDiscards) are kept in the interface table.
cQStatsGroup	1.3.6.1.4.1.9.9.37.3.2.2			The statistics for individual queues in the interface queuing system.
cQRotationGroup	1.3.6.1.4.1.9.9.37.3.2.3			The Custom Queuing queue rotation weights.

RFC description

Manages interface queueing disciplines including FIFO, priority, custom, and weighted fair queuing.

Start monitoring Cisco routers/switches (interface queuing) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CISCO-QUEUE-MIB