EIGRP MIB
The EIGRP MIB feature introduces an Enhanced Interior Gateway Routing Protocol (EIGRP) MIB in Cisco IOS software. This MIB is accessed through remote Simple Network Management Support (SNMP) software clients. This MIB provides full EIGRP support for GET requests and limited notification (TRAP) support for stuck-in-active (SIA) and neighbor authentication failure events.
Finding Feature Information
Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the Feature Information Table at the end of this document.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
Prerequisites for EIGRP MIB
- EIGRP MIB table objects are not visible via SNMP until an EIGRP routing process is enabled and an SNMP community string is configured on at least one router.
- Support for EIGRP notifications (TRAP) is not activated until a trap destination is configured.
Restrictions for EIGRP MIB
- EIGRP MIB support has not been implemented for the EIGRP Prefix Limit Support feature.
- EIGRP MIB support is available for IPv4 only.
Information About EIGRP MIB
- EIGRP MIB Overview
- EIGRP VPN Table
- EIGRP Traffic Statistics Table
- EIGRP Topology Table
- EIGRP Neighbor Table
- EIGRP Interface Table
- EIGRP Notifications
EIGRP MIB Overview
The EIGRP MIB feature introduces EIGRP MIB support in Cisco IOS software. EIGRP routing processes that run over IPv4 are supported. The EIGRP MIB is accessed through remote SNMP software clients. MIB table objects are accessed as read-only through GET, GETINFO, GETMANY, GETNEXT, GETBULK, and SET requests. Counters for MIB table objects are cleared when the EIGRP routing process is reset or when the routing table is refreshed by entering the clear ip route or clear ip eigrpcommands,or by entering clear eigrp address-familycommands. Managed objects for all EIGRP routing processes are implemented as five table objects on a per-autonomous-system or per-Virtual-Private-Network (VPN) basis.
EIGRP VPN Table
The EIGRP VPN Table contains information regarding which VPNs are configured to run an EIGRP routing process. VPN routes are indexed by the VPN name and the EIGRP autonomous system number. The EIGRP VPN table object and the value populated for that object are described in the table below.
| Table 1 | VPN Table Object Description |
| Object |
Description |
|---|---|
| cEigrpVpnName |
The VPN routing and forwarding (VRF) name. Only VRFs that are configured to run an EIGRP routing process are populated. |
EIGRP Traffic Statistics Table
The EIGRP Traffic Statistics Table contains counters and statistics for the specific types of EIGRP packets that are sent and the related collective information that is generated. The objects in this table are populated on a per-autonomous-system basis. Objects in this table are populated for adjacencies formed on all interfaces with an IP address that is configured under an EIGRP network statement. Traffic statistics table objects and the values populated for each object are described in the table below.
| Table 2 | EIGRP Traffic Statistics Options |
| Object |
Description |
|---|---|
| cEigrpNbrCount |
Total number of live neighbors. This table object is incremented or decremented as peering sessions are established or expired. |
| cEigrpHellosSent |
Total number of transmitted hello packets. This table object is incremented as packets are transmitted. |
| cEigrpHellosRcvd |
Total number of received hello packets. This table object is incremented as packets are received. |
| cEigrpUpdatesSent |
Total number of transmitted routing update packets. This table object is incremented as packets are transmitted. |
| cEigrpUpdatesRcvd |
Total number of received routing update packets. This table object is incremented as packets are received. |
| cEigrpQueriesSent |
Total number of alternate route query packets transmitted. This table object is incremented as packets are transmitted. |
| cEigrpQueriesRcvd |
Total number of alternate route query packets received. This table object is incremented as packets are received. |
| cEigrpRepliesSent |
Total number of reply packets that are transmitted in response to received query packets. This table object is incremented as packets are transmitted. |
| cEigrpRepliesRcvd |
Total number of reply packets that are received in response to transmitted query packets. This table object is incremented as packets are transmitted. |
| cEigrpAcksSent |
Total number of acknowledgment packets that are transmitted in response to received update packets. This table object is incremented as packets are transmitted. |
| cEigrpAcksRcvd |
Total number of acknowledgment packets that are received in response to transmitted update packets. This table object is incremented as packets are received. |
| cEigrpInputQHighMark |
The highest number of packets that have been in the input queue. This table object is incremented only when the previous highest number is exceeded. |
| cEigrpInputQDrops |
Total number of packets dropped from the input queue because the input queue was full. This tabled object is incremented each time a packet is dropped. |
| cEigrpSiaQueriesSent |
Total number of query packets sent in response to a destination that is in a SIA state for a down peer. This table object is incremented each time an SIA query packet is sent. |
| cEigrpSiaQueriesRcvd |
Total number of SIA query packets received from neighbors searching for an alternate path to a destination. This table object is incremented each time an SIA query packet is received. |
| cEigrpAsRouterIdType |
The type of IP address that is used as the router ID. The value for this table object can be an IPv4 address. |
| cEigrpAsRouterId |
The configured or automatically selected router ID in IP address format. This table object is updated if the router ID is manually reconfigured or if the IP address that was automatically selected is removed. |
| cEigrpTopoRoutes |
Total number of EIGRP-derived routes in the topology table. This table object is incremented if a route is added or removed. |
| cEigrpHeadSerial |
Internal sequencing number (serial) applied to EIGRP topology table routes. Routes are sequenced starting with 1. A value of 0 is displayed when there are no routes in the topology table. The "Head" serial number is applied to the first route in the sequence. |
| cEigrpNextSerial |
The serial number applied to the next route in the sequence. |
| cEigrpXmitPendReplies |
Total number of replies expected in response to locally transmitted query packets. This table object contains a value of 0 until a route is placed in an active state. |
| cEigrpXmitDummies |
Total number of temporary entries in the topology table. Dummies are internal entries and not transmitted in routing updates. |
EIGRP Topology Table
The EIGRP Topology Table contains information regarding EIGRP routes received in updates and routes that are locally originated. EIGRP sends routing updates to and receives routing updates from adjacent routers to which peering relationships (adjacencies) have been formed. The objects in this table are populated on a per-topology-table-entry (route) basis. Topology table objects and the values populated for each object are described in the table below.
| Table 3 | Topology Table Object Descriptions |
| Object |
Description |
|---|---|
| cEigrpActive |
Displays the active status for routes in the topology table. The value for this table object is displayed on a per-route basis. A value of 1 is displayed when a route has gone into an active state. A value of 2 is displayed when a route is in a passive state (normal). |
| cEigrpStuckInActive |
Displays the SIA status of a route. The value for this table object is displayed on a per-route basis. A value of 1 is displayed when a route is in an SIA state (no reply has been received for queries for alternate paths). SIA queries are transmitted when a route is placed in this state. |
| cEigrpDestSuccessors |
Total number successors (a route that is the next hop to a destination network) for a topology table entry. The topology table will contain a successor for each path to a given destination. This table object is incremented each time a successor is added or removed. |
| cEigrpFdistance |
The feasible (best) distance to a destination network. This value is used to calculate the feasible successor for a topology table entry. |
| cEigrpRouteOriginAddr |
The protocol type of an IP address defined in the origin of the topology table entry. |
| cEigrpRouteOriginType |
Displays the IP address of the router that originated the route in the topology table entry. This table is populated only if the topology table entry was not locally originated. |
| cEigrpNextHopAddress Type |
Displays the protocol type for the next-hop IP address for the route in a topology table entry. |
| cEigrpNextHopAddress |
The next-hop IP address for a route in a topology table entry. |
| cEigrpNextHopInterface |
The interface through which the next-hop IP address is reached to send traffic to the destination. |
| cEigrpDistance |
The computed distance to the destination network entry from the local router. |
| cEigrpReportDistance |
The computed distance to the destination network in the topology entry as reported by the originator of the route. |
EIGRP Neighbor Table
The EIGRP Neighbor Table contains information about EIGRP neighbors to which adjacencies have been established. EIGRP uses a "Hello" protocol to form neighbor relationships with directly connected EIGRP neighbors. The objects in this table are populated on a per-neighbor basis. Neighbor table objects and the values populated for each object are described in the table below.
| Table 4 | Neighbor Table Object Descriptions |
| Object |
Description |
|---|---|
| cEigrpPeerAddrType |
The protocol type of the remote source IP address used by the neighbor to establish the EIGRP adjacency with the local router. |
| cEigrpPeerAddr |
The source IP address of the neighbor that was used to establish EIGRP adjacency with the local router. |
| cEigrpPeerInterface |
The name of the local interface, through which the neighbor can be reached. This table object is populated on a per-neighbor basis. |
| cEigrpPeerIfIndex |
The index of the local interface, through which this neighbor can be reached. |
| cEigrpHoldTime |
The hold timer value for the adjacency with the neighbor. If this timer expires, the neighbor is declared down and removed from the neighbor table. |
| cEigrpUpTime |
The length of time for which the EIGRP adjacency to the neighbor has been in an up state. The time period is displayed in hours:minutes:seconds. |
| cEigrpSrtt |
The computed smooth round trip time (SRTT) for packets transmitted to and received from the neighbor. |
| cEigrpRto |
The computed retransmission timeout (RTO) for the neighbor. The value for this table object is computed as an aggregate average of the time required for packet delivery. This table object is populated on a per-neighbor basis. |
| cEigrpPktsEnqueued |
Total number of EIGRP packets (all types) currently queued for transmission to a neighbor. This table object is populated on a per-neighbor basis. |
| cEigrpLastSeq |
The number of the last sequence number of a packet transmitted to a neighbor. This table object is incremented as the sequence number increases. |
| cEigrpVersion |
The EIGRP version information reported by the remote neighbor. This table object is populated on a per-neighbor basis. |
| cEigrpRetrans |
Cumulative number of packets retransmitted to the neighbor, while the neighbor is in an up state. This table object is populated on a per-neighbor basis. |
| cEigrpRetries |
Total number of times an unacknowledged packet has been sent to a neighbor. This table object is populated on a per-neighbor basis. |
EIGRP Interface Table
The EIGRP Interface Table contains information and statistics for each interface that EIGRP has been configured to run over. The objects in this table are populated on a per-interface basis. Interface table objects and the values populated for each object are described in the table below.
| Table 5 | EIGRP Interface Table Object Descriptions |
| Object |
Description |
|---|---|
| cEigrpPeerCount |
Total number of neighbor adjacencies formed through this interface. |
| cEigrpXmitReliableQ |
Total number of packets waiting in the reliable transport transmission queue (acknowledgment is required) to be sent to a neighbor. |
| cEigrpXmitUnreliableQ |
Total number of packets waiting in the unreliable transmission queue (no acknowledgment required). |
| cEigrpMeanSrtt |
The computed SRTT for packets transmitted to and received from all neighbors on the interface. |
| cEigrpPacingReliable |
The configured time interval (in milliseconds) between EIGRP packet transmissions on this interface when the reliable transport is used. |
| cEigrpPacingUnreliable |
The configured time interval (in milliseconds) between EIGRP packet transmissions on this interface when the unreliable transport is used. |
| cEigrpMFlowTimer |
The configured multicast flow control timer value (in milliseconds) for this interface. |
| cEigrpPendingRoutes |
Total number of routing updates queued for transmission on this interface. |
| cEigrpHelloInterval |
The configured time interval (in seconds) between Hello packet transmissions for this interface. |
| cEigrpXmitNextSerial |
The serial number of the next packet that is queued for transmission on this interface. |
| cEigrpUMcasts |
Total number of unreliable (no acknowledgment required) multicast packets transmitted on this interface. |
| cEigrpRMcasts |
Total number of reliable (acknowledgment required) multicast packets transmitted on this interface. |
| cEigrpUUcasts |
Total number of unreliable (no acknowledgment required) unicast packets transmitted on this interface. |
| cEigrpRUcasts |
Total number of reliable (acknowledgment required) unicast packets transmitted on this interface. |
| cEigrpMcastExcept |
The total number of EIGRP multicast exception transmissions that have occurred on this interface. |
| cEigrpCRpkts |
Total number conditional-receive packets sent on this interface. |
| cEigrpAcksSuppressed |
Total number of individual acknowledgment packets that have been suppressed and combined in an already enqueued outbound reliable packet on this interface. |
| cEigrpRetranSent |
Total number of packet retransmissions sent on this interface. |
| cEigrpOOSrvcd |
Total number of out-of-sequence packets received on this interface. |
| cEigrpAuthMode |
The authentication mode configured for traffic that uses this interface. The value of 0 is displayed when no authentication is enabled. The value of 1 is displayed when message digest algorithm 5 (MD5) authentication is enabled. |
| cEigrpAuthKeyChain |
The name of the authentication key chain configured on this interface. The key chain is a reference to which set of secret keys is to be accessed to determine which key string to use. The key-chain name is not the key string (password). |
EIGRP Notifications
The EIGRP MIB provides limited notification (TRAP) support for SIA and neighbor authentication failure events. The snmp-server enable traps eigrp command is used to enable EIGRP notifications on a Cisco router. Support for TRAP events is not activated until a trap destination is configured with the snmp-server host command and a community string is defined with the snmp-server community command. EIGRP notifications are described in the table below.
| Table 6 | EIGRP Notifications |
| EIGRP Traps (Notifications) |
Description |
|---|---|
| cEigrpAuthFailureEvent |
When EIGRP MD5 authentication is enabled on any interface and neighbor adjacencies are formed, a notification is sent if any adjacency goes down as a result of an authentication failure. This notification will be sent once per down event. This notification includes the source IP address of the neighbor from which the authentication failure occurred. |
| cEigrpRouteStuckInActive |
During the query phase for a new route to a destination network, the route is placed in the active state (an alternate path is actively being sought) and a query packet is broadcast to the network. If no replies are received to the query, an SIA query packets are broadcast. If a reply is not received for the SIA queries, the neighbor adjacency is dropped, the route is declared SIA, and this notification is sent. |
How to Enable EIGRP MIB
Enabling EIGRP MIB
Perform this task to enable an EIGRP MIB. This task specifies an SNMP server host, configures an SNMP community access string, and enables EIGRP notifications.
DETAILED STEPS
| Command or Action | Purpose | |
|---|---|---|
|
|
Example: Router> enable |
Enables privileged EXEC mode.
|
|
|
Example: Router# configure terminal |
Enters global configuration mode. |
|
|
Example: Router(config)# snmp-server host 10.0.0.1 traps version 2c NETMANAGER eigrp |
Specifies the destination host or address for SNMP notifications. |
|
|
Example: Router(config)# snmp-server community EIGRP1NET1A |
Configures a community access string to permit SNMP access to the local router by the remote SNMP software client.
|
|
|
Example: Router(config)# snmp-server enable traps eigrp |
Enables SNMP support for EIGRP notifications.
|
|
|
Example: Router(config)# end |
Exits global configuration mode and returns to privileged EXEC mode. |
Configuration Examples for Enabling EIGRP MIB
Example EIGRP MIB Configuration
In the following example, an SNMP server host is specified, a community string is configured, and support for EIGRP notifications is enabled:
Router(config)# snmp-server host 10.0.0.1 traps version 2c NETMANAGER eigrp Router(config)# snmp-server community EIGRP1NET1A Router(config)# snmp-server enable traps eigrp
Example EIGRP MIB Verification
In the following example, the local SNMP configuration is verified by entering the show running-configcommand:
Router# show running-config | include snmp
snmp-server community EIGRP1NET1A
snmp-server enable traps eigrp
snmp-server host 10.0.0.1 version 2c NETMANAGER
Additional References
Related Documents
| Related Topic |
Document Title |
|---|---|
| Cisco IOS commands |
|
| EIGRP commands |
Cisco IOS IP Routing: EIGRP Command Reference |
| Basic EIGRP configuration tasks |
Configuring EIGRP module |
| Troubleshooting SIA events |
|
| SNMP commands |
Cisco IOS Network Management Command Reference |
| SNMP configuration tasks |
Configuring SNMP Support module of the Cisco IOS Network Management Configuration Guide |
Standards
| Standard |
Title |
|---|---|
| No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature. |
-- |
MIBs
| MIB |
MIBs Link |
|---|---|
| CISCO-EIGRP-MIB.my |
To locate and download MIBs for selected platforms, Cisco software releases, and feature sets, use Cisco MIB Locator found at the following URL: |
RFCs
| RFC |
Title |
|---|---|
| RFC 1213 |
Management Information Base for Network Management of TCP/IP-based Internets: MIB-II |
Technical Assistance
| Description |
Link |
|---|---|
| The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password. |
Feature Information for EIGRP MIB
The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
| Table 7 | Feature Information for EIGRP MIB |
| Feature Name |
Releases |
Feature Information |
|---|---|---|
| EIGRP MIB |
12.2(33)SRB 12.2(33)SXI4 12.2(33)XNE 12.3(14)T 15.0(1)M |
The EIGRP MIB feature introduces an EIGRP MIB in Cisco IOS software. This MIB is accessed through remote Simple Network Management Support (SNMP) software clients. This MIB provides full EIGRP support for GET requests and limited notification (TRAP) support for stuck-in-active (SIA) and neighbor authentication failure events. The following commands were new or modified for this release: snmp-server enable traps eigrp, snmp-server host. |
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.
Feedback