MPLS-FTN-STD-MIB

All MIBs › MPLS-FTN-STD-MIB

Organization: Multiprotocol Label Switching (MPLS) Working Group

Last Updated: 2004-06-03

Category: MPLS and Traffic Engineering

Description: Defines managed objects for modeling and managing MPLS FEC-to-NHLFE (FTN) mappings at ingress Label Edge Routers.

IPNetwork Monitor uses several OIDs from this MIB in network discovery and polling the applicable devices. Start monitoring MPLS-FTN-STD-MIB with a free 30-day trial of IPNetwork Monitor.

What Is MPLS-FTN-STD-MIB?

MPLS-FTN-STD-MIB is an IETF standards-track MIB (RFC 3814) that models FEC-to-NHLFE (FTN) mappings on MPLS ingress Label Edge Routers — the rules that classify incoming IP traffic into MPLS label-switched paths. It exposes classification/configuration data such as address-range matching criteria (mplsFTNSourceAddrMin/Max, mplsFTNDestAddrMin, mplsFTNAddrType, mplsFTNMask) and row lifecycle status (mplsFTNRowStatus) in the mplsFTNTable, plus change-tracking (mplsFTNTableLastChanged) and notification objects (mplsFTNNotifications). While primarily a configuration/classification MIB rather than a hardware-sensor MIB, monitoring it reveals the control-plane software status of MPLS traffic classification — whether FTN entries are active and whether classification rules have recently changed — important for diagnosing misrouted or unclassified MPLS traffic. It depends on the broader MPLS/LSR MIB framework (e.g., an MPLS label-switching MIB) for the label-switched paths that FTN entries map traffic onto. It is deployed on MPLS-capable routers acting as Label Edge Routers in service-provider or enterprise MPLS networks. Engineers can download the MPLS-FTN-STD-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in MPLS-FTN-STD-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

vendor-neutral, standards-based MIB (RFC 3814), not tied to a specific manufacturer — applies to MPLS-capable routers / Label Edge Routers

Monitoring Examples

An operator polls mplsFTNTable (indexed by mplsFTNIndex) to review mplsFTNSourceAddrMin/Max and mplsFTNDestAddrMin ranges defining which IP traffic maps to a given label-switched path, checking mplsFTNRowStatus to confirm the mapping is active; a change in mplsFTNTableLastChanged combined with an inactive row status would flag a broken or recently disabled FTN classification rule causing traffic to fall back to unlabeled routing.

What Can Be Monitored

FEC-to-NHLFE mapping table entries
traffic classification address ranges
FTN row/entry status
table last-changed timestamp
FTN index allocation

Imported Objects

From DIFFSERV-DSCP-TC

Dscp

From IF-MIB

InterfaceIndexOrZero
ifCounterDiscontinuityGroup	OBJECT-GROUP
ifGeneralInformationGroup	OBJECT-GROUP

From INET-ADDRESS-MIB

InetAddress
InetAddressType
InetPortNumber

From MPLS-TC-STD-MIB

mplsStdMIB

OBJECT-IDENTITY

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter64
Integer32
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

RowPointer
RowStatus
StorageType
TEXTUAL-CONVENTION
TimeStamp

How to Use in IPNetwork Monitor

Example using mplsFTNPerfMatchedPackets OID:

