CISCO-VPC-MIB

All MIBs › CISCO-VPC-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2013-05-09

Category: Vendor: Cisco Devices

Description: Manages Cisco Virtual Port Channel (vPC) configurations and operational status on Nexus data center switches.

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 CISCO-VPC-MIB?

This MIB manages and monitors Cisco Virtual Port Channel (vPC), a feature allowing two Nexus switches to appear as a single logical switch for port-channel purposes, ensuring loop-free redundancy without Spanning Tree blocking. It exposes configuration for the vPC peer-keepalive mechanism, including destination/source addresses, UDP port, timers, and ToS, along with operational status and notification objects for vPC domain health. Its monitoring value is directly about software/protocol status critical to network redundancy, as administrators track peer-keepalive timeout and hold-timeout settings and status to detect an at-risk or already-failed vPC peer link, which if undetected can lead to a dual-active split-brain scenario. It is Cisco Nexus-specific and works in concert with port-channel (LACP) and spanning-tree monitoring for full topology health. It is deployed in Cisco Nexus data center switch pairs configured for vPC-based redundant uplinks, where CISCO-VPC-MIB SNMP monitoring of peer-keepalive state helps operators catch an at-risk vPC domain before a split-brain event occurs.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-VPC-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

Cisco Nexus data center switches

Monitoring Examples

An administrator would poll cVpcPeerKeepAliveConfigTable / cVpcPeerKeepAliveConfigEntry, checking cVpcPeerKeepAliveInterval, cVpcPeerKeepAliveTimeout, and cVpcPeerKeepAliveHoldTimeout for a given cVpcPeerKeepAliveConfigDomainID to confirm the keepalive link parameters. If keepalive messages between cVpcPeerKeepAliveSourceAddr and cVpcPeerKeepAliveDestAddr stop being acknowledged within the timeout, that's an early indicator of an impending vPC peer-link failure that could trigger a dual-active event. ciscoVpcMIBNotifs traps would alert the NMS in real time when such a state change occurs.

What Can Be Monitored

vPC peer-keepalive interval, timeout, and hold-timeout
peer-keepalive source/destination address configuration
peer-keepalive UDP port and ToS
vPC domain operational notifications

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From HCNUM-TC

CounterBasedGauge64

From IF-MIB

InterfaceIndex
InterfaceIndexOrZero

From INET-ADDRESS-MIB

InetAddress
InetAddressType
InetPortNumber

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

DateAndTime
MacAddress
TruthValue

How to Use in IPNetwork Monitor

Example using cVpcStatsPeerKeepAliveMsgsSent OID:

