CISCO-IETF-DHCP-SERVER-EXT-MIB

All MIBs › CISCO-IETF-DHCP-SERVER-EXT-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2007-03-15

Category: Cisco Devices, IP and Core Protocols

Description: Extends the IETF DHCP server MIB with Cisco-specific objects for enhanced DHCP pool and lease management on Cisco IOS platforms.

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-IETF-DHCP-SERVER-EXT-MIB?

CISCO-IETF-DHCP-SERVER-EXT-MIB extends the Cisco IETF DHCP Server MIB with additional objects for managing DHCP server operation on Cisco IOS platforms, including server start/reset timekeeping, lease-query statistics, and DHCP failover protocol (FO) message counters. It belongs to Cisco's IP address-management MIB family and exposes operational data covering server uptime-style timers, statistics reset tracking, and detailed failover peer communication counts (binding updates, acks, naks, pool requests, polls). This is a software service-status MIB: it lets administrators confirm the DHCP server process is running normally and that its failover partner relationship is healthy, since stalled cDhcpv4FOBindingUpdsRcvd or cDhcpv4FOPollsRcvd counts would indicate a failover peer communication problem. It explicitly extends the IETF-oriented Cisco DHCP Server MIB and, by association, concepts from RFC-based DHCP MIB work. It is deployed on Cisco IOS routers/switches configured as DHCP servers, particularly in failover pair configurations, as defined in the CISCO-IETF-DHCP-SERVER-EXT-MIB MIB.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-IETF-DHCP-SERVER-EXT-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 IOS router/switch configured as a DHCP server

Monitoring Examples

An administrator would check cDhcpv4SrvStartTime and cDhcpv4SrvResetTime to confirm the DHCP server process hasn't unexpectedly restarted, and cDhcpv4StatisticsResetTime to know the baseline for other counters. Polling cDhcpv4LeaseQueries alongside cDhcpv4FOBindingUpdsRcvd and cDhcpv4FOBindingAcksRcvd reveals whether lease information is being synchronized correctly with a failover peer. A flat cDhcpv4FOPacketsRcvd count while the DHCP service is otherwise active would suggest the failover link to the partner server has gone down.

What Can Be Monitored

DHCP server start/reset time
lease query count
failover packets/binding updates/acks/naks received
failover pool requests and polls received
statistics reset timestamp

Imported Objects

From CISCO-IETF-DHCP-SERVER-MIB

cDhcpv4ServerClientPhysicalAddress	OBJECT-TYPE
cDhcpv4ServerSubnetEntry	OBJECT-TYPE
cDhcpv4ServerSubnetFreeAddrHighThreshold	OBJECT-TYPE
cDhcpv4ServerSubnetFreeAddrLowThreshold	OBJECT-TYPE
cDhcpv4ServerSubnetFreeAddresses	OBJECT-TYPE

From CISCO-SMI

ciscoExperiment

OBJECT-IDENTITY

From IF-MIB

ifIndex	OBJECT-TYPE
ifName	OBJECT-TYPE

From INET-ADDRESS-MIB

InetAddressIPv4

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Gauge32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

TimeInterval
TimeStamp
TruthValue

How to Use in IPNetwork Monitor

Example using cDhcpv4LeaseQueries OID:

