CISCO-PORT-STORM-CONTROL-MIB
File:
CISCO-PORT-STORM-CONTROL-MIB.mib (24942 bytes)
Imported modules
Imported symbols
Defined Types
CPortStormControlTrafficType |
|
The type of traffic that can be configured to be
regulated per physical interface. |
TEXTUAL-CONVENTION |
|
|
|
|
INTEGER |
broadcast(1), multicast(2), unicast(3), all(4) |
|
CPortStormControlActionType |
|
The type of storm control action that is configured on
a port.
An action of filter indicates that packets should be
filtered if a storm event is detected on a port.
An action of shutdown indicates that the port should be
shutdown if a storm event is detected on a port. |
TEXTUAL-CONVENTION |
|
|
|
|
INTEGER |
filter(1), shutdown(2) |
|
CPortStormControlStatusType |
|
The current status of storm control on a given
interface for a given traffic type.
inactive - Indicates that storm control is not enabled
for the given traffic type.
forwarding - Indicates that storm control is monitoring
the traffic type, but no storm event has
been detected.
trafficTypeFiltered - Indicates that a storm event has
has occurred and the particular
traffic type is being filtered
allTrafficFiltered - Indicates that a storm event has
occurred and all traffic received
on the interface is being filtered
shutdown - Indicates that the interface has been
shutdown in response to a storm event. |
TEXTUAL-CONVENTION |
|
|
|
|
INTEGER |
inactive(1), forwarding(2), trafficTypeFiltered(3), allTrafficFiltered(4), shutdown(5) |
|
CPortSCThresholdEntry |
|
SEQUENCE |
|
|
|
|
cpscTrafficType |
CPortStormControlTrafficType |
|
|
cpscUpperThreshold |
INTEGER |
|
|
cpscLowerThreshold |
INTEGER |
|
CPortSCActionEntry |
|
SEQUENCE |
|
|
|
|
cpscAction |
CPortStormControlActionType |
|
|
cpscNotificationControl |
INTEGER |
|
CPortSCStatusEntry |
|
SEQUENCE |
|
|
|
|
cpscStatus |
CPortStormControlStatusType |
|
|
cpscCurrentLevel |
INTEGER |
|
|
cpscSuppressedPacket |
Counter64 |
|
CPortSCHistoryEntry |
|
SEQUENCE |
|
|
|
|
cpscHistoryTrafficType |
CPortStormControlTrafficType |
|
|
cpscHistoryIndex |
Integer32 |
|
|
cpscHistoryStartTime |
TimeStamp |
|
|
cpscHistoryEndTime |
TimeStamp |
|
Defined Values
cpscThresholdEntry |
1.3.6.1.4.1.9.9.362.1.1.1.1 |
A collection of storm control threshold configuration
entries.
Storm control can be configured for multiple traffic types
on a given interface. One entry is created for each
interface and the traffic type that can be monitored by
the device. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
CPortSCThresholdEntry |
|
|
cpscTrafficType |
1.3.6.1.4.1.9.9.362.1.1.1.1.1 |
This object identifies a particular traffic type
for which a management station desires to configure
storm control on the given interface (which is identified
by its ifIndex). |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
CPortStormControlTrafficType |
|
|
cpscUpperThreshold |
1.3.6.1.4.1.9.9.362.1.1.1.1.2 |
This object represents the upper threshold of total
amount of a particular traffic type that can be seen
on a given interface, after which a storm event is
declared and storm control action is taken.
The value represents the traffic as a percentage of
total bandwidth of the interface, in units of 0.01 %.
For example, if a management station sets the value of
cpscUpperThreshold.3.1 as 4000, it means the
following:
a) storm control is enabled on the interface with
ifIndex = 3 for broadcast (1) packets
b) if the broadcast traffic received per second
on the interface is more than (4000*0.01 = 40%) of
the total interface bandwidth, then the system will
take storm control actions, as indicated by
cpscAction.3 .
It should be noted that setting the upper threshold value
to anything other than 100% results in storm control being
automatically enabled on the given interface, for the
given traffic type.
An implementation may not be able to support different
threshold values for different traffic types, in which
case changing the value for one traffic type will
automatically result in the threshold value for other
types also modified.
The default value of this object is implementation-
dependent. |
Status: current |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
INTEGER |
0..10000 |
|
cpscLowerThreshold |
1.3.6.1.4.1.9.9.362.1.1.1.1.3 |
This object represents the lower threshold of total
amount of a particular traffic type.
When a filter action (see cpscAction) is
in effect on an interface because of a previous storm
event, the value of this object determines when the
system will stop the filter action.
The value represents traffic as percent of total bandwidth
of the interface, in units of 0.01 %.
For example, if a broadcast(1) storm occurred on an
interface with ifIndex 3, and the value of
cpscLowerThreshold.3.1 is 2500 (25%), then
the system will stop filtering broadcast traffic on that
interface if it drops below 25% of the total bandwidth.
This value will be ignored if a shutdown action is
configured. The value of this object must be
equal to or less than the value of the upper threshold
specified by cpscUpperThreshold for the same entry.
The default value of this object is implementation-
dependent.
On platforms that only support one threshold level for
this traffic type and interface,this object is read-only
and always has the same value of the corresponding
cpscUpperThreshold for the same entry. |
Status: current |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
INTEGER |
0..10000 |
|
cpscActionEntry |
1.3.6.1.4.1.9.9.362.1.1.2.1 |
An entry containing the storm control action
configuration information. An entry is created for each
interface that can support the storm control feature. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
CPortSCActionEntry |
|
|
cpscAction |
1.3.6.1.4.1.9.9.362.1.1.2.1.1 |
This object represents the storm control action
taken when the traffic of a particular type exceeds
the configured upper threshold values. |
Status: current |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
CPortStormControlActionType |
|
|
cpscNotificationControl |
1.3.6.1.4.1.9.9.362.1.1.2.1.2 |
This object controls when a storm control notification
will be generated.
If the object is set to none(1), no notifications will
be generated.
A notification will be generated when a storm event is
detected or cleared when the object is set to
stormOccurred(2) or stormCleared(3) respectively.
If the object is set to both(4), a notification will be
generated both when a storm event is detected and
cleared.
NOTE:
a) The default value of this object is none(1).
b) Irrespective of the value of this object, the
value of the global object cpscNotificationThreshold
controls whether or not a notification will be
generated at a given point. |
Status: current |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
INTEGER |
none(1), stormOccurred(2), stormCleared(3), both(4) |
|
cpscNotificationThreshold |
1.3.6.1.4.1.9.9.362.1.1.3 |
The value of object controls the global rate of storm
control notifications generated by an entity per minute.
A value of 0 indicates no limit, and the entity will
generate notifications for each storm event as governed by
the cpscNotificationControl for a given interface. |
Status: current |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
INTEGER |
0..1000 |
|
cpscStatusEntry |
1.3.6.1.4.1.9.9.362.1.2.1.1 |
A collection of storm control status entries, one per
interface and traffic type.
An entry is created for each storm control capable
interface and the traffic type with the storm control
status information. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
CPortSCStatusEntry |
|
|
cpscStatus |
1.3.6.1.4.1.9.9.362.1.2.1.1.1 |
This object identifies the status of storm control
on the interface (identified by ifIndex) corresponding
to a particular traffic type (identified by
cpscTrafficType).
A value of inactive indicates that no storm control
has been enabled on the interface for the traffic type. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
CPortStormControlStatusType |
|
|
cpscCurrentLevel |
1.3.6.1.4.1.9.9.362.1.2.1.1.2 |
This object identifies the current level of traffic of
a particular type on a given interface, as a percentage
of the total interface bandwidth.
When storm control is inactive, the value is 10000,
indicating the maximum level (100% of the particular
traffic type is allowed to be received). |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
INTEGER |
0..10000 |
|
cpscSuppressedPacket |
1.3.6.1.4.1.9.9.362.1.2.1.1.3 |
This object represents the total number of packets
of a particular traffic type that have been suppressed
on a given interface by storm control filter action. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
Counter64 |
|
|
cpscHistoryTable |
1.3.6.1.4.1.9.9.362.1.2.2 |
A conceptual table to represent the history
of storm events on an interface.
Management station can use this to get
information about the timeline of storm events as
to when each event occurred, and when it ended. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
SEQUENCE OF |
|
|
|
|
CPortSCHistoryEntry |
|
cpscHistoryEntry |
1.3.6.1.4.1.9.9.362.1.2.2.1 |
A collection of storm control history entries
per interface and per traffic type. The number of such
entries available is implementation-dependent. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
CPortSCHistoryEntry |
|
|
cpscHistoryTrafficType |
1.3.6.1.4.1.9.9.362.1.2.2.1.1 |
The traffic type corresponding to this storm history
entry. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
CPortStormControlTrafficType |
|
|
cpscHistoryIndex |
1.3.6.1.4.1.9.9.362.1.2.2.1.2 |
A number that uniquely identifies one storm control
history entry for a given interface. The index starts
at 1 and increases by 1.
Although this MIB specification stipulates a maximum of
1K entries, the actual maximum number of history entries
returned per interface is implementation-dependent.
When the value of this index reaches the actual maximum
number of entries supported by an implementation, it will
wrap around to 1. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
Integer32 |
1..1024 |
|
cpscHistoryStartTime |
1.3.6.1.4.1.9.9.362.1.2.2.1.3 |
The value of sysUpTime when the storm event was declared
on the interface for the particular traffic type, and
storm control measures were taken. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
TimeStamp |
|
|
cpscHistoryEndTime |
1.3.6.1.4.1.9.9.362.1.2.2.1.4 |
The value of sysUpTime when the storm ceased to exist
and the interface was set to its previous normal state.
If the interface was shutdown due to user configuration,
then the value will be equal to the value of sysUpTime
when the interface was shutdown.
If the storm event continues to persist when this object
is queried, the value returned will be 0. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
TimeStamp |
|
|
cpscEventRev1 |
1.3.6.1.4.1.9.9.362.0.2 |
This notification is sent by the implementation when
a storm event occurs on an interface with respect to
a particular traffic type.
cpscEventRev1 deprecates cpscEvent to make it RFC 2578
compliant. According to section 8.5 of RFC 2578, the next
to last sub-identifier in the name of any newly-defined
notification must have the value zero. |
Status: current |
Access: read-only |
NOTIFICATION-TYPE |
|
|
|
cpscEvent |
1.3.6.1.4.1.9.9.362.0.1.1 |
This notification is sent by the implementation when
a storm event occurs on an interface with respect to
a particular traffic type.
cpscEvent is deprecated and replaced by cpscEventRev1. |
Status: deprecated |
Access: read-only |
NOTIFICATION-TYPE |
|
|
|
ciscoPortStormControlMIBCompliance |
1.3.6.1.4.1.9.9.362.2.1.1 |
The compliance statement for the cisco port storm
control MIB. |
Status: deprecated |
Access: read-only |
MODULE-COMPLIANCE |
|
|
|
cpscConfigurationGroup |
1.3.6.1.4.1.9.9.362.2.2.1 |
A collection of objects to configure the Port Storm
Control feature on a given interface. |
Status: current |
Access: read-only |
OBJECT-GROUP |
|
|
|
cpscStatusGroup |
1.3.6.1.4.1.9.9.362.2.2.2 |
A collection of objects to provide storm control
status on a given interface. |
Status: current |
Access: read-only |
OBJECT-GROUP |
|
|
|
cpscNotificationGroup |
1.3.6.1.4.1.9.9.362.2.2.3 |
A collection of notification objects for user with
the cisco port storm control mib. |
Status: deprecated |
Access: read-only |
NOTIFICATION-GROUP |
|
|
|
cpscNotifConfigurationGroup |
1.3.6.1.4.1.9.9.362.2.2.4 |
A collection of objects to configure notification
information. |
Status: current |
Access: read-only |
OBJECT-GROUP |
|
|
|
cpscStatisticsGroup |
1.3.6.1.4.1.9.9.362.2.2.5 |
A collection of objects to provide storm control
statistics information. |
Status: current |
Access: read-only |
OBJECT-GROUP |
|
|
|
cpscHistoryGroup |
1.3.6.1.4.1.9.9.362.2.2.6 |
A collection of objects to provide storm control
history information on a given interface. |
Status: current |
Access: read-only |
OBJECT-GROUP |
|
|
|
cpscNotificationGroupRev1 |
1.3.6.1.4.1.9.9.362.2.2.7 |
A collection of notification objects for user with
the cisco port storm control mib. |
Status: current |
Access: read-only |
NOTIFICATION-GROUP |
|
|
|