Standard view Table view

FS-NMS-IF-THRESHOLD-MIB

        This MIB module defines the managed objects that support
monitoring of thresholds on interfaces.  Configuration and
monitoring of the thresholds is done through threshold
templates that can be assigned to any subset of interfaces on
the network element.  More than one threshold template can be
assigned to a given interface.
        
This MIB module should be used when it is desired to apply a
common set of thresholds to a subset of the available
interfaces.  If a threshold is to be applied to only one
interface, then the EVENT-MIB or the RMON-MIB may be used as
simpler alternatives.  If a threshold is to be applied to all
available interfaces, then the EVENT-MIB may be used as a
simpler alternative.

Source file: FS-NMS-IF-THRESHOLD-MIB
Last revised: 16 Oct 2003, 00:00 UTC
Identity: nmsIfThresholdMIB
Base OID: 1.3.6.1.4.1.52642.9.218

Imported Objects

FS-NMS-SMI	nmsMgmt
IF-MIB	ifIndex InterfaceIndex
SNMP-FRAMEWORK-MIB	SnmpAdminString
SNMPv2-CONF	MODULE-COMPLIANCE (no object page) NOTIFICATION-GROUP (no object page) OBJECT-GROUP (no object page)
SNMPv2-SMI	Integer32 MODULE-IDENTITY (no object page) NOTIFICATION-TYPE (no object page) OBJECT-TYPE (no object page) Unsigned32
SNMPv2-TC	RowStatus TEXTUAL-CONVENTION (no object page) TimeStamp TruthValue

Net-SNMP examples using the fscom-nms 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 'FS-NMS-IF-THRESHOLD-MIB' -M '/opt/observium/mibs/fscom-nms:/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'FS-NMS-IF-THRESHOLD-MIB::nmsIfThresholdMIB'

Walk the MIB subtree

/usr/bin/snmpbulkwalk -v2c -c '<community>' -Pud -Ir -OQUs -m 'FS-NMS-IF-THRESHOLD-MIB' -M '/opt/observium/mibs/fscom-nms:/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'udp:<hostname>:161' 'FS-NMS-IF-THRESHOLD-MIB::nmsIfThresholdMIB'

How SNMP, Net-SNMP, MIB paths, and variants work

Objects (49)