Select a Cisco IOS router/switch configured as a DHCP server 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 cDhcpv4LeaseQueries into the Find box to locate it in the OID tree, then select it and click OK. The total number of DHCPLEASEQUERY packets received. 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 (in packets), 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
cDhcpv4CfgObjects	1.3.6.1.4.1.9.10.122.1.6
cDhcpv4CfgObjectsGroup	1.3.6.1.4.1.9.10.122.2.2.6			Objects providing configuration information for a DHCPv4 server.
NUM cDhcpv4ConfigIntervalSample	1.3.6.1.4.1.9.10.122.1.6.1	TimeInterval	read-write	Configures the sample time for the various interval counters.
cDhcpv4CountersIntervalGroup	1.3.6.1.4.1.9.10.122.2.2.3			A collection of extension objects providing interval counter values for a DHCPv4 server.
cDhcpv4ExtCounters	1.3.6.1.4.1.9.10.122.1.2
cDhcpv4ExtCountersGroup	1.3.6.1.4.1.9.10.122.2.2.2			A collection of extension objects providing counter values for a DHCPv4 server.
cDhcpv4FailoverCounters	1.3.6.1.4.1.9.10.122.1.4
cDhcpv4FailoverIntervalCounters	1.3.6.1.4.1.9.10.122.1.5
C32 cDhcpv4FOBindingAcksRcvd	1.3.6.1.4.1.9.10.122.1.4.3	Counter32	read-only	The total number of failover DHCPBNDACK packets received.
C32 cDhcpv4FOBindingAcksSent	1.3.6.1.4.1.9.10.122.1.4.11	Counter32	read-only	The total number of DHCPBNDACKS packets sent.
C32 cDhcpv4FOBindingNaksRcvd	1.3.6.1.4.1.9.10.122.1.4.4	Counter32	read-only	The total number of failover DHCPBNDNAK packets received.
C32 cDhcpv4FOBindingNaksSent	1.3.6.1.4.1.9.10.122.1.4.12	Counter32	read-only	The total number of DHCPBNDNAK packets sent.
C32 cDhcpv4FOBindingUpdatesSent	1.3.6.1.4.1.9.10.122.1.4.10	Counter32	read-only	The total number of DHCPBNDUPD packets sent.
C32 cDhcpv4FOBindingUpdsRcvd	1.3.6.1.4.1.9.10.122.1.4.2	Counter32	read-only	The total total number of failover DHCPBNDUPD packets received.
cDhcpv4FOCountersGroup	1.3.6.1.4.1.9.10.122.2.2.4			A collection of objects providing failover counter values for a DHCPv4 server.
cDhcpv4FOCountersIntervalGroup	1.3.6.1.4.1.9.10.122.2.2.5			A collection of objects providing failover interval counter values for a DHCPv4 server.
U32 cDhcpv4FOIntBindingAcksRcvd	1.3.6.1.4.1.9.10.122.1.5.3	Unsigned32	read-only	The number of failover DHCPBNDACK packets received during the reporting interval.
U32 cDhcpv4FOIntBindingAcksSent	1.3.6.1.4.1.9.10.122.1.5.11	Unsigned32	read-only	The number of DHCPBNDACKS packets sent during the reporting interval.
U32 cDhcpv4FOIntBindingNaksRcvd	1.3.6.1.4.1.9.10.122.1.5.4	Unsigned32	read-only	The number of failover DHCPBNDNAK packets received during reporting interval.
U32 cDhcpv4FOIntBindingNaksSent	1.3.6.1.4.1.9.10.122.1.5.12	Unsigned32	read-only	The number of DHCPBNDNAK packets sent during the reporting interval.
U32 cDhcpv4FOIntBindingUpdsRcvd	1.3.6.1.4.1.9.10.122.1.5.2	Unsigned32	read-only	The number of failover DHCPBNDUPD packets received during the reporting interval.
U32 cDhcpv4FOIntBindingUpdsSent	1.3.6.1.4.1.9.10.122.1.5.10	Unsigned32	read-only	The number of DHCPBNDUPD packets sent during the reporting interval.
NUM cDhcpv4FOIntDeltaTime	1.3.6.1.4.1.9.10.122.1.5.19	TimeInterval	read-only	The interval in seconds over which the server last calculated the sample interval statistics. This is the configured reporting interval and the statistics are reset since the last cDhcpv4IntEndTime.
TIM cDhcpv4FOIntEndTime	1.3.6.1.4.1.9.10.122.1.5.18	TimeStamp	read-only	The time when the server last calculated the interval statistics.
U32 cDhcpv4FOIntPacketsDropped	1.3.6.1.4.1.9.10.122.1.5.17	Unsigned32	read-only	The number of failover packets dropped during the reporting interval.
U32 cDhcpv4FOIntPacketsRcvd	1.3.6.1.4.1.9.10.122.1.5.1	Unsigned32	read-only	The number of failover packets received during the reporting interval.
U32 cDhcpv4FOIntPacketsSent	1.3.6.1.4.1.9.10.122.1.5.9	Unsigned32	read-only	The number of failover packets sent during the reporting interval.
U32 cDhcpv4FOIntPollsRcvd	1.3.6.1.4.1.9.10.122.1.5.6	Unsigned32	read-only	The number of failover DHCPPOLL packets received during the reporting interval.
U32 cDhcpv4FOIntPollsSent	1.3.6.1.4.1.9.10.122.1.5.14	Unsigned32	read-only	The number of DHCPPOLL packets sent during the reporting interval.
U32 cDhcpv4FOIntPoolRequestsRcvd	1.3.6.1.4.1.9.10.122.1.5.5	Unsigned32	read-only	The number of failover DHCPPOOLREQ packets received during the reporting interval.
U32 cDhcpv4FOIntPoolResponsesSent	1.3.6.1.4.1.9.10.122.1.5.13	Unsigned32	read-only	The number of DHCPPOOLRESP packets sent during the reporting interval.
U32 cDhcpv4FOIntUpdateDoneRcvd	1.3.6.1.4.1.9.10.122.1.5.8	Unsigned32	read-only	The number of failover DHCPUPDATEDONE packets received during the reporting interval.
U32 cDhcpv4FOIntUpdateDoneSent	1.3.6.1.4.1.9.10.122.1.5.16	Unsigned32	read-only	The number of DHCPUPDATEDONE packets sent during the reporting interval.
U32 cDhcpv4FOIntUpdateReqsRcvd	1.3.6.1.4.1.9.10.122.1.5.7	Unsigned32	read-only	The number of failover DHCPUPDATEREQ packets received during the reporting interval.
U32 cDhcpv4FOIntUpdateReqsSent	1.3.6.1.4.1.9.10.122.1.5.15	Unsigned32	read-only	The number of DHCPUPDATEREQ packets sent during the reporting interval.
C32 cDhcpv4FOPacketsDropped	1.3.6.1.4.1.9.10.122.1.4.17	Counter32	read-only	The total number of failover packets dropped during reporting interval.
C32 cDhcpv4FOPacketsRcvd	1.3.6.1.4.1.9.10.122.1.4.1	Counter32	read-only	The total total number of failover packets received.
C32 cDhcpv4FOPacketsSent	1.3.6.1.4.1.9.10.122.1.4.9	Counter32	read-only	The total number of failover packets sent.
C32 cDhcpv4FOPollsRcvd	1.3.6.1.4.1.9.10.122.1.4.6	Counter32	read-only	The total number of failover DHCPPOLL packets received.
C32 cDhcpv4FOPollsSent	1.3.6.1.4.1.9.10.122.1.4.14	Counter32	read-only	The total number of DHCPPOLL packets sent during reporting interval.
C32 cDhcpv4FOPoolRequestsRcvd	1.3.6.1.4.1.9.10.122.1.4.5	Counter32	read-only	The total number of failover DHCPPOOLREQ packets received.
C32 cDhcpv4FOPoolResponsesSent	1.3.6.1.4.1.9.10.122.1.4.13	Counter32	read-only	The total number of DHCPPOOLRESP packets sent.
C32 cDhcpv4FOUpdateDoneRcvd	1.3.6.1.4.1.9.10.122.1.4.8	Counter32	read-only	The total number of failover DHCPUPDATEDONE packets received.
C32 cDhcpv4FOUpdateDoneSent	1.3.6.1.4.1.9.10.122.1.4.16	Counter32	read-only	The total number of DHCPUPDATEDONE packets sent during reporting interval.
C32 cDhcpv4FOUpdateRequestsRcvd	1.3.6.1.4.1.9.10.122.1.4.7	Counter32	read-only	The total number of failover DHCPUPDATEREQ packets received.
C32 cDhcpv4FOUpdateRequestsSent	1.3.6.1.4.1.9.10.122.1.4.15	Counter32	read-only	The total number of DHCPUPDATEREQ packets sent during reporting interval.
U32 cDhcpv4IntAcks	1.3.6.1.4.1.9.10.122.1.3.5	Unsigned32	read-only	The number of DHCPACK (option 53 with value 5) packets sent during the reporting interval.
U32 cDhcpv4IntDeclines	1.3.6.1.4.1.9.10.122.1.3.4	Unsigned32	read-only	The number of DHCPDECLINE (option 53 with value 4) packets received during the reporting interval.
NUM cDhcpv4IntDeltaTime	1.3.6.1.4.1.9.10.122.1.3.13	TimeInterval	read-only	The interval in seconds over which the server last calculated the sample interval statistics. This is the configured reporting interval and the statistics are reset since the last cDhcpv4IntEndTime.
U32 cDhcpv4IntDiscovers	1.3.6.1.4.1.9.10.122.1.3.1	Unsigned32	read-only	The number of DHCPDISCOVER (option 53 with value 1) packets received during the reporting interval.
TIM cDhcpv4IntEndTime	1.3.6.1.4.1.9.10.122.1.3.12	TimeStamp	read-only	The time when the server last calculated the sample statistics.
cDhcpv4IntervalCounters	1.3.6.1.4.1.9.10.122.1.3
U32 cDhcpv4IntInforms	1.3.6.1.4.1.9.10.122.1.3.8	Unsigned32	read-only	The number of DHCPINFORM (option 53 with value 8) packets received during the reporting interval.
U32 cDhcpv4IntLeaseQueries	1.3.6.1.4.1.9.10.122.1.3.9	Unsigned32	read-only	The total number of DHCPLEASEQUERY packets received during the reporting interval.
U32 cDhcpv4IntNaks	1.3.6.1.4.1.9.10.122.1.3.6	Unsigned32	read-only	The number of DHCPNACK (option 53 with value 6) packets sent during the reporting interval.
U32 cDhcpv4IntOffers	1.3.6.1.4.1.9.10.122.1.3.2	Unsigned32	read-only	The number of DHCPOFFER (option 53 with value 2) packets sent during the reporting interval.
U32 cDhcpv4IntReleases	1.3.6.1.4.1.9.10.122.1.3.7	Unsigned32	read-only	The number of DHCPRELEASE (option 53 with value 7) packets received during the reporting interval.
G32 cDhcpv4IntReqBuffersInUse	1.3.6.1.4.1.9.10.122.1.3.10	Gauge32	read-only	The number of request buffers in use during the reporting interval.
U32 cDhcpv4IntRequests	1.3.6.1.4.1.9.10.122.1.3.3	Unsigned32	read-only	The number of DHCPREQUEST (option 53 with value 3) packets received during the reporting interval.
G32 cDhcpv4IntRespBuffersInUse	1.3.6.1.4.1.9.10.122.1.3.11	Gauge32	read-only	The number of response buffers in use at the end of the reporting interval.
C32 cDhcpv4LeaseQueriesEx	1.3.6.1.4.1.9.10.122.1.2.1	Counter32	read-only	The total number of DHCPLEASEQUERY packets received.
ADR cDhcpv4ServerDefaultRouterAddress	1.3.6.1.4.1.9.10.122.1.6.2.1.1	InetAddressIPv4	read-write	The default router IPv4 address in this subnet.
U32 cDhcpv4ServerIfLeaseLimit	1.3.6.1.4.1.9.10.122.1.6.7.1.1	Unsigned32	read-write	The number of Dynamic Host Configuration Protocol (DHCP) clients allowed for an interface. The value of this object is equal to the value of the 'cDhcpv4ServerIfLeaseLimitDefault' for the interface that does not have the interface lease limit configuration. The value of the 'cDhcpv4ServerIfLeaseLimit' object reflects the lease limit on that interface (whether it's configured with a value specifically for that interface or if the value of 'cDhcpv4ServerIfLeaseLimitDefault' applies). When this lease limit is reached or exceeded, the cDhcpv4ServerIfLeaseLimitExceeded notification will be generated if cDhcpv4ServerIfLeaseLimitEnable is enabled.
U32 cDhcpv4ServerIfLeaseLimitDefault	1.3.6.1.4.1.9.10.122.1.6.6	Unsigned32	read-write	The default number of Dynamic Host Configuration Protocol (DHCP) clients allowed for an interface. Refer to 'cDhcpv4ServerIfLeaseLimit'.
T/F cDhcpv4ServerIfLeaseLimitEnable	1.3.6.1.4.1.9.10.122.1.6.3	TruthValue	read-write	This object specifies if the DHCP module should generate 'cDhcpv4ServerIfLeaseLimitExceeded' notifications. If value of this object is 'true', then the notification is generated when the number of leases offered to DHCP clients behind an interface is reached based on per limit lease configuration command. If it is 'false', the notification is not generated.
NTF cDhcpv4ServerIfLeaseLimitExceeded	1.3.6.1.4.1.9.10.122.0.2.0.1			This notification indicates when a client has attempted to obtain a lease and the lease was not granted because the number of leases granted to clients on the receiving interface is equal to cDhcpv4ServerIfLeaseLimit.
ADR cDhcpv4ServerSubnetEndAddress	1.3.6.1.4.1.9.10.122.1.6.2.1.3	InetAddressIPv4	read-only	The IPv4 address of the last address in the subnet. The value of cDhcpv4ServerSubnetEndAddress MUST be greater than or equal to the value of cDhcpv4ServerSubnetStartAddress.
NTF cDhcpv4ServerSubnetFreeAddressHigh	1.3.6.1.4.1.9.10.122.0.2.0.3			This notification indicates that the number of available IPv4 addresses for a particular subnet has risen above the corresponding value of cDhcpv4ServerSubnetFreeAddrHighThreshold for that shared network.
T/F cDhcpv4ServerSubnetFreeAddressHighEnable	1.3.6.1.4.1.9.10.122.1.6.5	TruthValue	read-write	This object specifies if the DHCP module should generate 'cDhcpv4ServerSubnetFreeAddressHigh' notifications. If value of this object is 'true', then the notification is generated when the number of available IPv4 addresses for a particular subnet has fallen below the value of cDhcpv4ServerSubnetFreeAddrHighThreshold for that subnet. If it is 'false', the notification is not generated.
NTF cDhcpv4ServerSubnetFreeAddressLow	1.3.6.1.4.1.9.10.122.0.2.0.2			This notification indicates that the number of available IPv4 addresses for a particular subnet has fallen below the corresponding value of cDhcpv4ServerSubnetFreeAddrLowThreshold for that shared network.
T/F cDhcpv4ServerSubnetFreeAddressLowEnable	1.3.6.1.4.1.9.10.122.1.6.4	TruthValue	read-write	This object specifies if the DHCP module should generate 'cDhcpv4ServerSubnetFreeAddressLow' notifications. If value of this object is 'true', then the notification is generated when the number of available IPv4 addresses for a particular subnet has fallen below the value of cDhcpv4ServerSubnetFreeAddrLowThreshold for that subnet. If it is 'false', the notification is not generated.
ADR cDhcpv4ServerSubnetStartAddress	1.3.6.1.4.1.9.10.122.1.6.2.1.2	InetAddressIPv4	read-only	The IPv4 address of the first address in the subnet. The value of cDhcpv4ServerSubnetStartAddress MUST be less than or equal to the value of cDhcpv4ServerSubnetEndAddress.
cDhcpv4SrvExtCompliance	1.3.6.1.4.1.9.10.122.2.1.1			This group describes the requirements for conformance to the DHCP Server extension MIB. A DHCPv4 server implementation is only required to support IPv4 addresses.
cDhcpv4SrvExtComplianceRev1	1.3.6.1.4.1.9.10.122.2.1.2			This group describes the requirements for conformance to the DHCP Server extension MIB. A DHCPv4 server implementation is only required to support IPv4 addresses.
cDhcpv4SrvExtCompliances	1.3.6.1.4.1.9.10.122.2.1
cDhcpv4SrvExtGroups	1.3.6.1.4.1.9.10.122.2.2
cDhcpv4SrvExtNotify	1.3.6.1.4.1.9.10.122.0.2.0
cDhcpv4SrvExtNotifyGroup	1.3.6.1.4.1.9.10.122.2.2.7			Notifications belonging to the cDhcpv4SrvExtNotify group.
cDhcpv4SrvExtNotifyPrefix	1.3.6.1.4.1.9.10.122.0.2
cDhcpv4SrvExtSubnetEntry	1.3.6.1.4.1.9.10.122.1.6.2.1		not-accessible	Entry contains additional subnet information not defined in cDhcpv4ServerSubnetEntry.
cDhcpv4SrvExtSubnetTable	1.3.6.1.4.1.9.10.122.1.6.2		not-accessible	This table augments the cDhcpv4ServerSubnetTable.
cDhcpv4SrvExtSystem	1.3.6.1.4.1.9.10.122.1.1
cDhcpv4SrvExtSystemObjects	1.3.6.1.4.1.9.10.122.2.2.1			A collection of objects providing overall system information for a DHCPv4 server.
cDhcpv4SrvIfCfgEntry	1.3.6.1.4.1.9.10.122.1.6.7.1		not-accessible	Entry consists of the DHCP configuration data applied to the interface.
cDhcpv4SrvIfCfgTable	1.3.6.1.4.1.9.10.122.1.6.7		not-accessible	A table of the DHCP interface configuration data maintained by the server.
TIM cDhcpv4SrvResetTime	1.3.6.1.4.1.9.10.122.1.1.2	TimeStamp	read-only	The time when the process supporting this server was last reinitialized. This indicates the time when a server reload or start was executed. At server startup this time is the same as cDhcpv4SrvStartTime.
TIM cDhcpv4SrvStartTime	1.3.6.1.4.1.9.10.122.1.1.1	TimeStamp	read-only	The time when the process supporting this server was started.
TIM cDhcpv4StatisticsResetTime	1.3.6.1.4.1.9.10.122.1.2.2	TimeStamp	read-only	The time the server statistics counters were last reinitialized; the statistics counters are reinitialized by a reset command, server reload, or server start; note also that any configuration change to reporting interval requires a server reload to take effect, which will reinitialize the statistics counters. If statistics are never reset, this time will equal cDhcpv4SrvResetTime, which may also equal cDhcpv4SrvStartTime, if the server was never reloaded.
ciscoIetfDhcpSrvExtMIB	1.3.6.1.4.1.9.10.122			The MIB module is an extension of the Cisco IETF Dynamic Host Configuration protocol (DHCP) MIB.
ciscoIetfDhcpv4SrvExtMIBConform	1.3.6.1.4.1.9.10.122.2
ciscoIetfDhcpv4SrvExtMIBNotifs	1.3.6.1.4.1.9.10.122.0
ciscoIetfDhcpv4SrvExtMIBObjects	1.3.6.1.4.1.9.10.122.1

RFC description

Extension of Cisco DHCPv4 server MIB for dynamic host configuration protocol management.

Start monitoring Cisco IOS router/switch configured as a DHCP server 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-IETF-DHCP-SERVER-EXT-MIB