Select a device implementing MPLS-FTN-STD-MIB 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 mplsFTNPerfMatchedPackets 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. It reports the number of packets that matched the specified FTN entry if it is applied/mapped to the specified interface. 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 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
mplsFTNStdMIB	1.3.6.1.2.1.10.166.8			Copyright (C) The Internet Society (2004). The initial version of this MIB module was published in RFC 3814. For full legal notices see the RFC itself or see: http://www.ietf.org/copyrights/ianamib.html This MIB module contains managed object definitions for specifying FEC to NHLFE (FTN) mappings and corresponding performance for MPLS.
mplsFTNNotifications	1.3.6.1.2.1.10.166.8.0
mplsFTNObjects	1.3.6.1.2.1.10.166.8.1
MPL mplsFTNIndexNext	1.3.6.1.2.1.10.166.8.1.1	MplsFTNEntryIndexOrZero	read-only	This object contains the next available valid value to be used for mplsFTNIndex when creating entries in the mplsFTNTable. When creating a new conceptual row (configuration entry) in mplsFTNTable with an SNMP SET operation the command generator (Network Management Application) must first issue a management protocol retrieval operation to obtain the current value of this object. If the command responder (agent) does not wish to allow creation of more entries in mplsFTNTable, possibly because of resource exhaustion, this object MUST return a value of 0. If a non-zero value is returned the Network Management Application must determine whether the value is indeed still unused since two Network Management Applications may attempt to create a row simultaneously and use the same value. If it is currently unused and the SET succeeds, the agent MUST change the value of this object to a currently unused non-zero value (according to an implementation specific algorithm) or zero (if no further row creation will be permitted). If the value is in use, however, the SET fails and the Network Management Application must then reread this object to obtain a new usable value.
TIM mplsFTNTableLastChanged	1.3.6.1.2.1.10.166.8.1.2	TimeStamp	read-only	Indicates the last time an entry was added, deleted or modified in mplsFTNTable. Management stations should consult this object to determine if mplsFTNTable requires their attention. This object is particularly useful for applications performing a retrieval on mplsFTNTable to ensure that the table is not modified during the retrieval operation.
mplsFTNTable	1.3.6.1.2.1.10.166.8.1.3		not-accessible	This table contains the currently defined FTN entries. This table allows FEC to NHLFE mappings to be specified. Each entry in this table defines a rule to be applied to incoming packets (on interfaces that the FTN entry is activated on using mplsFTNMapTable) and an action to be taken on matching packets (mplsFTNActionPointer). This table supports 6-tuple matching rules based on one or more of source address range, destination address range, source port range, destination port range, IPv4 Protocol field or IPv6 next-header field and the DiffServ Code Point (DSCP) to be specified. The action pointer points either to instance of mplsXCEntry in MPLS-LSR-STD-MIB when the NHLFE is a non- TE LSP, or to an instance of mplsTunnelEntry in the MPLS-TE-STD-MIB when the NHLFE is an originating TE tunnel.
mplsFTNEntry	1.3.6.1.2.1.10.166.8.1.3.1		not-accessible	Each entry represents one FTN entry which defines a rule to compare incoming packets with and an action to be taken on matching packets.
MPL mplsFTNIndex	1.3.6.1.2.1.10.166.8.1.3.1.1	MplsFTNEntryIndex	not-accessible	This is the unique index for a conceptual row in mplsFTNTable. To create a new conceptual row in mplsFTNTable a Network Management Application SHOULD retrieve the current value of mplsFTNIndexNext to determine the next valid available value of mplsFTNIndex.
ROW mplsFTNRowStatus	1.3.6.1.2.1.10.166.8.1.3.1.2	RowStatus	read-create	Used for controlling the creation and deletion of this row. All writeable objects in this row may be modified at any time. If a Network Management Application attempts to delete a conceptual row by setting this object to 'destroy' and there are one or more entries in mplsFTNMapTable pointing to the row (i.e., when mplsFTNIndex of the conceptual row being deleted is equal to mplsFTNMapCurrIndex for one or more entries in mplsFTNMapTable), the agent MUST also destroy the corresponding entries in mplsFTNMapTable.
STR mplsFTNDescr	1.3.6.1.2.1.10.166.8.1.3.1.3	SnmpAdminString	read-create	The description of this FTN entry. Since the index for this table has no particular significance or meaning, this object should contain some meaningful text that an operator could use to further distinguish entries in this table.
BIT mplsFTNMask	1.3.6.1.2.1.10.166.8.1.3.1.4	Bits	read-create	This bit map indicates which of the fields described next, namely source address range, destination address range, source port range, destination port range, IPv4 Protocol field or IPv6 next-header field and Differentiated Services Code Point (DSCP) is active for this FTN entry. If a particular bit is set to zero then the corresponding field in the packet MUST be ignored for comparison purposes.
IPt mplsFTNAddrType	1.3.6.1.2.1.10.166.8.1.3.1.5	InetAddressType	read-create	This object determines the type of address contained in the source and destination address objects (mplsFTNSourceAddrMin, mplsFTNSourceAddrMax, mplsFTNDestAddrMin and mplsFTNDestAddrMax) of a conceptual row. This object MUST NOT be set to unknown(0) when mplsFTNMask has bit positions sourceAddr(0) or destAddr(1) set to one. When both these bit positions of mplsFTNMask are set to zero the value of mplsFTNAddrType SHOULD be set to unknown(0) and the corresponding source and destination address objects SHOULD be set to zero-length strings.
IP mplsFTNSourceAddrMin	1.3.6.1.2.1.10.166.8.1.3.1.6	InetAddress	read-create	The lower end of the source address range. The type of this object is determined by the corresponding mplsFTNAddrType object.
IP mplsFTNSourceAddrMax	1.3.6.1.2.1.10.166.8.1.3.1.7	InetAddress	read-create	The upper end of the source address range. The type of this object is determined by the corresponding mplsFTNAddrType object.
IP mplsFTNDestAddrMin	1.3.6.1.2.1.10.166.8.1.3.1.8	InetAddress	read-create	The lower end of the destination address range. The type of this object is determined by the corresponding mplsFTNAddrType object.
IP mplsFTNDestAddrMax	1.3.6.1.2.1.10.166.8.1.3.1.9	InetAddress	read-create	The higher end of the destination address range. The type of this object is determined by the corresponding mplsFTNAddrType object.
INE mplsFTNSourcePortMin	1.3.6.1.2.1.10.166.8.1.3.1.10	InetPortNumber	read-create	The lower end of the source port range.
INE mplsFTNSourcePortMax	1.3.6.1.2.1.10.166.8.1.3.1.11	InetPortNumber	read-create	The higher end of the source port range
INE mplsFTNDestPortMin	1.3.6.1.2.1.10.166.8.1.3.1.12	InetPortNumber	read-create	The lower end of the destination port range.
INE mplsFTNDestPortMax	1.3.6.1.2.1.10.166.8.1.3.1.13	InetPortNumber	read-create	The higher end of the destination port range.
I32 mplsFTNProtocol	1.3.6.1.2.1.10.166.8.1.3.1.14	Integer32	read-create	The IP protocol to match against the IPv4 protocol number or IPv6 Next-Header number in the packet. A value of 255 means match all. Note that the protocol number of 255 is reserved by IANA, and Next-Header number of 0 is used in IPv6.
DSC mplsFTNDscp	1.3.6.1.2.1.10.166.8.1.3.1.15	Dscp	read-create	The contents of the DSCP field.
INT mplsFTNActionType	1.3.6.1.2.1.10.166.8.1.3.1.16	INTEGER	read-create	The type of action to be taken on packets matching this FTN entry.
NUM mplsFTNActionPointer	1.3.6.1.2.1.10.166.8.1.3.1.17	RowPointer	read-create	If mplsFTNActionType is redirectLsp(1), then this object MUST contain zeroDotZero or point to a instance of mplsXCEntry indicating the LSP to redirect matching packets to. If mplsFTNActionType is redirectTunnel(2), then this object MUST contain zeroDotZero or point to a instance of mplsTunnelEntry indicating the MPLS TE tunnel to redirect matching packets to. If this object points to a conceptual row instance in a table consistent with mplsFTNActionType but this instance does not currently exist then no action will be taken on packets matching such an FTN entry till this instance comes into existence. If this object contains zeroDotZero then no action will be taken on packets matching such an FTN entry till it is populated with a valid pointer consistent with the value of mplsFTNActionType as explained above.
STO mplsFTNStorageType	1.3.6.1.2.1.10.166.8.1.3.1.18	StorageType	read-create	The storage type for this FTN entry. Conceptual rows having the value 'permanent' need not allow write- access to any columnar objects in the row.
TIM mplsFTNMapTableLastChanged	1.3.6.1.2.1.10.166.8.1.4	TimeStamp	read-only	Indicates the last time an entry was added, deleted or modified in mplsFTNMapTable. Management stations should consult this object to determine if the table requires their attention. This object is particularly useful for applications performing a retrieval on mplsFTNMapTable to ensure that the table is not modified during the retrieval operation.
mplsFTNMapTable	1.3.6.1.2.1.10.166.8.1.5		not-accessible	This table contains objects which provide the capability to apply or map FTN rules as defined by entries in mplsFTNTable to specific interfaces in the system. FTN rules are compared with incoming packets in the order in which they are applied on an interface. The indexing structure of mplsFTNMapTable is as follows. - mplsFTNMapIndex indicates the interface to which the rule is being applied. A value of 0 represents the application of the rule to all interfaces. - mplsFTNMapPrevIndex specifies the rule on the interface prior to the one being applied. A value of 0 specifies that the rule is being inserted at the head of the list of rules currently applied to the interface. - mplsFTNMapCurrIndex is the index in mplsFTNTable corresponding to the rule being applied. This indexing structure makes the entries in the table behave like items in a linked-list. The object mplsFTNMapPrevIndex in each conceptual row is a pointer to the previous entry that is applied to a particular interface. This allows a new entry to be 'inserted' at an arbitrary position in a list of entries currently applied to an interface. This object is self- adjusting, i.e., its value is automatically adjusted by the agent, if necessary, after an insertion or deletion operation. Using this linked-list structure, one can retrieve FTN entries in the order of application on a per-interface basis as follows: - To determine the first FTN entry on an interface with index ifIndex perform a GETNEXT retrieval operation on mplsFTNMapRowStatus.ifIndex.0.0; the returned object, if one exists, is (say) mplsFTNMapRowStatus.ifIndex.0.n (mplsFTNMapRowStatus is the first accessible columnar object in the conceptual row). Then the index of the first FTN entry applied on this interface is n. - To determine the FTN entry applied to an interface after the one indexed by n perform a GETNEXT retrieval operation on mplsFTNMapRowStatus.ifIndex.n.0. If such an entry exists the returned object would be of the form mplsFTNMapRowStatus.ifIndex.n.m. Then the index of the next FTN entry applied on this interface is m. - If the FTN entry indexed by n is the last entry applied to the interface with index ifIndex then the object returned would either be: 1.mplsFTNMapRowStatus.ifIndexNext.0.k, where ifIndexNext is the index of the next interface in ifTable to which an FTN entry has been applied, in which case k is the index of the first FTN entry applied to the interface with index ifIndexNext; or: 2.mplsFTNMapStorageType.firstIfIndex.0.p, if there are no more entries in mplsFTNMapTable, where firstIfIndex is the first entry in ifTable to which an FTN entry has been mapped. Use the above steps to retrieve all the applied FTN entries on a per-interface basis in application order. Note that the number of retrieval operations is the same as the number of applied FTN entries (i.e., the minimum number of GETNEXT operations needed using any indexing scheme). Agents MUST NOT allow the same FTN entry as specified by mplsFTNMapCurrIndex to be applied multiple times to the same interface. Agents MUST NOT allow the creation of rows in this table until the corresponding rows are created in the mplsFTNTable. If a row in mplsFTNTable is destroyed, the agent MUST destroy the corresponding entries (i.e., ones with a matching value of mplsFTNCurrIndex) in this table as well.
mplsFTNMapEntry	1.3.6.1.2.1.10.166.8.1.5.1		not-accessible	Each conceptual row represents the application of an FTN rule at a specific position in the list of FTN rules applied on an interface.
NUM mplsFTNMapIndex	1.3.6.1.2.1.10.166.8.1.5.1.1	InterfaceIndexOrZero	not-accessible	The interface index that this FTN entry is being applied to. A value of zero indicates an entry that is applied all interfaces. Entries mapped to an interface by specifying its (non- zero) interface index in mplsFTNMapIndex are applied ahead of entries with mplsFTNMapIndex equal to zero.
MPL mplsFTNMapPrevIndex	1.3.6.1.2.1.10.166.8.1.5.1.2	MplsFTNEntryIndexOrZero	not-accessible	The index of the previous FTN entry that was applied to this interface. The special value zero indicates that this should be the first FTN entry in the list.
MPL mplsFTNMapCurrIndex	1.3.6.1.2.1.10.166.8.1.5.1.3	MplsFTNEntryIndex	not-accessible	Index of the current FTN entry that is being applied to this interface.
ROW mplsFTNMapRowStatus	1.3.6.1.2.1.10.166.8.1.5.1.4	RowStatus	read-create	Used for controlling the creation and deletion of this row. All writable objects in this row may be modified at any time. If a conceptual row in mplsFTNMapTable points to a conceptual row in mplsFTNTable which is subsequently deleted, the corresponding conceptual row in mplsFTNMapTable MUST also be deleted by the agent.
STO mplsFTNMapStorageType	1.3.6.1.2.1.10.166.8.1.5.1.5	StorageType	read-create	The storage type for this entry. Conceptual rows having the value 'permanent' need not allow write- access to any columnar objects in this row.
mplsFTNPerfTable	1.3.6.1.2.1.10.166.8.1.6		not-accessible	This table contains performance statistics on FTN entries on a per-interface basis.
mplsFTNPerfEntry	1.3.6.1.2.1.10.166.8.1.6.1		not-accessible	Each entry contains performance information for the specified interface and an FTN entry mapped to this interface.
NUM mplsFTNPerfIndex	1.3.6.1.2.1.10.166.8.1.6.1.1	InterfaceIndexOrZero	not-accessible	The interface index of an interface that an FTN entry has been applied/mapped to. Each instance of this object corresponds to an instance of mplsFTNMapIndex.
MPL mplsFTNPerfCurrIndex	1.3.6.1.2.1.10.166.8.1.6.1.2	MplsFTNEntryIndex	not-accessible	Index of an FTN entry that has been applied/mapped to the specified interface. Each instance of this object corresponds to an instance of mplsFTNMapCurrIndex.
C64 mplsFTNPerfMatchedPacketsEx	1.3.6.1.2.1.10.166.8.1.6.1.3	Counter64	read-only	Number of packets that matched the specified FTN entry if it is applied/mapped to the specified interface. 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 mplsFTNDiscontinuityTime.
C64 mplsFTNPerfMatchedOctets	1.3.6.1.2.1.10.166.8.1.6.1.4	Counter64	read-only	Number of octets that matched the specified FTN entry if it is applied/mapped to the specified interface. 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 mplsFTNDiscontinuityTime.
TIM mplsFTNPerfDiscontinuityTime	1.3.6.1.2.1.10.166.8.1.6.1.5	TimeStamp	read-only	The value of sysUpTime on the most recent occasion at which any one or more of this entry's counters suffered a discontinuity. If no such discontinuities have occurred since the last re-initialization of the local management subsystem, then this object contains a zero value.
mplsFTNConformance	1.3.6.1.2.1.10.166.8.2
mplsFTNGroups	1.3.6.1.2.1.10.166.8.2.1
mplsFTNRuleGroup	1.3.6.1.2.1.10.166.8.2.1.1			Collection of objects that implement MPLS FTN rules.
mplsFTNMapGroup	1.3.6.1.2.1.10.166.8.2.1.2			Collection of objects that implement activation of MPLS FTN entries on interfaces.
mplsFTNPerfGroup	1.3.6.1.2.1.10.166.8.2.1.3			Collection of objects providing MPLS FTN performance information.
mplsFTNCompliances	1.3.6.1.2.1.10.166.8.2.2
mplsFTNModuleFullCompliance	1.3.6.1.2.1.10.166.8.2.2.1			Compliance statement for agents that provide full support for MPLS-FTN-STD-MIB.
mplsFTNModuleReadOnlyCompliance	1.3.6.1.2.1.10.166.8.2.2.2			Compliance requirement for implementations that only provide read-only support for MPLS-FTN-STD-MIB. Such devices can then be monitored but cannot be configured using this MIB module.

RFC description

MPLS FEC-to-NHLFE (FTN) mapping standard MIB for multiprotocol label switching performance management.

Start monitoring Vendor-neutral IETF standard (MPLS Label Edge Router, FEC-to-NHLFE mapping) 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 MPLS-FTN-STD-MIB