Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation

Solutions

Featured solutions AI Campus and branch Data center WAN Security Service provider Cloud operator Industries
Campus and Branch

Welcome to the NOW Way to Wi-Fi

Take your networking performance to new heights with a modern, cloud-native, AI-Native architecture. Only Juniper can help you unleash the full potential of Wi-Fi 7 with our AI-Native platform for innovation.
Prepare for liftoff
Business intelligence analyst dashboard on virtual screen. Big data Graphs Charts.

AI Data Center Networking

Juniper’s AI data center solution is a quick way to deploy high performing AI training and inference networks that are the most flexible to design and easiest to manage with limited IT resources.
Find out more
Enterprise AI-Native Networking

Enterprise AI‑Native Routing

Juniper's Ai-Native routing solution delivers robust 400GbE and 800GbE capabilities for unmatched performance, reliability, and sustainability at scale.
Explore enterprise routing
Zero trust security

Ops4AI Lab

Visit our lab in Sunnyvale, CA and see our AI data center solution for yourself. You can try out your own model’s functionality and performance, too.
Visit the lab
Enterprise AI-Native Networking

Enterprise AI‑Native Routing

Juniper's Ai-Native routing solution delivers robust 400GbE and 800GbE capabilities for unmatched performance, reliability, and sustainability at scale.
Explore enterprise routing
Higher Education

Shaping Student Experiences: The NOW Way to Build Higher Education Networks

Join Juniper Networks CIO Sharon Mandell and a virtual summit of C-level IT leaders from prestigious institutions as they discuss ongoing efforts to support digital transformation.
Register to attend
Hand on tablet with healthcare overlay of graphics

Security in healthcare

In this IDC Spotlight report, discover how AI networking can automate and strengthen a healthcare ecosystem to defeat criminals and prevent loss. 
Gain insights into ecosystem security
Retail

The Future of In-Store Technologies

Join us for an enlightening webinar with Kevin McCartan, Senior IT Service Delivery Engineer at Musgrave; retail guru Jack Stratten of Insider Trends; and Christian Gilby, Director of Product Marketing at Juniper Networks, as they discuss the future of in-store technologies.
Reserve my spot

Products

Wireless access Wired access SD-WAN / SASE Routing and switching Security Mist AI™ Management software Network operating system Blueprint for AI-Native Acceleration Optics
  • Operations
ACX7020 router

Juniper ACX7020 Cloud Metro Access Router

Legacy networks simply cannot meet the demands of today’s rapidly evolving metro landscape. Unlock a new generation of highly scalable architectures and automated operations with the Juniper ACX7020. 
Learn more
EX4000 Ethernet Switch

Next-gen AI-Native EX4000 line of switches

Lack of AI innovation from your current networking vendor slowing you down? Embrace Juniper’s cloud-native, AI-Native access switches that support every level and layer, across nearly every deployment.
Discover how
The Q and AI text with an image of Bob Friday and Kedar Dhuru.

The Q&AI Podcast

Delivering practical solutions and enriching discussions, this podcast series is a vital resource for those seeking an in-depth exploration of AI's transformative potential.
Catch the latest episode

Services

Services
Services AI Care

Juniper AI Care Services Revolutionize Your Service Experience

Our industry-first AI-Native services couple AIOps with our deep expertise across the full network life cycle. You can move from reactive response to proactive insight and action.
Explore AI Care Services
Services AI Data Center

Juniper AI Data Center Deployment Services Optimize Your AI Model Runs

We use our expertise and validated designs to help design, deploy, validate and tune networks, including GPUs and storage, to get the most from your AI infrastructure operation.
Learn about AI Data Center Deployment Services

Partners

Partners

Support and Documentation

Support and Documentation

Learn

About Juniper Training Events The Feed Resources Technology learning topics Thought leadership and insights
Audience raising hands up while businessman is speaking in training at the office.

Juniper certification and training news

See the latest
Ringing of the bell

All global events

See the latest
AI-native-now

AI-Native NOW event series

Register now
Juniper's Christina Hendrix at the head of a conference table. With the text "The NOW Way to Network" overlayed, with "NOW" emphasizing the "O" in green color.

The NOW Way to Network

Watch the video series
AI Native Now

Executive insights

Dive deep with leading experts and thought leaders on all the topics that matter most to your business, from AI to network security to driving rapid, relevant transformation for your business.
Learn more
A keynote speaker giving a presentation at a conference. There are dozens of people sitting around them. The presentation is displayed via projector on all the walls in the room.

Leadership voices

Juniper Networks’ leaders operate on the front lines of creating the network of the future. Take a look around to see what’s on their minds.
Watch now
Bob Friday and Jessica Garrison speaking

Bob Friday Talks

