The EIGRP MIB feature provides full EIGRP support for GET requests and limited notification (also known as trap) support for stuck-in-active (SIA), neighbor down, and neighbor authentication failure events. This MIB is accessed through remote Simple Network Management Protocol (SNMP) software clients. The EIGRP IPv6 MIB feature enables IPv6 support for the EIGRP MIB.
Your software release may not support all the features documented in this module. For the latest caveats and feature information, see
Bug Search Tool and 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 module.
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
An EIGRP routing process must be enabled and an SNMP community string must be configured on at least one device for EIGRP MIB table objects to be visible via SNMP.
Support for EIGRP notifications (traps) is not activated until a trap destination is configured.
Restrictions for EIGRP MIB
EIGRP MIB support was not implemented for the EIGRP Prefix Limit Support feature.
The EIGRP MIB feature provides EIGRP MIB support in Cisco software for EIGRP routing processes that run over IPv4 and IPv6. The EIGRP MIB is accessed through remote SNMP software clients. MIB table objects are accessed as read-only through GETBULK, GETINFO, GETMANY, GETONE, and GETNEXT requests. Counters for MIB table objects are cleared when the EIGRP routing process is reset or when the routing table is refreshed when you enter the
cleariproute or
clearipeigrp command. Managed objects for all EIGRP routing processes are implemented as five table objects--EIGRP Interface, EIGRP Neighbor, EIGRP Topology, EIGRP Traffic Statistics, and EIGRP VPN--on a per-autonomous-system or per-VPN basis.
ºEIGRP Interface Table
The EIGRP Interface table contains information and statistics for all interfaces on which the Enhanced Interior Gateway Routing Protocol (EIGRP) has been configured. The objects in this table are populated on a per-interface basis. The table below describes EIGRP Interface table objects and the values populated for each object.
Table 1
EIGRP Interface Table Object Descriptions
EIGRP Interface Table Object
Description
cEigrpAcksSuppressed
Total number of individual acknowledgment packets that have been suppressed and combined in an already enqueued outbound reliable packet on the interface.
cEigrpAuthKeyChain
The name of the authentication key chain that is configured on the interface. The key chain is a reference to the set of secret keys that need to be accessed to determine the key string that needs to be used.
cEigrpAuthMode
The authentication mode that is configured for traffic that uses the interface. A value of 0 is displayed when no authentication is enabled. A value of 1 is displayed when message digest algorithm 5 (MD5) authentication is enabled.
cEigrpCRpkts
Total number conditional receive (CR) packets sent from the interface.
cEigrpHelloInterval
The configured time interval (in seconds) between hello packet transmissions on the interface.
cEigrpPacingReliable
The configured time interval (in milliseconds) between EIGRP packet transmissions on the interface when the reliable transport is used.
cEigrpPacingUnreliable
The configured time interval (in milliseconds) between EIGRP packet transmissions on the interface when the unreliable transport is used.
cEigrpPeerCount
Total number of neighbor adjacencies formed through the interface.
cEigrpPendingRoutes
Total number of routing updates that are queued for transmission on the interface.
cEigrpMcastExcept
Total number of EIGRP multicast exception transmissions that have occurred on the interface.
cEigrpMeanSrtt
The computed smooth round-trip time (SRTT) for packets that were transmitted to and received from all neighbors on the interface.
cEigrpMFlowTimer
The configured multicast flow control timer value (in milliseconds) for the interface.
cEigrpOOSrcvd
Total number of out-of-sequence packets received on the interface.
cEigrpRetranSent
Total number of packet retransmissions sent from the interface.
cEigrpRMcasts
Total number of reliable (acknowledgment required) multicast packets that were transmitted on the interface.
cEigrpRUcasts
Total number of reliable (acknowledgment required) unicast packets that were transmitted on the interface.
cEigrpUMcasts
Total number of unreliable (no acknowledgment required) multicast packets that were transmitted on the interface.
cEigrpUUcasts
Total number of unreliable (no acknowledgment required) unicast packets that were transmitted on the interface.
cEigrpXmitNextSerial
The serial number of the next packet that is queued for transmission on the interface.
cEigrpXmitReliableQ
Total number of packets waiting in the reliable transport transmission queue (acknowledgment required).
cEigrpXmitUnreliableQ
Total number of packets waiting in the unreliable transport transmission queue (no acknowledgment required).
EIGRP Neighbor Table
The EIGRP Neighbor table contains information about EIGRP neighbors with 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. The table below describes EIGRP Neighbor table objects and the values populated for each object.
Table 2
EIGRP Neighbor Table Object Descriptions
EIGRP Neighbor Table Object
Description
cEigrpHoldTime
The hold timer value for the adjacency with a neighbor. If this timer expires, the neighbor is declared down and removed from the neighbor table.
cEigrpLastSeq
The number of the last sequence of a packet transmitted to a neighbor. This table object value increases as the sequence number increases.
cEigrpPeerAddr
The source IP address of a neighbor that was used to establish an EIGRP adjacency with the local device. The source IP address can be an IPv4 or IPv6 address.
cEigrpPeerAddrType
The protocol type of the remote source IP address that was used by a neighbor to establish an EIGRP adjacency with the local device. The protocol type can be IPv4 or IPv6.
cEigrpPeerIfIndex
The index of the local interface through which a neighbor can be reached.
cEigrpPeerInterface
The name of the local interface through which a neighbor can be reached.
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.
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 is sent to a neighbor.
cEigrpRto
The computed retransmission timeout (RTO) for a neighbor. The value for this table object is computed as an aggregate average of the time required for packet delivery.
cEigrpSrtt
The computed smooth round-trip time (SRTT) for packets that are transmitted to and received from a neighbor.
cEigrpUpTime
The period for which the EIGRP adjacency to a neighbor has been in an up state. The time period is displayed in hours:minutes:seconds.
cEigrpVersion
EIGRP version information reported by a remote neighbor.
EIGRP Topology Table
The EIGRP Topology table contains information about Enhanced Interior Gateway Routing Protocol (EIGRP) routes that are received in updates and routes that are locally originated. EIGRP sends routing updates to and receives routing updates from adjacent routers with which adjacencies have been formed. The objects in this table are populated on a per-topology table entry (route) basis. The table below describes EIGRP Topology table objects and the values populated for each object.
Table 3
EIGRP Topology Table Object Descriptions
EIGRP Topology Table Object
Description
cEigrpActive
Status of 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 is in active state. A value of 2 is displayed when a route is in passive state (normal).
cEigrpDestSuccessors
Total number of 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 value increases each time a successor is added.
cEigrpDistance
The computed distance to the destination network entry from the local router.
cEigrpFdistance
Feasible (best) distance to a destination network. This value is used to calculate a feasible successor for a topology table entry.
cEigrpNextHopAddress
The next-hop IP address for a route in a topology table entry. The next hop can be an IPv4 or IPv6 address.
cEigrpNextHopAddressType
The protocol type of the next-hop IP address for the route in a topology table entry. The protocol type can be IPv4 or IPv6.
cEigrpNextHopInterface
The interface through which the next-hop IP address is reached to forward traffic to the destination.
cEigrpReportDistance
The computed distance to the destination network in the topology entry as reported by the originator of the route.
cEigrpRouteOriginAddr
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. The route origin address can be an IPv4 or IPv6 address.
cEigrpRouteOriginType
The protocol type of the IP address defined as the origin of the topology route entry. The protocol type can be IPv4 or IPv6.
cEigrpStuckInActive
Stuck-in-active (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 SIA state (that is, no reply has been received for queries about alternate paths). SIA queries are transmitted when a route is placed in this state.
EIGRP Traffic Statistics Table
The EIGRP Traffic Statistics table contains counters and statistics for specific types of Enhanced Interior Gateway Routing Protocol (EIGRP) packets that are sent and the related, collective information that is generated. Objects in this table are populated on a per-autonomous-system basis. Objects in this table are populated for adjacencies formed on interfaces that have IP addresses configured under EIGRP network statements. The table below describes EIGRP Traffic Statistics table objects and the values populated for each object.
Total number of acknowledgment packets that are received in response to the transmitted update packets. This table object value increases as packets are received.
cEigrpAcksSent
Total number of acknowledgment packets that are transmitted in response to the received update packets. This table object value increases as packets are transmitted.
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.
cEigrpAsRouterIdType
The type of IP address that is used as the router ID. The value for this table object is an IPv4 address.
cEigrpInputQDrops
Total number of packets that are dropped from the input queue because the input queue was full. This table object value increases each time a packet is dropped.
cEigrpInputQHighMark
The highest number of packets that have been in the input queue. This table object value increases only when the previous highest number is exceeded.
cEigrpHeadSerial
Internal sequencing number (serial) that is 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.
cEigrpHellosRcvd
Total number of received hello packets. This table object value increases as packets are received.
cEigrpHellosSent
Total number of hello packets transmitted. This table object value increases as packets are transmitted.
cEigrpNbrCount
Total number of live neighbors. This table object value increases or decreases as peering sessions are established or expired.
cEigrpNextSerial
Serial number that is applied to the next route in the sequence.
cEigrpQueriesSent
Total number of alternate route query packets that are transmitted. This table object value increases as packets are transmitted.
cEigrpQueriesRcvd
Total number of alternate route query packets that are received. This table object value increases as packets are received.
cEigrpRepliesSent
Total number of reply packets that are transmitted in response to the received query packets. This table object value increases as packets are transmitted.
cEigrpRepliesRcvd
Total number of reply packets that are received in response to transmitted query packets. This table object value increases as packets are received.
cEigrpSiaQueriesSent
Total number of query packets that are sent in response to a destination that is in a stuck-in-active (SIA) state for a down peer. This table object value increases each time an SIA query packet is sent.
cEigrpSiaQueriesRcvd
Total number of SIA query packets that are received from neighbors searching for an alternate path to a destination. This table object value increases each time an SIA query packet is received.
cEigrpTopoRoutes
Total number of EIGRP-derived routes in the topology table. This table object value increases if a route is added.
cEigrpUpdatesRcvd
Total number of routing update packets that are received. This table object value increases as packets are received.
cEigrpUpdatesSent
Total number of routing update packets that are transmitted. This table object value increases as packets are transmitted.
cEigrpXmitDummies
Total number of temporary entries in the topology table. Dummies are internal entries and not transmitted in routing updates.
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.
EIGRP VPN Table
The EIGRP VPN table contains information about VPNs that are configured to run an Enhanced Interior Gateway Routing Protocol (EiGRP) process. Devices index VPN routes by using the VPN name and the EIGRP autonomous system number. The table below describes the EIGRP VPN table object and the value populated for that object.
Table 5
EIGRP VPN Table Object Description
EIGRP VPN Table Object
Description
cEigrpVpnName
The VPN routing and forwarding (VRF) name. Only VRFs that are configured to run an EIGRP routing process are populated.
EIGRP Notifications
The EIGRP MIB provides limited notification (trap) support for stuck-in-active (SIA), neighbor down, and neighbor authentication failure events. Use the
snmp-serverenabletrapseigrp command to enable Enhanced Interior Gateway Routing Protocol (EIGRP) notifications or traps on a Cisco device. To activate support for trap events, you must configure a trap destination by using the
snmp-serverhost command and define a community string by using the
snmp-servercommunity command. EIGRP notifications are described in the table below.
Table 6
EIGRP Notifications
EIGRP Notifications
Description
cEigrpAuthFailureEvent
When EIGRP message digest algorithm 5 (MD5) authentication is enabled on any interface and neighbor adjacencies are formed, a notification is sent if any adjacency goes down because 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.
cEigrpNbrDownEvent
This notification is sent when a neighbor goes down for any reason, such as hold time expiry, neighbor shutdown, interface shutdown, SIA events, or authentication failure. If a neighbor is down because of an authentication failure, both cEigrpAuthFailureEvent and cEigrpNbrDownEvent notifications are sent.
cEigrpRouteStuckInActive
During the query phase for a new route to a destination network, the route is placed in active state (during which an alternate path is actively sought) and a query packet is broadcast to the network. If no replies are received for the query, SIA query packets are broadcast. If no replies are received for the SIA queries, the neighbor adjacency is dropped, the route is declared to be in an SIA state, and this notification is sent.
Perform this task to specify a Simple Network Management Protocol (SNMP) server host, configure an SNMP community access string, and enable EIGRP notifications.
The following example shows how to specify an SNMP server host, configure a community string, and enable support for EIGRP notifications:
Device(config)# snmp-server host 10.0.0.2 traps version 2c NETMANAGER eigrp
Device(config)# snmp-server community EIGRP1NET1A
Device(config)# snmp-server enable traps eigrp
Example: EIGRP MIB Verification
The following example shows how to verify the local SNMP configuration by using the
showrunning-config command:
Device# show running-config | include snmp
snmp-server community EIGRP1NET1A
snmp-server enable traps eigrp
snmp-server host 10.0.0.1 version 2c NETMANAGER eigrp
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.
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 IPv6 MIB
15.2(4)S
The EIGRP IPv6 MIB feature enables IPv6 support for the EIGRP MIB.
No commands were introduced or modified by this feature.
The EIGRP MIB feature provides full EIGRP support for GET requests and limited notification (trap) support for stuck-in-active (SIA), neighbor down, and neighbor authentication failure events. This MIB is accessed through remote Simple Network Management Protocol (SNMP) software clients.
The following commands were new or modified for this release:
snmp-serverenabletrapseigrp,
snmp-serverhost.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL:
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. (1110R)
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.