nmsIfThresholdMIB		`.1.3.6.1.4.1.52642.9.218`
nmsIfThresholdMIBObjects		`.1.3.6.1.4.1.52642.9.218.1`
nmsifthTemplateGroup		`.1.3.6.1.4.1.52642.9.218.1.1`
nmsifthTemplateIndexNext	NMSifthTemplateIndexOrZero	`.1.3.6.1.4.1.52642.9.218.1.1.1`
nmsifthTemplateLastChange	SNMPv2-TCTimeStamp	`.1.3.6.1.4.1.52642.9.218.1.1.2`
nmsifthTemplateTable		`.1.3.6.1.4.1.52642.9.218.1.1.3`
nmsifthTemplateEntry	nmsifthTemplateIndex	`.1.3.6.1.4.1.52642.9.218.1.1.3.1`
nmsifthTemplateIndex	NMSifthTemplateIndex	`.1.3.6.1.4.1.52642.9.218.1.1.3.1.1`
nmsifthTemplateName r/w	SNMP-FRAMEWORK-MIBSnmpAdminString	`.1.3.6.1.4.1.52642.9.218.1.1.3.1.2`
nmsifthTemplateNotifyHoldDownType r/w	Enumeration	`.1.3.6.1.4.1.52642.9.218.1.1.3.1.3`
nmsifthTemplateNotifyHoldDownTime r/w	secondsUnsigned32	`.1.3.6.1.4.1.52642.9.218.1.1.3.1.4`
nmsifthTemplateRowStatus r/w	SNMPv2-TCRowStatus	`.1.3.6.1.4.1.52642.9.218.1.1.3.1.5`
nmsifthThresholdLastChange	SNMPv2-TCTimeStamp	`.1.3.6.1.4.1.52642.9.218.1.1.4`
nmsifthThresholdTable		`.1.3.6.1.4.1.52642.9.218.1.1.5`
nmsifthThresholdEntry	nmsifthTemplateIndexnmsifthThresholdIndex	`.1.3.6.1.4.1.52642.9.218.1.1.5.1`
nmsifthThresholdIndex	NMSifthThresholdIndex	`.1.3.6.1.4.1.52642.9.218.1.1.5.1.1`
nmsifthThresholdApsSwitchover r/w	SNMPv2-TCTruthValue	`.1.3.6.1.4.1.52642.9.218.1.1.5.1.10`
nmsifthThresholdRowStatus r/w	SNMPv2-TCRowStatus	`.1.3.6.1.4.1.52642.9.218.1.1.5.1.11`
nmsifthThresholdDescr r/w	SNMP-FRAMEWORK-MIBSnmpAdminString	`.1.3.6.1.4.1.52642.9.218.1.1.5.1.2`
nmsifthThresholdObject r/w	ObjectIdentifier	`.1.3.6.1.4.1.52642.9.218.1.1.5.1.3`
nmsifthThresholdSeverity r/w	NMSifthThresholdSeverity	`.1.3.6.1.4.1.52642.9.218.1.1.5.1.4`
nmsifthThresholdType r/w	Enumeration	`.1.3.6.1.4.1.52642.9.218.1.1.5.1.5`
nmsifthThresholdDirection r/w	Enumeration	`.1.3.6.1.4.1.52642.9.218.1.1.5.1.6`
nmsifthThresholdFiredValue r/w	Integer32	`.1.3.6.1.4.1.52642.9.218.1.1.5.1.7`
nmsifthThresholdClearedValue r/w	Integer32	`.1.3.6.1.4.1.52642.9.218.1.1.5.1.8`
nmsifthThresholdSampleInterval r/w	millisecondsUnsigned32	`.1.3.6.1.4.1.52642.9.218.1.1.5.1.9`
nmsifthTemplateIfAssignGroup		`.1.3.6.1.4.1.52642.9.218.1.2`
nmsifthTemplateIfLastChange	SNMPv2-TCTimeStamp	`.1.3.6.1.4.1.52642.9.218.1.2.1`
nmsifthTemplateIfAssignTable		`.1.3.6.1.4.1.52642.9.218.1.2.2`
nmsifthTemplateIfAssignEntry	nmsifthTemplateIndexnmsifthTemplateIfAssignInterface	`.1.3.6.1.4.1.52642.9.218.1.2.2.1`
nmsifthTemplateIfAssignInterface	IF-MIBInterfaceIndex	`.1.3.6.1.4.1.52642.9.218.1.2.2.1.1`
nmsifthTemplateIfAssignOperStatus	Enumeration	`.1.3.6.1.4.1.52642.9.218.1.2.2.1.2`
nmsifthTemplateIfAssignRowStatus r/w	SNMPv2-TCRowStatus	`.1.3.6.1.4.1.52642.9.218.1.2.2.1.3`
nmsifthIfThresholdFiredGroup		`.1.3.6.1.4.1.52642.9.218.1.3`
nmsifthThresholdFiredNotifyEnable r/w	NMSifthThresholdSeverityOrZero	`.1.3.6.1.4.1.52642.9.218.1.3.1`
nmsifthThresholdFiredLastChange	SNMPv2-TCTimeStamp	`.1.3.6.1.4.1.52642.9.218.1.3.2`
nmsifthIfThresholdFiredTable		`.1.3.6.1.4.1.52642.9.218.1.3.3`
nmsifthIfThresholdFiredEntry	IF-MIBifIndexnmsifthIfThresholdFiredTemplate	`.1.3.6.1.4.1.52642.9.218.1.3.3.1`
nmsifthIfThresholdFiredTemplate	NMSifthTemplateIndex	`.1.3.6.1.4.1.52642.9.218.1.3.3.1.1`
nmsifthIfThresholdsFired	NMSifthThresholdList	`.1.3.6.1.4.1.52642.9.218.1.3.3.1.2`
nmsifthIfLastThresholdFired	NMSifthThresholdIndex	`.1.3.6.1.4.1.52642.9.218.1.3.3.1.3`
nmsifthIfThresholdFiredLstChange	SNMPv2-TCTimeStamp	`.1.3.6.1.4.1.52642.9.218.1.3.3.1.4`
nmsifthIfThresholdFiredLstSeverity	NMSifthThresholdSeverity	`.1.3.6.1.4.1.52642.9.218.1.3.3.1.5`
nmsifthIfThresholdFiredMaxSeverity	NMSifthThresholdSeverity	`.1.3.6.1.4.1.52642.9.218.1.3.3.1.6`
nmsIfThresholdMIBNotifications		`.1.3.6.1.4.1.52642.9.218.2`
nmsifthMIBNotificationsPrefix		`.1.3.6.1.4.1.52642.9.218.2.0`
nmsIfThresholdMIBConformance		`.1.3.6.1.4.1.52642.9.218.3`
nmsIfThresholdMIBCompliances		`.1.3.6.1.4.1.52642.9.218.3.1`
nmsIfThresholdMIBGroups		`.1.3.6.1.4.1.52642.9.218.3.2`

