FeedbackContents
- EIGRP MIB
- Finding Feature Information
- Prerequisites for EIGRP MIB
- Restrictions for EIGRP MIB
- Information About EIGRP MIB
- EIGRP MIB Overview
- ºEIGRP Interface Table
- EIGRP Neighbor Table
- EIGRP Topology Table
- EIGRP Traffic Statistics Table
- EIGRP VPN Table
- EIGRP Notifications
- How to Enable EIGRP MIB
- Enabling EIGRP MIB Notifications
- Configuration Examples for Enabling EIGRP MIB
- Example: EIGRP MIB Configuration
- Example: EIGRP MIB Verification
- Additional References
- Feature Information for EIGRP MIB
EIGRP MIB
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.
Finding Feature Information
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.
Restrictions for EIGRP MIB
EIGRP MIB support was not implemented for the EIGRP Prefix Limit Support feature.
Information About EIGRP MIB
- EIGRP MIB Overview
- ºEIGRP Interface Table
- EIGRP Neighbor Table
- EIGRP Topology Table
- EIGRP Traffic Statistics Table
- EIGRP VPN Table
- EIGRP Notifications
EIGRP MIB Overview
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 clear ip route or clear ip eigrp 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.
| Table 4 | EIGRP Traffic Statistics Table Object Descriptions |
|
EIGRP Traffic Statistics Table Object |
Description |
|---|---|
|
cEigrpAcksRcvd |
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.
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-server enable traps eigrp 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-server host command and define a community string by using the snmp-server community 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. |
How to Enable EIGRP MIB
Enabling EIGRP MIB Notifications
Perform this task to specify a Simple Network Management Protocol (SNMP) server host, configure an SNMP community access string, and enable EIGRP notifications.
DETAILED STEPS
Configuration Examples for Enabling EIGRP MIB
Example: EIGRP MIB Configuration
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
Additional References
Related Documents
Standards and RFCs
| Standard/RFC | Title |
|---|---|
|
RFC 1213 |
Management Information Base for Network Management of TCP/IP-based Internet: MIB-II |
MIBs
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 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. |
|
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 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-server enable traps eigrp, snmp-server host. |
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.