OPENBSD-CARP-MIB

MIB Reference — IPNetwork Monitor

All MIBsOPENBSD-CARP-MIB

Organization: OpenBSD

Last Updated: 2012-01-31

Category: Operating Systems

Description:

Monitors CARP (Common Address Redundancy Protocol) group state and failover events on OpenBSD hosts.

Imported Objects

From OPENBSD-BASE-MIB

openBSDMODULE-IDENTITY

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter64
Integer32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
enterprises

From SNMPv2-TC

TruthValue

What Is OPENBSD-CARP-MIB?

OPENBSD-CARP-MIB is a vendor-neutral MIB (originating from the OpenBSD project) for monitoring CARP (Common Address Redundancy Protocol) interfaces, which provide IP-address failover redundancy similar to VRRP. It exposes global CARP settings (carpAllow, carpPreempt, carpLog) alongside a per-interface table (carpIfTable/carpIfEntry) describing each CARP interface's virtual host ID, underlying device, advertisement base interval, and advertisement skew, plus a carpStats subtree. Its monitoring focus is software/protocol status: whether CARP is enabled, whether preemption is active, and the per-interface configuration and state that determines failover behavior, useful for confirming which host currently holds the master role for a virtual IP. It is a standalone protocol MIB not formally layered on other IETF MIBs, though it parallels VRRP-MIB concepts. It is deployed on OpenBSD-based firewalls and routers using CARP for high-availability failover. Engineers can download the OPENBSD-CARP-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in OPENBSD-CARP-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.

What Can Be Monitored

  • CARP interface virtual host ID (VHID)
  • CARP advertisement base interval and skew
  • CARP preemption and logging settings
  • per-interface CARP device binding
  • CARP statistics

Supported Devices

  • vendor-neutral, standards-based MIB, not tied to a specific manufacturer
  • OpenBSD-based firewalls and routers using CARP

Monitoring Examples

An administrator would poll carpIfTable/carpIfEntry, keyed by carpIfIndex, to read carpIfVhid, carpIfDev, carpIfAdvbase, and carpIfAdvskew for each CARP interface and confirm the advertisement timing is configured as expected across a redundant pair. Checking carpIfDescr alongside carpStats would reveal whether a host has unexpectedly transitioned roles, which combined with carpPreempt and carpLog settings would explain an unplanned failover event. A mismatch in carpIfAdvskew between the two peers could explain flapping between master and backup states.

OIDs
OID symbolicOID numericTypeAccessDescription
carpMIBObjects1.3.6.1.4.1.30155.6The MIB module for gathering information about Common Address Redundancy Protocol (CARP) interfaces.
carpSysctl1.3.6.1.4.1.30155.6.1
T/F carpAllow1.3.6.1.4.1.30155.6.1.1TruthValueread-onlyIndicates whether the node will respond to CARP packets.
T/F carpPreempt1.3.6.1.4.1.30155.6.1.2TruthValueread-onlyIndicates whether preemption is enabled.
T/F carpLog1.3.6.1.4.1.30155.6.1.3TruthValueread-onlyIndicates whether logging of invalid CARP packets is enabled.
carpIf1.3.6.1.4.1.30155.6.2
I32 carpIfNumber1.3.6.1.4.1.30155.6.2.1Integer32read-onlyThe number of CARP interfaces present on this system.
carpIfTable1.3.6.1.4.1.30155.6.2.2not-accessibleA list of individual CARP interfaces. The number of entries is given by the value of carpIfNumber.
carpIfEntry1.3.6.1.4.1.30155.6.2.2.1not-accessibleAn entry containing management information applicable to a particular CARP interface.
I32 carpIfIndex1.3.6.1.4.1.30155.6.2.2.1.1Integer32read-onlyA unique value, greater than zero, for each CARP interface.
OCT carpIfDescr1.3.6.1.4.1.30155.6.2.2.1.2OCTET STRINGread-onlyThe name of the CARP interface.
I32 carpIfVhid1.3.6.1.4.1.30155.6.2.2.1.3Integer32read-onlyThe Virtual HostID of the CARP interface.
OCT carpIfDev1.3.6.1.4.1.30155.6.2.2.1.4OCTET STRINGread-onlyThe parent interface that the CARP interface is bound to.
I32 carpIfAdvbase1.3.6.1.4.1.30155.6.2.2.1.5Integer32read-onlyThe advbase value of the CARP interface.
I32 carpIfAdvskew1.3.6.1.4.1.30155.6.2.2.1.6Integer32read-onlyThe advskew value of the CARP interface.
INT carpIfState1.3.6.1.4.1.30155.6.2.2.1.7INTEGERread-onlyIndicates the operational state of the CARP interface.
carpStats1.3.6.1.4.1.30155.6.3
C64 carpIpPktsRecv1.3.6.1.4.1.30155.6.3.1Counter64read-onlyNumber of IPv4 CARP packets received on all interfaces.
C64 carpIp6PktsRecv1.3.6.1.4.1.30155.6.3.2Counter64read-onlyNumber of IPv6 CARP packets received on all interfaces.
C64 carpPktDiscardsForBadInterface1.3.6.1.4.1.30155.6.3.3Counter64read-onlyNumber of packets discarded due to being received on a non-CARP interface.
C64 carpPktDiscardsForWrongTtl1.3.6.1.4.1.30155.6.3.4Counter64read-onlyNumber of packets discarded due to having a TTL less than 255.
C64 carpPktShorterThanHeader1.3.6.1.4.1.30155.6.3.5Counter64read-onlyNumber of packets received on any interface that is shorter than the size of the CARP packet header.
C64 carpPktDiscardsForBadChecksum1.3.6.1.4.1.30155.6.3.6Counter64read-onlyNumber of packets discarded due to bad checksum.
C64 carpPktDiscardsForBadVersion1.3.6.1.4.1.30155.6.3.7Counter64read-onlyNumber of packets discarded due to bad version in the packet header.
C64 carpPktDiscardsForTooShort1.3.6.1.4.1.30155.6.3.8Counter64read-onlyNumber of packets discarded due to being too short.
C64 carpPktDiscardsForBadAuth1.3.6.1.4.1.30155.6.3.9Counter64read-onlyNumber of packets discarded because they failed the HMAC authentication check.
C64 carpPktDiscardsForBadVhid1.3.6.1.4.1.30155.6.3.10Counter64read-onlyNumber of packets discarded due to incorrect VHID in the packet header.
C64 carpPktDiscardsForBadAddressList1.3.6.1.4.1.30155.6.3.11Counter64read-onlyNumber of packets discarded due to bad addresses in the CARP packet.
C64 carpIpPktsSent1.3.6.1.4.1.30155.6.3.12Counter64read-onlyNumber of IPv4 CARP packets sent on all interfaces.
C64 carpIp6PktsSent1.3.6.1.4.1.30155.6.3.13Counter64read-onlyNumber of IPv6 CARP packets sent on all interfaces.
C64 carpNoMemory1.3.6.1.4.1.30155.6.3.14Counter64read-onlyNumber of CARP advertisements that failed because memory could not be allocated.
C64 carpTransitionsToMaster1.3.6.1.4.1.30155.6.3.15Counter64read-onlyNumber of times the host has transitioned to MASTER state for any CARP group.

RFC description

Monitors Common Address Redundancy Protocol (CARP) interfaces and failover status on OpenBSD systems.

Start monitoring OpenBSD-based firewalls and routers using CARP (address redundancy protocol) 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 OPENBSD-CARP-MIB