Dependencies (8) 6 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

FS-NMS-IF-THRESHOLD-MIBfscom-nmsselected
- FS-NMS-SMIfscom-nms1 symbol
  - SNMPv2-SMIrfcdefault fallback3 symbols
- IF-MIBrfcdefault fallback2 symbols
  - IANAifType-MIBrfc1 symbol
    - SNMPv2-SMIrfcshared2 symbols
    - SNMPv2-TCrfc1 symbol
      - SNMPv2-SMIrfcshared1 symbol
  - SNMPv2-CONFrfc3 symbols
    - SNMPv2-SMIrfcshared3 symbols
  - SNMPv2-MIBrfc1 symbol
    - SNMPv2-CONFrfcshared3 symbols
    - SNMPv2-SMIrfcshared7 symbols
    - SNMPv2-TCrfcshared3 symbols
  - SNMPv2-SMIrfcshared9 symbols
  - SNMPv2-TCrfcshared8 symbols
- SNMP-FRAMEWORK-MIBrfcdefault fallback1 symbol
  - SNMPv2-CONFrfcshared2 symbols
  - SNMPv2-SMIrfcshared4 symbols
  - SNMPv2-TCrfcshared1 symbol
- SNMPv2-CONFrfcdefault fallbackshared3 symbols
- SNMPv2-SMIrfcdefault fallbackshared5 symbols
- SNMPv2-TCrfcdefault fallbackshared4 symbols

Dependency-first compile order

SNMPv2-SMIrfc
FS-NMS-SMIfscom-nms
SNMPv2-TCrfc
IANAifType-MIBrfc
SNMPv2-CONFrfc
SNMPv2-MIBrfc
IF-MIBrfc
SNMP-FRAMEWORK-MIBrfc
FS-NMS-IF-THRESHOLD-MIBfscom-nmsselected

Type Definitions (6)

