MPLS-FTN-MIB

All MIBs › MPLS-FTN-MIB

Organization: Multiprotocol Label Switching (MPLS) Working Group

Last Updated: 2003-04-30

Category: IETF Standards, MPLS

Description: Manages IETF MPLS FEC-to-NHLFE mapping table entries and label binding state.

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 MPLS-FTN-MIB?

MPLS-FTN-MIB is a vendor-neutral IETF standards-track MIB (per an RFC draft) for managing FEC-to-NHLFE (FTN) mappings, the classification rules that map incoming traffic Forwarding Equivalence Classes to Next Hop Label Forwarding Entries in an MPLS router. It exposes a configuration table of FTN entries describing address ranges, masks, and matching criteria used to assign packets to MPLS label-switched paths, along with row-creation/status controls and change-tracking objects. Its monitoring value is primarily configuration and forwarding-state visibility: administrators track how many FTN entries exist, their row status (active/notInService), and whether the table has changed recently, which reveals misconfigured or stale traffic classification rules rather than physical hardware health. It depends on and works alongside the core MPLS architecture MIBs (such as the MPLS-LSR-MIB and MPLS-TE-MIB) since FTN entries ultimately point traffic into label-switched paths defined there. It is deployed on MPLS provider-edge and label-switching routers that classify customer traffic into MPLS tunnels. Engineers implementing or auditing this functionality typically reference the MPLS-FTN-MIB RFC/standard documentation for the authoritative specification.

IPNetwork Monitor allows you to monitor SNMP objects defined in MPLS-FTN-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, not tied to a specific manufacturer
MPLS provider-edge / label-switching router

Monitoring Examples

An administrator polling mplsFTNTable/mplsFTNEntry can inspect mplsFTNSourceAddrMin/Max and mplsFTNDestAddrMin against mplsFTNMask and mplsFTNAddrType to verify a specific traffic-classification rule is correctly matching customer prefixes into an MPLS tunnel. Watching mplsFTNRowStatus reveals entries stuck in a non-active state, and mplsFTNTableLastChanged combined with mplsFTNIndexNext helps detect unexpected or unauthorized reconfiguration of FEC classification rules.

What Can Be Monitored

FEC-to-NHLFE mapping entries
traffic classification address ranges and masks
FTN entry row status
table last-changed timestamp
next available FTN index

Imported Objects

From DIFFSERV-DSCP-TC

Dscp

From IF-MIB

InterfaceIndexOrZero

From INET-ADDRESS-MIB

InetAddress
InetAddressType
InetPortNumber

From MPLS-TC-MIB

