NOKIA-RATESHAPE-MIB

All MIBs › NOKIA-RATESHAPE-MIB

Organization: Nokia

Last Updated: 2000-01-30

Category: QoS

Description: Manages Nokia interface rate shaping policies for outbound traffic bandwidth limiting.

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 NOKIA-RATESHAPE-MIB?

NOKIA-RATESHAPE-MIB is a vendor MIB from Nokia that defines rate-shaping controls for outbound interface traffic, letting an operator apply access lists and shaping rules to bound bandwidth usage per interface and direction. It exposes configuration data through rsAccessListTable (access list definitions bound to an interface and direction) and rsRuleTable (individual shaping rules tied to an access list). Its monitoring value is in software/policy configuration status: confirming the correct rate-shaping rules and access lists are applied and active on each interface, which explains observed bandwidth-limiting behavior on a link. It is rooted under the shared Nokia enterprise OID branch (nokia, nokiaProducts, ntcCommon), indicating it is part of a broader family of Nokia network-element MIBs sharing common conventions. It is deployed on Nokia (formerly Newbridge/Alcatel-lineage) network equipment where administrators need to enforce bandwidth caps on outbound traffic per interface. Engineers can download the NOKIA-RATESHAPE-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in NOKIA-RATESHAPE-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

Nokia network element (router/switch)

Monitoring Examples

An operator would poll rsAccessListTable (indexed by rsAccessListIfIndex and rsAccessListIndex) to see which access list and direction (rsAccessListDirection) is applied to a given interface, then cross-reference rsRuleTable (via rsRuleIfIndex and rsRuleIndex) to inspect the specific shaping rule in effect; an interface missing an expected rsAccessListName binding would explain why traffic is not being shaped as intended, useful when diagnosing unexpected bandwidth consumption. rsAccessListRowStatus can confirm whether an access list entry is active or pending.

What Can Be Monitored

rate-shaping access list assignment per interface
shaping rule configuration
traffic direction (inbound/outbound) shaping
access list row/activation status

Imported Objects

From SNMPv2-CONF

OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
IpAddress
MODULE-IDENTITY
OBJECT-TYPE
enterprises

From SNMPv2-TC

DisplayString
RowStatus
TEXTUAL-CONVENTION

How to Use in IPNetwork Monitor

Example using rsAccessListStatPktsPassed OID:

