Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

show dhcp relay statistics

Syntax

Syntax

Syntax for EX Series switches:

Description

Display Dynamic Host Configuration Protocol (DHCP) relay statistics.

Options

bulk-leasequery-connections

(Optional) Display information about DHCP relay bulk leasequery statistics.
leasequery

(Optional) Display information about DHCP relay individual leasequery statistics.
logical-system logical-system-name

(On routers only) (Optional) Perform this operation on the specified logical system. If you do not specify a logical system name, statistics are displayed for the default logical system.
routing-instance routing-instance-name

(Optional) Perform this operation on the specified routing instance. If you do not specify a routing instance name, statistics are displayed for the default routing instance.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show dhcp relay statistics command. Output fields are listed in the approximate order in which they appear.

Table 1: show dhcp relay statistics Output Fields

Field Name

Field Description

Packets dropped

Number of packets discarded by the extended DHCP relay agent application due to errors. Only nonzero statistics appear in the Packets dropped output. When all of the Packets dropped statistics are 0 (zero), only the Total field appears.

  • Total—Total number of packets discarded by the extended DHCP relay agent application.

  • Bad hardware address—Number of packets discarded because an invalid hardware address was specified.

  • Bad opcode—Number of packets discarded because an invalid operation code was specified.

  • Bad options—Number of packets discarded because invalid options were specified.

  • Event Rate Analyzer—Number of DHCP packets discarded by the Event Rate Analyzer (ERA) to protect the system from overload. ERA monitors incoming login packets, admitting only what the system can handle based on current load. ERA is enabled by default and ensures system stability during high-volume DHCP traffic, such as in broadband network gateways (BNG) or subscriber services. The system determines the value empirically.

  • Invalid server address—Number of packets discarded because an invalid server address was specified.

  • Lease Time Violation—Number of packets discarded because of a lease time violation

  • Leasequery reply with older timestamp— Number of packets dropped when the binding information on the device has latest information compared to that of received in ALQ.

  • Leasequery reply aborted— Number of packets dropped when events like release or authorize disconnect are received during lease query processing.

  • No available addresses—Number of packets discarded because there were no addresses available for assignment.

  • No interface match—Number of packets discarded because they did not belong to a configured interface.

  • No routing instance match—Number of packets discarded because they did not belong to a configured routing instance.

  • No valid local address—Number of packets discarded because there was no valid local address.

  • Packet too short—Number of packets discarded because they were too short.

  • Read error—Number of packets discarded because of a system read error.

  • Send error— Number of packets that the extended DHCP relay application could not send to the receivers through the FreeBSD sendmsg ( ) function.

  • Option 60—Number of packets discarded containing DHCP option 60 vendor-specific information.

  • Option 82—Number of packets discarded because DHCP option 82 information could not be added.

Messages received

Number of DHCP messages received.

  • BOOTREQUEST—Number of BOOTP protocol data units (PDUs) received

  • DHCPDECLINE—Number of DHCP PDUs of type DECLINE received

  • DHCPDISCOVER—Number of DHCP PDUs of type DISCOVER received

  • DHCPINFORM—Number of DHCP PDUs of type INFORM received

  • DHCPRELEASE—Number of DHCP PDUs of type RELEASE received

  • DHCPREQUEST—Number of DHCP PDUs of type REQUEST received

  • DHCPLEASEACTIVE—Number of active DHCP leases

  • DHCPLEASEUNASSIGNED—Number of DHCP leases that are managed by the server but have not yet been assigned

  • DHCPLEASEUNKNOWN—Number of unknown DHCP leases

  • DHCPLEASEQUERYDONE—The leasequery is complete

Messages sent

Number of DHCP messages sent.

  • BOOTREPLY—Number of BOOTP PDUs transmitted

  • DHCPOFFER—Number of DHCP OFFER PDUs transmitted

  • DHCPACK—Number of DHCP ACK PDUs transmitted

  • DHCPNACK—Number of DHCP NACK PDUs transmitted

  • DHCPFORCERENEW—Number of DHCP FORCERENEW PDUs transmitted

  • DHCPLEASEQUERY—Number of DHCP leasequery messages transmitted

  • DHCPLEASEBULKLEASEQUERY—Number of DHCP bulk leasequery messages transmitted

External Server Response

State of the external DHCP server responsiveness.

Packets forwarded

Number of packets forwarded.

  • BOOTREQUEST—Number of BOOTREQUEST protocol data units (PDUs) forwarded

  • BOOTREPLY—Number of BOOTREPLY protocol data units (PDUs) forwarded

External Server Response

State of the external DHCP server responsiveness.

Total Requested Servers

Total number of servers with which the DHCP relay agent has requested a bulk leasequery connection.

Total Attempted Servers

Total number of servers with which the DHCP relay agent has attempted to create a bulk leasequery connection.

Total Connected

Total number of servers that have formed a bulk leasequery connection with the DHCP relay agent.

Total Terminated by Server

Total number of servers that have terminated a bulk leasequery connection with the DHCP relay agent.

Total Max Attempted

Total number of servers where the DHCP relay agent reached the maximum retry limit when it attempted to create a bulk leasequery connection.

Total Closed due to Errors

Total number of bulk leasequery connections that closed due to an internal error on the DHCP relay agent.

In-Flight Connected

Number of current bulk leasequery connections on the DHCP relay agent.

Bulk Leaasequery Reply Packet Retries

Number of bulk leasequery reply packets that the DHCP relay agent has retried.

Sample Output

show dhcp relay statistics

show dhcp relay statistics (EX Series)

Note:

Client devices might experience delays in obtaining IP addresses under high DHCP request rates. The Event Rate Analyzer (ERA) protects the system from overload by monitoring incoming DHCP traffic and dropping packets when the system is under stress.

The ERA threshold is internally determined and not configurable. To identify whether ERA drops are occurring, use the the show dhcp relay statistics command, which displays counters for discarded packets.

Packet drops under high traffic conditions are expected behaviour and indicate that ERA is actively protecting system stability.

show dhcp relay statistics routing-instance (ACX Series)

show dhcp relay statistics bulk-leasequery-connections

Release Information

Command introduced in Junos OS Release 8.3.

bulk-leasequery-connections option introduced in Junos OS Release 16.1.

Related Documentation