Select a Cisco Nexus data center switch (Virtual Port Channel) 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 cVpcStatsPeerKeepAliveMsgsSent 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. This object indicates the number of peer-keepalive messages sent to peer. 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 Counter32-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
ciscoVpcMIB	1.3.6.1.4.1.9.9.807			This MIB module defines MIB objects which provide management information for configuring and monitoring of Virtual Port Channel(VPC) on Cisco devices. The following terms are used throughout this MIB: ISSU: In Service Software Upgrade ToS: Type of Service UDP: User Datagram Protocol VPC: Virtual Port Channel VRF: Virtual Routing and Forwarding
ciscoVpcMIBNotifs	1.3.6.1.4.1.9.9.807.0
ciscoVpcMIBObjects	1.3.6.1.4.1.9.9.807.1
cVpcPeerKeepAlive	1.3.6.1.4.1.9.9.807.1.1
cVpcPeerKeepAliveConfigTable	1.3.6.1.4.1.9.9.807.1.1.1		not-accessible	The table contains the VPC peer-keepalive link and message configuration information in the managed device.
cVpcPeerKeepAliveConfigEntry	1.3.6.1.4.1.9.9.807.1.1.1.1		not-accessible	An entry containing VPC peer-keepalive link and message configuration information.
U32 cVpcPeerKeepAliveConfigDomainID	1.3.6.1.4.1.9.9.807.1.1.1.1.1	Unsigned32	not-accessible	An arbitrary value to uniquely identify the VPC management domain on the local system. Value zero indicates no VPC management domain has been configured for this device.
IPt cVpcPeerKeepAliveDestAddrType	1.3.6.1.4.1.9.9.807.1.1.1.1.2	InetAddressType	read-write	This object specifies type of Internet address of destination address for peer device.
IP cVpcPeerKeepAliveDestAddr	1.3.6.1.4.1.9.9.807.1.1.1.1.3	InetAddress	read-write	This object specifies destination ip address of peer device. The type of this address is determined by the cVpcPeerKeepAliveDestAddrType object.
IPt cVpcPeerKeepAliveSourceAddrType	1.3.6.1.4.1.9.9.807.1.1.1.1.4	InetAddressType	read-write	This object specifies type of Internet address of source address used for peer-keepalive hello messages.
IP cVpcPeerKeepAliveSourceAddr	1.3.6.1.4.1.9.9.807.1.1.1.1.5	InetAddress	read-write	This object specifies source address used in this peer-keepalive hello messages. The type of this address is determined by the cVpcPeerKeepAliveSourceAddrType object.
INE cVpcPeerKeepAliveUdpPort	1.3.6.1.4.1.9.9.807.1.1.1.1.6	InetPortNumber	read-write	This object specifies UDP Port number used for peer-keepalive hello messages.
U32 cVpcPeerKeepAliveInterval	1.3.6.1.4.1.9.9.807.1.1.1.1.7	Unsigned32	read-write	This object specifies the interval of peer-keepalive hello messages.
U32 cVpcPeerKeepAliveTimeout	1.3.6.1.4.1.9.9.807.1.1.1.1.8	Unsigned32	read-write	This object specifies the timeout of peer-keepalive hello messages.
U32 cVpcPeerKeepAliveHoldTimeout	1.3.6.1.4.1.9.9.807.1.1.1.1.9	Unsigned32	read-write	This object specifies hold timeout to ignore stale peer alive messages.
U32 cVpcPeerKeepAliveTos	1.3.6.1.4.1.9.9.807.1.1.1.1.10	Unsigned32	read-write	This object specifies the ToS value used for peer-keepalive hello messages.
U32 cVpcPeerKeepAlivePrecedence	1.3.6.1.4.1.9.9.807.1.1.1.1.11	Unsigned32	read-write	This object specifies the Precedence value used for peer-keepalive hello messages.
U32 cVpcPeerKeepAliveTosByte	1.3.6.1.4.1.9.9.807.1.1.1.1.12	Unsigned32	read-write	This object specifies the ToS-Byte value used for peer-keepalive messages. Only low eight-bit byte of this double word is used. Bit 0 is reserved. Bits 1 to 5 represent the value of cVpcPeerKeepAliveTos. Bits 6 to 8 come into cVpcPeerKeepAlivePrecedence. ToS-Byte indicates the value of the whole byte including ToS, Precedence and reserved bit 0.
STR cVpcPeerKeepAliveVrfName	1.3.6.1.4.1.9.9.807.1.1.1.1.13	SnmpAdminString	read-write	This object specifies the VRF name to be used for peer-keepalive messages routing.
cVpcPeerKeepAliveTable	1.3.6.1.4.1.9.9.807.1.1.2		not-accessible	The table contains the VPC peer-keepalive link status information in the managed device.
cVpcPeerKeepAliveEntry	1.3.6.1.4.1.9.9.807.1.1.2.1		not-accessible	An entry containing VPC peer-keepalive link status information.
U32 cVpcPeerKeepAliveDomainID	1.3.6.1.4.1.9.9.807.1.1.2.1.1	Unsigned32	not-accessible	An arbitrary value to uniquely identify the VPC management domain on the local system. Value zero indicates there is no VPC management domain being configured for this device.
INT cVpcPeerKeepAliveStatus	1.3.6.1.4.1.9.9.807.1.1.2.1.2	INTEGER	read-only	This object indicates VPC peer keep-alive status. disabled(1) : Peer-keepalive is disabled. alive(2) : Peer-keepalive is alive. peerUnreachable(3) : Peer is unreachable through Peer-keepalive link. aliveButDomainIdDismatch(4) : Peer-keepalive is alive, but VPC domain doesn't match with each other. suspendedAsISSU(5) : Peer-keepalive is suspended during ISSU. suspendedAsDestIPUnreachable(6) : Peer-keepalive is suspended since destination ip is unreachable. suspendedAsVRFUnusable(7) : Peer-keepalive is suspended since the current VRF is unusable. misconfigured(8) : Misconfigure Peer-keepalive feature.
NUM cVpcPeerKeepAliveTime	1.3.6.1.4.1.9.9.807.1.1.2.1.3	CounterBasedGauge64	read-only	This object indicates the time (in msec) since the peer became alive. It will hold value 0 if peer-keepalive never becomes alive.
INT cVpcPeerKeepAliveMsgSendStatus	1.3.6.1.4.1.9.9.807.1.1.2.1.4	INTEGER	read-only	This object indicates VPC peer keep-alive message sending status.
DAT cVpcPeerKeepAliveMsgLastSendTime	1.3.6.1.4.1.9.9.807.1.1.2.1.5	DateAndTime	read-only	This object indicates date and time of VPC peer keep-alive message last send. This object contains value 0x0000010100000000, if peer-keepalive message has never been sent.
NUM cVpcPeerKeepAliveMsgSendInterface	1.3.6.1.4.1.9.9.807.1.1.2.1.6	InterfaceIndexOrZero	read-only	This object indicates the ifIndex of interface of VPC peer keep-alive message sent on.
INT cVpcPeerKeepAliveMsgRcvrStatus	1.3.6.1.4.1.9.9.807.1.1.2.1.7	INTEGER	read-only	This object indicates VPC peer keep-alive message receiving status.
DAT cVpcPeerKeepAliveMsgLastReceiveTime	1.3.6.1.4.1.9.9.807.1.1.2.1.8	DateAndTime	read-only	This object indicates date and time of VPC peer keep-alive message last received. This object contains value 0x0000010100000000, if peer-keepalive message has never been received.
NUM cVpcPeerKeepAliveMsgReceiveInterface	1.3.6.1.4.1.9.9.807.1.1.2.1.9	InterfaceIndexOrZero	read-only	This object indicates the ifIndex of interface of VPC peer keep-alive message last received.
cVpcRole	1.3.6.1.4.1.9.9.807.1.2
cVpcRoleTable	1.3.6.1.4.1.9.9.807.1.2.1		not-accessible	The table contains the VPC role status information in the managed device.
cVpcRoleEntry	1.3.6.1.4.1.9.9.807.1.2.1.1		not-accessible	An entry containing VPC role information.
U32 cVpcRoleDomainID	1.3.6.1.4.1.9.9.807.1.2.1.1.1	Unsigned32	not-accessible	An arbitrary value to uniquely identify the VPC management domain on the local system. Value zero indicates there is no VPC management domain being configured for this device.
INT cVpcRoleStatus	1.3.6.1.4.1.9.9.807.1.2.1.1.2	INTEGER	read-only	This object indicates the VPC role status of the peer device. primarySecondary(1) : primary, and operational secondary. primary(2) : primary, and operational primary. secondaryPrimary(3) : secondary, and operational primary. secondary(4) : secondary, and operational secondary. noneEstabished(5) : none peer device.
T/F cVpcDualActiveDetectionStatus	1.3.6.1.4.1.9.9.807.1.2.1.1.3	TruthValue	read-only	This object indicates the dual active detection status of peer device. true(1) : indicate that Dual Active is detected. false(2) : indicate that Dual Active is not detected.
MAC cVpcSystemAdminMacAddress	1.3.6.1.4.1.9.9.807.1.2.1.1.4	MacAddress	read-write	This object specifies VPC system MAC address.
MAC cVpcSystemOperMacAddress	1.3.6.1.4.1.9.9.807.1.2.1.1.5	MacAddress	read-only	This object indicates VPC system operational MAC address.
MAC cVpcLocalOperMacAddress	1.3.6.1.4.1.9.9.807.1.2.1.1.6	MacAddress	read-only	This object indicates VPC local system operational MAC address.
U32 cVpcSystemAdminPriority	1.3.6.1.4.1.9.9.807.1.2.1.1.7	Unsigned32	read-write	This object specifies VPC system priority.
U32 cVpcSystemOperPriority	1.3.6.1.4.1.9.9.807.1.2.1.1.8	Unsigned32	read-only	This object indicates VPC system operational priority.
U32 cVpcLocalRoleAdminPriority	1.3.6.1.4.1.9.9.807.1.2.1.1.9	Unsigned32	read-write	This object specifies VPC local role priority.
U32 cVpcLocalRoleOperPriority	1.3.6.1.4.1.9.9.807.1.2.1.1.10	Unsigned32	read-only	This object indicates VPC local role operational priority.
cVpcStatistics	1.3.6.1.4.1.9.9.807.1.3
cVpcStatsPeerKeepAliveTable	1.3.6.1.4.1.9.9.807.1.3.1		not-accessible	The table contains the statistics of VPC peer-keepalive messages in the managed device.
cVpcStatsPeerKeepAliveEntry	1.3.6.1.4.1.9.9.807.1.3.1.1		not-accessible	An entry containing statistics of the VPC peer-keepalive messages.
U32 cVpcStatsPeerKeepAliveDomainID	1.3.6.1.4.1.9.9.807.1.3.1.1.1	Unsigned32	not-accessible	An arbitrary value to uniquely identify the VPC management domain on the local system. Value zero indicates there is no VPC management domain being configured for this device.
C32 cVpcStatsPeerKeepAliveMsgsSentEx	1.3.6.1.4.1.9.9.807.1.3.1.1.2	Counter32	read-only	This object indicates the number of peer-keepalive messages sent to peer.
C32 cVpcStatsPeerKeepAliveMsgsRcved	1.3.6.1.4.1.9.9.807.1.3.1.1.3	Counter32	read-only	This object indicates the number of peer-keepalive messages received from peer.
U32 cVpcStatsPeerKeepAliveAvgInterval	1.3.6.1.4.1.9.9.807.1.3.1.1.4	Unsigned32	read-only	This object indicates the average interval for the peer-keepalive messages received from peer.
C32 cVpcStatsPeerStatusChangeCount	1.3.6.1.4.1.9.9.807.1.3.1.1.5	Counter32	read-only	This object indicates the number of times that the peer status gets changed.
cVpcStatus	1.3.6.1.4.1.9.9.807.1.4
cVpcStatusPeerLinkTable	1.3.6.1.4.1.9.9.807.1.4.1		not-accessible	The table contains the list of VPC peer-links in the managed device.
cVpcStatusPeerLinkEntry	1.3.6.1.4.1.9.9.807.1.4.1.1		not-accessible	An entry containing VPC peer-link management information applicable to a particular VPC domain.
U32 cVpcStatusPeerLinkDomainID	1.3.6.1.4.1.9.9.807.1.4.1.1.1	Unsigned32	not-accessible	An arbitrary value to uniquely identify the VPC management domain.
NUM cVpcStatusPeerLinkIfIndex	1.3.6.1.4.1.9.9.807.1.4.1.1.2	InterfaceIndex	read-only	The value of the ifIndex corresponding to the peer link of this VPC domain.
cVpcStatusHostLinkTable	1.3.6.1.4.1.9.9.807.1.4.2		not-accessible	The table contains the VPC host-link summary information in the managed device.
cVpcStatusHostLinkEntry	1.3.6.1.4.1.9.9.807.1.4.2.1		not-accessible	An entry containing VPC host-link summary information.
U32 cVpcStatusHostLinkDomainID	1.3.6.1.4.1.9.9.807.1.4.2.1.1	Unsigned32	not-accessible	An arbitrary value to uniquely identify the VPC management domain.
U32 cVpcStatusHostLinkVpcID	1.3.6.1.4.1.9.9.807.1.4.2.1.2	Unsigned32	not-accessible	An arbitrary value to uniquely identify a VPC link between the host and the switch for a given VPC management domain.
NUM cVpcStatusHostLinkIfIndex	1.3.6.1.4.1.9.9.807.1.4.2.1.3	InterfaceIndexOrZero	read-only	The value of the ifIndex corresponding to a host-link interface.
INT cVpcStatusHostLinkStatus	1.3.6.1.4.1.9.9.807.1.4.2.1.4	INTEGER	read-only	This object indicates the current status of VPC host-link. down(1) : Host link is down. downStar(2) : Local host link is down, forwarding via vPC peer-link. up(3) : Host link is up.
INT cVpcStatusHostLinkConsistencyStatus	1.3.6.1.4.1.9.9.807.1.4.2.1.5	INTEGER	read-only	This object indicates the status of configuration consistency check of this VPC host link.
STR cVpcStatusHostLinkConsistencyDetail	1.3.6.1.4.1.9.9.807.1.4.2.1.6	SnmpAdminString	read-only	This object indicates the reason of consistency check status change detail.
ciscoVpcMIBConformance	1.3.6.1.4.1.9.9.807.2
ciscoVpcMIBCompliances	1.3.6.1.4.1.9.9.807.2.1
ciscoVpcMIBCompliance	1.3.6.1.4.1.9.9.807.2.1.1			The compliance statement for CISCO-VPC-MIB.
ciscoVpcMIBGroups	1.3.6.1.4.1.9.9.807.2.2
cVpcPeerKeepAliveConfigInfoGroup	1.3.6.1.4.1.9.9.807.2.2.1			A collection of objects providing peer-keepalive link and messages configuration information.
cVpcPeerKeepAliveStatusInfoGroup	1.3.6.1.4.1.9.9.807.2.2.2			A collection of objects providing peer-keepalive status information.
cVpcMIBRoleGroup	1.3.6.1.4.1.9.9.807.2.2.3			A collection of objects providing peer-keepalive role information.
cVpcMIBStatisticsGroup	1.3.6.1.4.1.9.9.807.2.2.4			A collection of objects providing peer-keepalive statistics information.
cVpcMIBPeerLinkStatusGroup	1.3.6.1.4.1.9.9.807.2.2.5			A collection of objects providing peer-link status information
cVpcMIBHostLinkStatusGroup	1.3.6.1.4.1.9.9.807.2.2.6			A collection of objects providing host-link VPC status information.

RFC description

Manages Virtual Port Channel (VPC) configuration, peer connectivity, and statistics on Cisco switching devices for redundancy and load balancing.

Start monitoring Cisco Nexus data center switches (Virtual Port Channel) 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 CISCO-VPC-MIB