mplsMIB

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 an MPLS provider-edge and label-switching router 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
mplsFTNMIB	1.3.6.1.2.1.10.9999.5			Copyright (C) The Internet Society (2003). This version of this MIB module is part of RFC xxxx; see the RFC itself for full legal notices. 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.9999.5.0
mplsFTNObjects	1.3.6.1.2.1.10.9999.5.1
MPL mplsFTNIndexNext	1.3.6.1.2.1.10.9999.5.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 it 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.9999.5.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.
mplsFTNTable	1.3.6.1.2.1.10.9999.5.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 provides a 5-tuple matching and allows addresses, port ranges and the exp bits to be specified. The action pointer points at either an mplsXCEntry in MPLS-LSR MIB when the NHLFE entry is a non-TE LSP, or it points at an mplsTunnelEntry in the MPLS-TE MIB when the NHLFE is an originating TE tunnel.
mplsFTNEntry	1.3.6.1.2.1.10.9999.5.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.9999.5.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.9999.5.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.9999.5.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.9999.5.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.9999.5.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.9999.5.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.9999.5.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.9999.5.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.9999.5.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.9999.5.1.3.1.10	InetPortNumber	read-create	The lower end of the source port range.
INE mplsFTNSourcePortMax	1.3.6.1.2.1.10.9999.5.1.3.1.11	InetPortNumber	read-create	The higher end of the source port range
INE mplsFTNDestPortMin	1.3.6.1.2.1.10.9999.5.1.3.1.12	InetPortNumber	read-create	The lower end of the destination port range.
INE mplsFTNDestPortMax	1.3.6.1.2.1.10.9999.5.1.3.1.13	InetPortNumber	read-create	The higher end of the destination port range.
I32 mplsFTNProtocol	1.3.6.1.2.1.10.9999.5.1.3.1.14	Integer32	read-create	The contents of the IPv4 Protocol field or IPv6 next- header field.
DSC mplsFTNDscp	1.3.6.1.2.1.10.9999.5.1.3.1.15	Dscp	read-create	The contents of the DSCP field.
INT mplsFTNActionType	1.3.6.1.2.1.10.9999.5.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.9999.5.1.3.1.17	RowPointer	read-create	If mplsFTNActionType is redirectLsp(2), 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(3), 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.9999.5.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.9999.5.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.
mplsFTNMapTable	1.3.6.1.2.1.10.9999.5.1.5		not-accessible	This table contains objects for mapping previously defined entries in mplsFTNTable to interfaces. This table provides the capability to activate or map FTN entries defined in mplsFTNTable to specific interfaces in the system. FTN entries are compared with incoming packets in the order in which they are applied on an interface. For this reason, this table provides a mechanism to 'insert' an FTN entry between two existing FTN entries already applied on an interface. 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 mplsFTNMapIndex.ifIndex.0.0; the returned object, if one exists, is (say) mplsFTNMapIndex.ifIndex.0.n. Then the index of the first FTN entry applied on this interface is n. - To determine the FTN entry applied after the one indexed by n perform a GETNEXT retrieval operation on mplsFTNMapIndex.ifIndex.n.0; the returned object, if one exists, is (say) mplsFTNMapIndex.ifIndex.n.m. Then the index of the next FTN entry applied on this interface is m. 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).
mplsFTNMapEntry	1.3.6.1.2.1.10.9999.5.1.5.1		not-accessible	Each entry indicates the application of a particular entry as defined in mplsFTNTable on an interface. The order of application of FTN entries on an interface is the order in which they will be compared against incoming packets for a match. Each entry of this table is indexed by the interface index that the FTN entry is applied to, with the value 0 representing all interfaces, the index of the previous FTN entry applied on the interface and the index of the current FTN entry. This linked-list indexing style structure allows FTN entries to be inserted at arbitrary positions in the list. Agents MUST NOT allow the same FTN entries 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 the corresponding row in the FTN table is destroyed, the agent MUST destroy the corresponding entries in this table as well. Although it is strongly recommended that managers destroy rows in this table in such a way that keeps the remainder of the table consistent, agents MUST ultimately make sure that if an entry in this table is destroyed, that inconsistencies in the table are not allowed to occur. To this end, rows that are no longer appropriate should be taken out of service.
NUM mplsFTNMapIndex	1.3.6.1.2.1.10.9999.5.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.9999.5.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.9999.5.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.9999.5.1.5.1.5	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 instance of mplsFTNMapTable points to a conceptual row instance 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.9999.5.1.5.1.6	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.9999.5.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.9999.5.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.9999.5.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.9999.5.1.6.1.2	MplsFTNEntryIndex	not-accessible	Index of an FTN entry that has being 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.9999.5.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.9999.5.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.9999.5.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.9999.5.2
mplsFTNGroups	1.3.6.1.2.1.10.9999.5.2.1
mplsFTNRuleGroup	1.3.6.1.2.1.10.9999.5.2.1.1			Collection of objects that implement MPLS FTN rules.
mplsFTNMapGroup	1.3.6.1.2.1.10.9999.5.2.1.2			Collection of objects that implement activation of MPLS FTN entries on interfaces.
mplsFTNPerfGroup	1.3.6.1.2.1.10.9999.5.2.1.3			Collection of objects providing MPLS FTN performance information.
mplsFTNCompliances	1.3.6.1.2.1.10.9999.5.2.2
mplsFTNModuleFullCompliance	1.3.6.1.2.1.10.9999.5.2.2.1			Compliance statement for agents that provide full support for MPLS-FTN-MIB.
mplsFTNModuleReadOnlyCompliance	1.3.6.1.2.1.10.9999.5.2.2.2			Compliance requirement for implementations that only provide read-only support for MPLS-FTN-MIB. Such devices can then be monitored but cannot be configured using this MIB.

RFC description

Manages MPLS Forwarding Equivalence Class (FEC) to Next Hop (FTN) mappings; defined in RFC 3814 for MPLS traffic engineering configuration.

Start monitoring MPLS provider-edge and label-switching routers 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-MIB