CISCO-SUBSCRIBER-SESSION-MIB :: csubAggStatsThrottleEngagements

MIB Reference — IPNetwork Monitor · Updated September 14, 2026

All MIBsCISCO-SUBSCRIBER-SESSION-MIBcsubAggStatsThrottleEngagements

csubAggStatsThrottleEngagements

Module: CISCO-SUBSCRIBER-SESSION-MIB

OID (symbolic): CISCO-SUBSCRIBER-SESSION-MIB::csubAggStatsThrottleEngagements

OID (numeric): 1.3.6.1.4.1.9.9.786.1.2.1.1.14

Node type: OBJECT-TYPE

Type: Counter64

Access: read-only

Description: This object indicates the number of times that nodes contained within the 'scope of aggregation' have engaged the subscriber session throttle since the last discontinuity time.

The mechanics of a subscriber session throttle vary with subscriber session type and implementation. However, the general concept of the throttle prevents a node from having to deal with more than a configured number of requests to establish subscriber sessions from the same CPE within the a configured interval of time. When the number of requests exceeds the configured threshold within the configured interval, then the node processing the requests engages the throttle. Typically, when a node engages a throttle, it drops requests from the CPE for some period of time, after which the node disengages the throttle.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of csubAggStatsDiscontinuityTime.

What is csubAggStatsThrottleEngagements?

Reports how many times session-creation throttling has been triggered within a scope of aggregation since the last discontinuity, signaling when the system has had to rate-limit new session setups.

Examples

Walk all instances (SNMPv2c):

snmpwalk -v2c -c public <target> 1.3.6.1.4.1.9.9.786.1.2.1.1.14
snmpwalk -v2c -c public <target> CISCO-SUBSCRIBER-SESSION-MIB::csubAggStatsThrottleEngagements

Get a specific instance (index 1):

snmpget -v2c -c public <target> 1.3.6.1.4.1.9.9.786.1.2.1.1.14.1
snmpget -v2c -c public <target> CISCO-SUBSCRIBER-SESSION-MIB::csubAggStatsThrottleEngagements.1

SNMPv3 example:

snmpget -v3 -l authPriv -u snmpv3-user -a SHA -A "AuthPassword1" -x AES -X "PrivPassword1" <target> csubAggStatsThrottleEngagements.1

Start monitoring Cisco IOS/IOS-XE routers as ISG/NAS broadband access devices with a free 30-day trial of IPNetwork Monitor. Create custom SNMP monitor using the CISCO-SUBSCRIBER-SESSION-MIB::csubAggStatsThrottleEngagements OID value, configure state conditions and alerts, and monitor any Cisco IOS/IOS-XE routers as ISG/NAS broadband access devices from a single console.

How to Use in IPNetwork Monitor

Select a Cisco IOS/IOS-XE routers as ISG/NAS broadband access device 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 csubAggStatsThrottleEngagements 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. This object indicates the number of times that nodes contained within the 'scope of aggregation' have engaged the subscriber session throttle since the last discontinuity time. 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 Counter64-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.

OID Breakdown

Upper-level ancestors (8 from the standard OID tree / other modules)
Numeric OIDNameModule
1isoLANART-AGENT
1.3orgAirPair-MIB
1.3.6dodAirPair-MIB
1.3.6.1internetAirPair-MIB
1.3.6.1.4privateAirPair-MIB
1.3.6.1.4.1enterprisesAirPair-MIB
1.3.6.1.4.1.9ciscoCAT2600-MIB
1.3.6.1.4.1.9.9ciscoMgmtCISCO-SMI
Numeric OIDNameModule
1.3.6.1.4.1.9.9.786ciscoSubscriberSessionMIBCISCO-SUBSCRIBER-SESSION-MIB
1.3.6.1.4.1.9.9.786.1ciscoSubscriberSessionMIBObjectsCISCO-SUBSCRIBER-SESSION-MIB
1.3.6.1.4.1.9.9.786.1.2csubAggStatsCISCO-SUBSCRIBER-SESSION-MIB
1.3.6.1.4.1.9.9.786.1.2.1csubAggStatsTableCISCO-SUBSCRIBER-SESSION-MIB
1.3.6.1.4.1.9.9.786.1.2.1.1csubAggStatsEntryCISCO-SUBSCRIBER-SESSION-MIB
1.3.6.1.4.1.9.9.786.1.2.1.1.14csubAggStatsThrottleEngagementsCISCO-SUBSCRIBER-SESSION-MIB