# Monitoring DHCP Local Server Statistics

#### Purpose

Display statistics for the DHCP local server.

#### Action

To display all DHCP local server statistics:

    host1#show ip dhcp-local statistics

    DHCP Local Server Statistics
     ----------------------------
             Item             Count
    -----------------------   -----
    memUsage                    184
    bindings                      2
    --Receive Statistics--
      discover                    8
      request(accept)            10
      request(renew)              6
      request(rebind)             2
      request(other)              6
      decline                     0
      release                     6
      inform                      0
      total in packet            38
      in error                    0
      in discard                  0
      unknown client packet       6
    --Transmit Statistics--
      offer                       8
      ack(accept)                10
      ack(renew)                  6
      ack(rebind)                 2
      nak                         6
      nak(renew)                  0
      nak(rebind)                 0
      total out packet           32
      out error                   0
      out discard                 0

To display DHCP local server statistics for a specific interface:

    host1#show ip dhcp-local statistics interface atm 4/0.32

        DHCP Local Server SubInterface Statistics
          Interface          Item                Count
    -------------------  --------------       -------------
    ATM4/0.32
    Receive Statistics
                         discover               4
                         request(accept)        5
                         request(renew)         1
                         request(rebind)        1
                         request(other)         3
                         decline                0
                         release                3
                         inform                 0
                         total in packet        17
                         in error               0
                         in discard             0
                         unknown client packet  3
    Transmit Statistics
                         offer                  4
                         ack(accept)            5
                         ack(renew)             1
                         ack(rebind)            1
                         nak                    3
                         nak(renew)             0
                         nak(rebind)            0
                         total out packet       14
                         out error              0
                         out discard            0

#### Meaning

Table 117 lists the show ip dhcp-local statistics command

Table 117: show ip dhcp-local statistics output fields.

Field Name | Field Description
--- | ---
memUsage | Number of bytes of memory used by the DHCP local server
bindings | Number of leased IP addresses currently assigned
Receive Statistics | Statistics for packets that have been received
discover | Number of DHCP discover messages received
request(accept) | Number of DHCP requests accepted
request(renew) | Number of DHCP requests for renewal received
request(rebind) | Number of DHCP requests for rebinding received
request(other) | Number of DHCP unknown requests received
decline | Number of DHCP decline messages received
release | Number of DHCP release messages received
inform | Number of DHCP inform messages received
total in packet | Number of packets received
in error | Number of packets received with errors that prevent further processing; count is independent of the message-type counters
in discard | Number of packets received that are discarded due to system resource issues; count is independent of the message-type counters
unknown client packet | Number of nonrequest packets that have no entry in the local server database received
Transmit Statistics | Statistics for packets that have been transmitted
offer | Number of DHCP offer messages sent
ack(accept) | Number of DHCP acknowledgments sent in response to accepted requests
ack(renew) | Number of DHCP acknowledgments sent in response to renewal requests
ack(rebind) | Number of DHCP acknowledgments sent in response to rebinding requests
nak | Number of DHCP NAK messages sent in response to requests that cannot be bound or that are unknown to this local server
nak(renew) | Number of DHCP NAK messages sent in response renewal requests
nak(rebind) | Number of DHCP NAK messages sent in response to rebinding requests
total out packet | Number of packets sent by the DHCP local server
out error | Number of packets that cannot be transmitted due to protocol errors or configuration errors; count is independent of the message-type counters
out discard | Number of packets that cannot be transmitted due to system resource issues; count is independent of the message-type counters

#### Related Documentation

- show ip dhcp-local statistics