Select a Nokia network element (router/switch, outbound rate shaping) 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 rsAccessListStatPktsPassed 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. Gives the count of number of packets successfully exiting this access list. 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 sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
nokia	1.3.6.1.4.1.94
nokiaProducts	1.3.6.1.4.1.94.1
ntcCommon	1.3.6.1.4.1.94.1.16
ntcRS	1.3.6.1.4.1.94.1.16.4			This MIB Module defines the Rate Shaping MIB. More detailed description of the variables and tables is provided in other related documentation.
PAC rsAccessListDirection	1.3.6.1.4.1.94.1.16.4.1.1.1.3	PacketSource	read-only	The data source for this access list.
rsAccessListEntry	1.3.6.1.4.1.94.1.16.4.1.1.1		not-accessible	A series of objects used to describe each access list.
I32 rsAccessListIfIndex	1.3.6.1.4.1.94.1.16.4.1.1.1.1	Integer32	read-only	The ifIndex of the MIB-II interface which this access list entry is responsible for.
I32 rsAccessListIndex	1.3.6.1.4.1.94.1.16.4.1.1.1.2	Integer32	read-only	A unique index value for this access list.
STR rsAccessListName	1.3.6.1.4.1.94.1.16.4.1.1.1.4	DisplayString	read-create	This string provides a unique descriptor for this access list. If an attempt is made to set this string to the name of another access list on the agent, it should return noSuchName.
ROW rsAccessListRowStatus	1.3.6.1.4.1.94.1.16.4.1.1.1.5	RowStatus	read-create	The current status of this access list. Setting this object to 'destroy' has the effect of deleting this access list. createAndGo(4) appends to the list and activates it.
rsAccessLists	1.3.6.1.4.1.94.1.16.4.1			A collection of objects providing the instrumentation of rsAccessLists
C32 rsAccessListStatBytesPassed	1.3.6.1.4.1.94.1.16.4.4.1.1.5	Counter32	read-only	Gives the count of number of bytes successfully exiting this access list.
PAC rsAccessListStatDirection	1.3.6.1.4.1.94.1.16.4.4.1.1.3	PacketSource	read-only	The data source for this access list.
rsAccessListStatEntry	1.3.6.1.4.1.94.1.16.4.4.1.1		not-accessible	A series of status objects used to describe each access list.
I32 rsAccessListStatIfIndex	1.3.6.1.4.1.94.1.16.4.4.1.1.1	Integer32	read-only	The ifIndex of the MIB-II interface which this access list stat entry is responsible for.
I32 rsAccessListStatIndex	1.3.6.1.4.1.94.1.16.4.4.1.1.2	Integer32	read-only	A unique index value for this access list.
C32 rsAccessListStatPktsPassedEx	1.3.6.1.4.1.94.1.16.4.4.1.1.4	Counter32	read-only	Gives the count of number of packets successfully exiting this access list.
rsAccessListStats	1.3.6.1.4.1.94.1.16.4.4			A collection of objects providing the instrumentation of rsAccessListStats
rsAccessListStatTable	1.3.6.1.4.1.94.1.16.4.4.1		not-accessible	A table of access list status entries.
rsAccessListTable	1.3.6.1.4.1.94.1.16.4.1.1		not-accessible	A table of access list configuration entries. An access list will contain several rules for rate limits which are applied to one or more MIB-II interface-direction tuples. Each MIB-II interface may not utilize more than two access lists; one for the in direction and one for the out direction.
I32 rsAggregationClassBurstSize	1.3.6.1.4.1.94.1.16.4.3.1.1.7	Integer32	read-create	The Burst size associated with this aggregation class.
PAC rsAggregationClassDirection	1.3.6.1.4.1.94.1.16.4.3.1.1.3	PacketSource	read-only	The data source for this aggregation class.
rsAggregationClassEntry	1.3.6.1.4.1.94.1.16.4.3.1.1		not-accessible	A collection of aggregation class objects on this interface-direction tuple.
rsAggregationClasses	1.3.6.1.4.1.94.1.16.4.3			A collection of objects providing the instrumentation of rsAggregationClasses
I32 rsAggregationClassIfIndex	1.3.6.1.4.1.94.1.16.4.3.1.1.1	Integer32	read-only	The value of ifIndex which corresponds to the first interface for which this aggregation class handles tokens.
I32 rsAggregationClassIndex	1.3.6.1.4.1.94.1.16.4.3.1.1.2	Integer32	read-only	The unique row index of this aggregation class(queue).
I32 rsAggregationClassMeanRate	1.3.6.1.4.1.94.1.16.4.3.1.1.5	Integer32	read-create	The peak bandwidth when rsAggregationClassBurstRate and rsAggregationClassBurstDuration are not set. When mean rate and burst duration are set, the mean rate specifies the long-term rate which the packet stream will be shaped to, but the packet stream can burst above that rate for as long as the burst duration specifies with no penalty. The value noSuchName should be returned if an attempt is made to set the value to a rate is higher than the rate available to this aggregation class.
STR rsAggregationClassName	1.3.6.1.4.1.94.1.16.4.3.1.1.4	DisplayString	read-create	A string which uniquely represents this aggregation class.
ROW rsAggregationClassRowStatus	1.3.6.1.4.1.94.1.16.4.3.1.1.8	RowStatus	read-create	The current status of this aggregation class. The behavior of this aggregation class upon changing of this object should be analogous to the behavior of a rule when its rsRuleRowStatus is modified.
PAC rsAggregationClassStatDirection	1.3.6.1.4.1.94.1.16.4.5.1.1.3	PacketSource	read-only	The data source for this aggregation class.
C32 rsAggregationClassStatDroppedOctets	1.3.6.1.4.1.94.1.16.4.5.1.1.9	Counter32	read-only	The counter of bytes which exceeded this rate limit.
C32 rsAggregationClassStatDroppedPkts	1.3.6.1.4.1.94.1.16.4.5.1.1.8	Counter32	read-only	The counter of packets which exceeded this rate limit.
C32 rsAggregationClassStatEnqueuedOctets	1.3.6.1.4.1.94.1.16.4.5.1.1.7	Counter32	read-only	The counter of enqueued bytes by this rate limit.
C32 rsAggregationClassStatEnqueuedPkts	1.3.6.1.4.1.94.1.16.4.5.1.1.6	Counter32	read-only	The counter of packets enqueued by this rate limit.
rsAggregationClassStatEntry	1.3.6.1.4.1.94.1.16.4.5.1.1		not-accessible	A collection of aggregation class status objects on this interface. Entries are created and deleted via the rate-limit command line interface.
I32 rsAggregationClassStatIfIndex	1.3.6.1.4.1.94.1.16.4.5.1.1.1	Integer32	read-only	The value of ifIndex which corresponds to the interface for which this aggregation class handles tokens for.
I32 rsAggregationClassStatIndex	1.3.6.1.4.1.94.1.16.4.5.1.1.2	Integer32	read-only	The value of rsAggregationClassIndex for the aggregation class which this entry describes.
C32 rsAggregationClassStatInputBytesPassed	1.3.6.1.4.1.94.1.16.4.5.1.1.12	Counter32	read-only	The counter of bytes successfully exiting this aggregation class.
C32 rsAggregationClassStatInputPktsPassed	1.3.6.1.4.1.94.1.16.4.5.1.1.10	Counter32	read-only	The counter of packets successfully exiting this aggregation class.
C32 rsAggregationClassStatOutputBytesPassed	1.3.6.1.4.1.94.1.16.4.5.1.1.13	Counter32	read-only	The counter of bytes successfully exiting this aggregation class.
C32 rsAggregationClassStatOutputPktsPassed	1.3.6.1.4.1.94.1.16.4.5.1.1.11	Counter32	read-only	The counter of packets successfully exiting this aggregation class.
rsAggregationClassStats	1.3.6.1.4.1.94.1.16.4.5			A collection of objects providing the instrumentation of rsAggregationClassStats
C32 rsAggregationClassStatShapedOctets	1.3.6.1.4.1.94.1.16.4.5.1.1.5	Counter32	read-only	The counter of bytes shaped by this interface.
C32 rsAggregationClassStatShapedPkts	1.3.6.1.4.1.94.1.16.4.5.1.1.4	Counter32	read-only	The counter of packets shaped by this rate limit.
rsAggregationClassStatTable	1.3.6.1.4.1.94.1.16.4.5.1		not-accessible	A table of aggregation class status entries.
rsAggregationClassTable	1.3.6.1.4.1.94.1.16.4.3.1		not-accessible	A table of aggregation class entries.
RAT rsRuleAction	1.3.6.1.4.1.94.1.16.4.2.1.1.5	RateLimitAction	read-create	The forwarding Action associated with this rule.
I32 rsRuleAggregationClassIndex	1.3.6.1.4.1.94.1.16.4.2.1.1.15	Integer32	read-only	The index(rsAggregationClassIndex) to the aggregation class(queue) if RateLimitAction is enqueue(3).
IP rsRuleDestAddress	1.3.6.1.4.1.94.1.16.4.2.1.1.8	IpAddress	read-create	The destination IP address for this rule.
IP rsRuleDestAddrMask	1.3.6.1.4.1.94.1.16.4.2.1.1.9	IpAddress	read-create	The mask of destination address for this rule.
I32 rsRuleDestEndingPort	1.3.6.1.4.1.94.1.16.4.2.1.1.14	Integer32	read-only	The end of the destination range of port number(s) of the IP protocol for this rule.
I32 rsRuleDestStartingPort	1.3.6.1.4.1.94.1.16.4.2.1.1.13	Integer32	read-create	The start of the destination range of port number(s) of the IP protocol for this rule.
PAC rsRuleDirection	1.3.6.1.4.1.94.1.16.4.2.1.1.3	PacketSource	read-only	The data source for the Rate Limit object.
rsRuleEntry	1.3.6.1.4.1.94.1.16.4.2.1.1		not-accessible	A collection of rate-limit configuration objects on this interface. Entries in the rsRuleTable is created and deleted via the rate-limit command line interface.
INT rsRuleEstablished	1.3.6.1.4.1.94.1.16.4.2.1.1.16	INTEGER	read-only	An integer value indicating whether or not this rule is effective on previously-established TCP connections. 'established' will indicate that upon activation of this rule, only previously-established TCP connections will match this rule. 'notEstablished' will indicate that any TCP connection can match this rule.
I32 rsRuleIfIndex	1.3.6.1.4.1.94.1.16.4.2.1.1.1	Integer32	read-only	The ifIndex of the MIB-II interface which this access list entry is responsible for.
I32 rsRuleIndex	1.3.6.1.4.1.94.1.16.4.2.1.1.2	Integer32	read-only	An arbitrary index for rate limit objects. It will increase as the list for each rsRuleIfIndex is traversed.In other words,the value of rsRuleIndex increments for the same value of rsRuleIfIndex, but starts over at 1 once the value of rsRuleIfIndex changes.
I32 rsRuleIpProtocol	1.3.6.1.4.1.94.1.16.4.2.1.1.10	Integer32	read-create	The number of IP protocol that rule applies on.
ROW rsRuleRowStatus	1.3.6.1.4.1.94.1.16.4.2.1.1.17	RowStatus	read-create	The current status of this rule. The rules defined in this table is treated as a linked list. By definition rsRuleRowStatus will ensure that there are no orphan rules i.e the linked list is not broken. Setting a rule to 'destroy' has the effect of deleting this rule. createAndGo(4) appends to the list thus ensuring that there are no orphans.
rsRules	1.3.6.1.4.1.94.1.16.4.2			A collection of objects providing the instrumentation of rsRules
IP rsRuleSrcAddress	1.3.6.1.4.1.94.1.16.4.2.1.1.6	IpAddress	read-create	The source IP address for this rule.
IP rsRuleSrcAddrMask	1.3.6.1.4.1.94.1.16.4.2.1.1.7	IpAddress	read-create	The mask of source address for this rule.
I32 rsRuleSrcEndingPort	1.3.6.1.4.1.94.1.16.4.2.1.1.12	Integer32	read-only	The end of the source range of port number(s) of the IP protocol for this rule.
I32 rsRuleSrcStartingPort	1.3.6.1.4.1.94.1.16.4.2.1.1.11	Integer32	read-create	The start of the source range of port number(s) of the IP protocol for this rule.
C32 rsRuleStatBytesPassed	1.3.6.1.4.1.94.1.16.4.6.1.1.7	Counter32	read-only	Gives the count of number of bytes successfully exiting this rule.
PAC rsRuleStatDirection	1.3.6.1.4.1.94.1.16.4.6.1.1.3	PacketSource	read-only	The data source for this rule.
C32 rsRuleStatDropOctets	1.3.6.1.4.1.94.1.16.4.6.1.1.5	Counter32	read-only	The counter of bytes which exceeded this rate limit.
C32 rsRuleStatDropPkts	1.3.6.1.4.1.94.1.16.4.6.1.1.4	Counter32	read-only	The counter of packets which exceeded this rate limit.
rsRuleStatEntry	1.3.6.1.4.1.94.1.16.4.6.1.1		not-accessible	A collection of rate-limit status objects on this interface.
I32 rsRuleStatIfIndex	1.3.6.1.4.1.94.1.16.4.6.1.1.1	Integer32	read-only	The value of ifIndex which corresponds to the interface for which this rule is applied to.
I32 rsRuleStatIndex	1.3.6.1.4.1.94.1.16.4.6.1.1.2	Integer32	read-only	The rsRuleIndex value of the rule this entry describes.
C32 rsRuleStatPktsPassed	1.3.6.1.4.1.94.1.16.4.6.1.1.6	Counter32	read-only	Gives the count of number of packets successfully exiting this rule.
rsRuleStats	1.3.6.1.4.1.94.1.16.4.6			A collection of objects providing the instrumentation of rsRuleStats
rsRuleStatTable	1.3.6.1.4.1.94.1.16.4.6.1		not-accessible	A table of rate limit status entries.
rsRuleTable	1.3.6.1.4.1.94.1.16.4.2.1		not-accessible	A table of rate limit configuration entries. Rate Limit is a method of traffic control. It allows a set of rate limits to be configured and applied to packets flowing into/out of an interface to regulate network traffic.
I32 rsRuleTOS	1.3.6.1.4.1.94.1.16.4.2.1.1.4	Integer32	read-only	The TOS field of the type of packet which this rule governs.

RFC description

Vendor-private MIB for Nokia rate-shaping and traffic control features; manages bandwidth limiting and traffic policing configuration.

Start monitoring Nokia network element (router/switch, outbound rate shaping) 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 NOKIA-RATESHAPE-MIB