NMSifthTemplateIndex	Unsigned32	`range: 1..1000` An arbitrary integer that uniquely identifies a threshold template. The value for each threshold template must remain constant at least from one re-initialization of the agent's network management system to the next re-initialization. The value may change when the agent's network management system is rebooted or re-initialized.
NMSifthTemplateIndexOrZero	Unsigned32	`range: 0..1000` A value of either '0' or a valid template index. The distinguished value '0' indicates no template or no unassigned template index values are available.
NMSifthThresholdIndex	Unsigned32	`range: 0..63` An arbitrary integer that uniquely identifies a threshold within a threshold template. The value for each threshold must remain constant when the agent's network management system is rebooted or re-initialized.
NMSifthThresholdList	OctetString	`range: 0..8` A list of thresholds defined in a given template, in which each bit represents one threshold. The bits in the first octet represent thresholds identified by nmsifthThresholdIndex values 0 through 7, inclusive. The bits in the second octet represent thresholds identified by integer values 8 through 15, inclusive, and so forth. The least significant bit of an octet represents the threshold identified by the lowest integer value, and the most significant bit represents the threshold identified by the highest integer value. The figure shown below illustrates the format of a threshold list. Octet 1 Octet 8 7 6 5 4 3 2 1 0 7 6 5 4 3 2 1 0 +-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+ \| \|...\| \| +-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+ \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| \| +- Threshold 56 \| \| \| \| \| \| \| \| \| \| \| \| \| \| +--- Threshold 57 \| \| \| \| \| \| \| \| \| \| \| \| \| +----- Threshold 58 \| \| \| \| \| \| \| \| \| \| \| \| +------- Threshold 59 \| \| \| \| \| \| \| \| \| \| \| +--------- Threshold 60 \| \| \| \| \| \| \| \| \| \| +----------- Threshold 61 \| \| \| \| \| \| \| \| \| +------------- Threshold 62 \| \| \| \| \| \| \| \| +--------------- Threshold 63 \| \| \| \| \| \| \| \| : \| \| \| \| \| \| \| \| : \| \| \| \| \| \| \| +--------------------- Threshold 0 \| \| \| \| \| \| +----------------------- Threshold 1 \| \| \| \| \| +------------------------- Threshold 2 \| \| \| \| +--------------------------- Threshold 3 \| \| \| +----------------------------- Threshold 4 \| \| +------------------------------- Threshold 5 \| +--------------------------------- Threshold 6 +----------------------------------- Threshold 7 A bit value of '1' indicates that the threshold is being exceeded in current operation (i.e., the threshold is fired). A bit value of '0' indicates that the threshold is not being exceeded in current operation (i.e., the threshold is cleared). A threshold list of length N, where N < 8, represents a threshold list for which thresholds N*8 through 63 have the value of '0'. A special case is a threshold list having a length of '0', which represents a threshold list of all zeros.
NMSifthThresholdSeverity	Enumeration	`fail(1)` `degrade(2)` `info(3)` `other(4)` The severity of the condition when the threshold is fired. A smaller enumerated integer value indicates that the threshold exceeded condition is more severe. The value 'fail' indicates a hard failure condition where no data can be received, or where the data received has a large number of errors which makes it impossible to recover most of the data. The value 'degrade' indicates a soft failure condition in which data received on this interface is affected, but a significant portion of the data can be recovered. The value 'info' is used to raise attention to a condition that could possibly be an impending problem or to notify the customer of an event that improves operation.
NMSifthThresholdSeverityOrZero	Integer32	`range: 0..4` A value of either '0' or a valid threshold severity.

Conformance Groups (7)

nmsIfThresholdTemplateGroup	nmsifthTemplateIndexNext nmsifthTemplateLastChange nmsifthTemplateName nmsifthTemplateNotifyHoldDownType nmsifthTemplateRowStatus nmsifthThresholdLastChange nmsifthThresholdDescr nmsifthThresholdObject nmsifthThresholdSeverity nmsifthThresholdType nmsifthThresholdDirection nmsifthThresholdFiredValue nmsifthThresholdSampleInterval nmsifthThresholdRowStatus nmsifthTemplateIfLastChange nmsifthTemplateIfAssignOperStatus nmsifthTemplateIfAssignRowStatus A collection of mandatory managed objects for configuration of threshold templates.	`.1.3.6.1.4.1.52642.9.218.3.2.1`
nmsIfThresholdFiredGroup	nmsifthThresholdFiredNotifyEnable nmsifthThresholdFiredLastChange nmsifthIfThresholdsFired nmsifthIfLastThresholdFired nmsifthIfThresholdFiredLstChange nmsifthIfThresholdFiredLstSeverity nmsifthIfThresholdFiredMaxSeverity A collection of mandatory managed objects for monitoring interfaces where thresholds have been exceeded.	`.1.3.6.1.4.1.52642.9.218.3.2.2`
nmsifthHoldDownTimerGroup	nmsifthTemplateNotifyHoldDownTime A collection of managed objects for configuration of a timer-based mechanism for suppression of excess notifications in a short time interval.	`.1.3.6.1.4.1.52642.9.218.3.2.3`
nmsifthHoldDownHysteresisGroup	nmsifthThresholdClearedValue A collection of managed objects for configuration of threshold values used to assert that the threshold is no longer being exceeded. These objects are part of the hysteresis mechanism used to prevent excess notifications in a short time interval.	`.1.3.6.1.4.1.52642.9.218.3.2.4`
nmsifthApsGroup	nmsifthThresholdApsSwitchover A collection of managed objects for configuration of APS switchover triggers based on interface thresholds.	`.1.3.6.1.4.1.52642.9.218.3.2.5`
nmsIfThresholdNotifsGroup	nmsifthIfThresholdFired nmsifthIfThresholdCleared A collection of notifications generated when an interface has a threshold fired or a threshold cleared condition.	`.1.3.6.1.4.1.52642.9.218.3.2.6`
nmsifthTemplateIfNotifsGroup	nmsifthTemplateIfStatusChange A collection of notifications related to the assignment of templates to interfaces.	`.1.3.6.1.4.1.52642.9.218.3.2.7`