Join Bob as he ventures into all the knowns -- and -- unknowns -- of AI.
Catch the latest episode
Documentation
Menu
License Guide
Quick Starts
Validated Designs
Explore Pathfinder Apps
CLI Explorer
Feature Explorer
Hardware Compatibility Tool
Port Checker
Browse All
Collapse

Pathfinder Apps

All

By Software

By Hardware

Learn More
Pathfinder HomeCLI ExplorerCompliance AdvisorFeature ExplorerHardware Compatibility ToolJunos XML API ExplorerJunos YANG Data Model ExplorerPort CheckerPower CalculatorSNMP MIB ExplorerSystem Log Explorer
CLI ExplorerFeature ExplorerJunos XML API ExplorerJunos YANG Data Model ExplorerSNMP MIB ExplorerSystem Log Explorer
Compliance AdvisorFeature ExplorerHardware Compatibility ToolPort CheckerPower Calculator
Home Documentation Junos OS Junos CLI Reference CLI Reference S

Junos CLI Reference

keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
ON THIS PAGE
keyboard_arrow_right

show dhcp relay statistics

date_range 27-Nov-24
arrow_backward
arrow_forward

Syntax

content_copy zoom_out_map
show dhcp relay statistics 
<bulk-leasequery-connections>
<leasequery>
<logical-system logical-system-name>
<routing-instance routing-instance-name>

Syntax

Syntax for EX Series switches:

content_copy zoom_out_map
show dhcp relay statistics 
<routing-instance routing-instance-name>

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.

  • 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.

  • 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.

  • 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

  • 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

content_copy zoom_out_map
user@host> show dhcp relay statistics
Packets dropped:
    Total                      34
    Leasequery reply with older timestamp      7  
    Leasequery reply aborted                   12    
    Bad hardware address       1
    Bad opcode                 1
    Bad options                3
    Invalid server address     5
    Lease Time Violation       1
    No available addresses     1
    No interface match         2
    No routing instance match  9
    No valid local address     4
    Packet too short           2
    Read error                 1
    Send error                 1
    Option 60                  1
    Option 82                  2

Messages received:
    BOOTREQUEST                116
    DHCPDECLINE                0
    DHCPDISCOVER               11
    DHCPINFORM                 0
    DHCPRELEASE                0
    DHCPREQUEST                105
    DHCPLEASEACTIVE            0
    DHCPLEASEUNASSIGNED        0
    DHCPLEASEUNKNOWN           0
    DHCPLEASEQUERYDONE         0

Messages sent:
    BOOTREPLY                  0
    DHCPOFFER                  2
    DHCPACK                    1
    DHCPNAK                    0
    DHCPFORCERENEW             0
    DHCPLEASEQUERY             0
    DHCPBULKLEASEQUERY         0

Packets forwarded:
    Total                      4
    BOOTREQUEST                2
    BOOTREPLY                  2

External Server Response:
    State                      Responding

show dhcp relay statistics routing-instance (ACX Series)

content_copy zoom_out_map
user@root> show dhcp relay statistics routing-instance tenant-a
Packets dropped:
    Total                      19
    Leasequery reply with older timestamp      7   
    Leasequery reply aborted                   12          

Messages received:
    BOOTREQUEST                80
    DHCPDECLINE                0
    DHCPDISCOVER               40
    DHCPINFORM                 0
    DHCPRELEASE                3
    DHCPREQUEST                37
    DHCPLEASEACTIVE            17
    DHCPLEASEUNASSIGNED        0
    DHCPLEASEUNKNOWN           101
    DHCPLEASEQUERYDONE         0
    DHCPACTIVELEASEQUERY       0

Messages sent:
    BOOTREPLY                  179
    DHCPOFFER                  17
    DHCPACK                    22
    DHCPNAK                    7
    DHCPFORCERENEW             0
    DHCPLEASEQUERY             0
    DHCPBULKLEASEQUERY         0
    DHCPLEASEACTIVE            32
    DHCPLEASEUNASSIGNED        0
    DHCPLEASEUNKNOWN           101
    DHCPLEASEQUERYDONE         0
    DHCPACTIVELEASEQUERY       0

show dhcp relay statistics bulk-leasequery-connections

content_copy zoom_out_map
user@host> show dhcp relay statistics bulk-leasequery-connections

Total Requested Servers:    0
Total Attempted Servers:    0
Total Connected:            0
Total Terminated by Server: 0
Total Max Attempted:        0
Total Closed due to Errors: 0
In-Flight Connected:        0
Bulk Leasequery Reply Packet Retries:   0

Release Information

Command introduced in Junos OS Release 8.3.

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

Related Documentation

arrow_backward PREVIOUS show dhcp relay statistics (Security)
NEXT arrow_forward show dhcp-security arp inspection statistics
footer-navigation

© 1999 - 2025 Juniper Networks, Inc. All rights reserved.

Scroll to top