Monitoring DHCP Relay Statistics
Purpose
Display DHCP packet error and relay agent option statistics that are reported for both DHCP relay and DHCP relay proxy, and also to display DHCP server statistics related only to DHCP relay.
![]() | Note: The show dhcp relay proxy statistics command displays additional DHCP statistics that the router reports only for DHCP relay proxy. |
Action
To display DHCP relay statistics:
host1# show dhcp relay statistics DHCP Relay Statistics --------------------- Statistic Values ----------------------------------------------------------- ------ Packet error statistics (standard & proxy modes): dropped discover packets, no resources 0 dropped dhcp packets, no resources 0 dropped bad message operation packets 0 dropped unknown message type request packets 0 dropped unknown message type reply packets 0 Packet Pacing Algorithm (standard & proxy modes): Speed up pacer 0 Slow down pacer 0 Current client pps 1024 Relay Agent Option statistics (standard & proxy modes): add Relay Agent Option circuit ID suboption On add Relay Agent Option remote ID suboption On packets with giaddr override 0 packets with Relay Agent Option override 2 packets forwarded with Relay Agent Option already present 4 dropped packets with Relay Agent Option already present 3 dropped giaddr spoof packets 0 DHCP server statistics (standard mode only): dropped duplicate request packets 12 packets transmitted to servers 38 packets received from servers 26 dropped unknown xid reply packets 0 dropped stale request packets 12
To display detailed statistics for DHCP relay only, use the optional detail keyword—this command displays DHCP server statistics and dropped unknown message type reply packets statistics:
host1# show dhcp relay statistics detail DHCP Relay Detail Statistics ---------------------------- Statistics 10.10.1.1 192.168.32.12 192.168.32.1 ------------------------------------ --------- ------------- ------------ Dropped unknown message type replies 0 0 0 Dropped duplicate requests 6 6 0 Packets transmitted to server 6 6 26 Packets received from server 0 0 26 Dropped unknown xids replies 0 0 0 Dropped stale requests 6 6 0
Meaning
Table 1 lists the show dhcp relay statistics command output fields.
Table 1: show dhcp relay statistics Output Fields
Field Name | Field Description |
---|---|
Packet error statistics (standard & proxy modes) | |
dropped discover packets, no resources | Number of received DHCP relay discover messages that were discarded because of lack of resources |
dropped dhcp packets, no resources | Number of received DHCP relay messages, other then discover messages, that were discarded because of lack of resources |
dropped bad message operation packets | Number of received DHCP relay messages that were discarded because their message operation (for example, bootrequest, bootreply) was unknown, possibly due to corruption |
dropped unknown message type request packets | Number of received DHCP relay request messages that were discarded because their message type (for example, discover, offer-request) was unknown, possibly due to corruption |
dropped unknown message type reply packets | Number of received DHCP relay reply messages that were discarded because their message type (for example, offer, ack) was unknown, possibly due to corruption |
Packet Pacing Algorithm (standard & proxy modes) | |
Speed up pacer | Number of times the DHCP relay increased the rate of client packets processed |
Slow down pacer | Number of times the DHCP relay decreased the rate of client packets processed |
Current client pps | Rate of client packets processed per second |
Relay Agent Option statistics (standard & proxy modes) | |
add Relay Agent Option circuit ID suboption | Status of circuit ID suboption, on or off |
add Relay Agent Option remote ID suboption | Status of remote ID suboption, on or off |
packets with giaddr override | Number of received DHCP relay requests whose giaddr field is overridden with IP address 0.0.0.0 |
packets with Relay Agent Option override | Number of received DHCP relay requests whose relay agent information option is overridden with an option string created by this relay agent |
packets forwarded with Relay Agent Option already present | Number of received DHCP relay requests already containing the relay agent information option that were forwarded to DHCP servers |
dropped packets with Relay Agent Option already present | Number of received DHCP relay requests that were discarded because they already contained the relay agent information option when this relay agent was configured to insert the option |
dropped giaddr spoof packets | Number of received DHCP relay requests that were discarded because the gateway IP address field already contained this relay agent’s IP address |
DHCP server statistics (standard mode only) | |
dropped duplicate request packets | Number of received DHCP relay requests that were discarded because they have a matching server address and XID of an outstanding DHCP server request |
packets transmitted to servers | Number of DHCP relay requests successfully transmitted to DHCP servers |
packets received from servers | Number of DHCP relay replies successfully received from DHCP servers |
dropped unknown xid reply packets | Number of DHCP relay replies received from DHCP servers that were discarded because their server address and XID do not match an outstanding DHCP server request |
dropped stale request packets | Number of DHCP relay requests sent to DHCP servers that were discarded because their replies timed out |