Compliance Statements (1)

OID .1.3.6.1.4.1.52642.9.218.3.1.1

The compliance statement for entities that implement the NMS
Interface Threshold MIB.

Required groups

mandatory	nmsIfThresholdTemplateGroup
mandatory	nmsIfThresholdFiredGroup
mandatory	nmsIfThresholdNotifsGroup
optional	nmsifthHoldDownTimerGroup	This group is required only for entities that support suppression of excess notifications in a short time interval based on a timer, i.e., systems that support the nmsifthTemplateNotifyHoldDownType value 'holdDownTimer'. At least one of this group and nmsifthHoldDownHysteresisGroup must be supported.
optional	nmsifthHoldDownHysteresisGroup	This group is required only for entities that prevent excess notifications in a short time interval by using hysteresis, i.e., systems that support the nmsifthTemplateNotifyHoldDownType value 'fireAndClearThresholds'. At least one of this group and nmsifthHoldDownTimerGroup must be supported.
optional	nmsifthApsGroup	This group is required only for entities that support the NMS Interface Threshold MIB and support triggering of automatic protection switching (APS) based on thresholds of interface counters.
optional	nmsifthTemplateIfNotifsGroup	This group is required only for entities that do not allow multiple threshold values (in different threshold templates) of the same severity and direction on the same object to be applied on one interface.

Object refinements

Object	Access	Syntax	Description
nmsifthTemplateNotifyHoldDownType			At least one of the codepoints 'holdDownTimer' and 'fireAndClearThresholds' must be supported.
nmsifthThresholdType			At least one of the codepoints 'deltaValue' and 'rateOfIncreaseExponentXIfSpeed' must be supported.

Notifications / Traps (3)

Name	OID	Description
nmsifthIfThresholdFired nmsifthIfLastThresholdFired nmsifthIfThresholdFiredLstChange nmsifthIfThresholdFiredLstSeverity	`.1.3.6.1.4.1.52642.9.218.2.0.1`	The agent generates this notification when a threshold defined in a template is asserted on an interface. If a threshold is asserted for a given interface and template, nmsifthTemplateNotifyHoldDownTime is set to 'holdDownTimer' for that template, and this notification has recently been sent for the same threshold on the same interface, then this notification may be suppressed.
nmsifthIfThresholdCleared nmsifthIfLastThresholdFired nmsifthIfThresholdFiredLstChange nmsifthIfThresholdFiredLstSeverity	`.1.3.6.1.4.1.52642.9.218.2.0.2`	The agent generates this notification when a threshold, that has previously fired, is cleared on an interface. If a threshold is cleared for a given interface and template, nmsifthTemplateNotifyHoldDownTime is set to 'holdDownTimer' for that template, and this notification has recently been sent for the same threshold on the same interface, then this notification may be suppressed.
nmsifthTemplateIfStatusChange nmsifthTemplateIfAssignOperStatus	`.1.3.6.1.4.1.52642.9.218.2.0.3`	The agent generates this notification when a template comes up or goes down on an interface to which it is assigned, i.e., when the value of nmsifthTemplateIfAssignOperStatus changes. If a template becomes operationally down on an interface upon activation of a new entry in the nmsifthTemplateIfAssignTable, the agent generates this notification. The agent need not generate this notification when a new entry in the nmsifthTemplateIfAssignTable is activated, if the template becomes operational on the interface. The agent need not generate this notification when an entry in the nmsifthTemplateIfAssignTable is destroyed.