Command introduced in Junos OS Release 14.1X53-D30 for QFX Series switches.
Command introduced in Junos OS Release 16.1 for EX Series switches.
Command introduced in Junos OS Release 16.2 for MX Series routers.
Display the route that packets take between two Virtual Extensible LAN (VXLAN) tunnel endpoints (VTEPs) and within the context of a VXLAN overlay segment. Use traceroute overlay as an isolation and debugging tool to locate points of failure within an overlay VXLAN tunnel. The output is useful for diagnosing a point of failure in the path from the device to the destination host, and for addressing network traffic latency and throughput problems.
The traceroute overlay command is not supported for IPv6.
The traceroute overlay command is not supported when there are multiple virtual-switch routing instances.
Only VXLAN overlay tunnel types are supported.
Range: 1 through 16,777,215
For MX Series routers, the range of values is 0 through 255. The default value is 255.
Range: (QFX Series, EX9200 switches) 1 through 255
The hash parameters provide values that correspond to a particular data flow that the traceroute overlay command debugs. Based on the values that you specify, the system calculates a VXLAN UDP header source port hash, which is included in the VXLAN UDP header of the overlay ping and traceroute packets. Including the calculated hash in the VXLAN header enables the overlay ping and traceroute packets to emulate data packets in the flow that you are troubleshooting.
When using the hash parameters, we recommend that you specify a value for each parameter. The exception to this guideline is the hash-vlan parameter, which you do not have to use if the source endpoint is not a member of a VLAN. This practice ensures that the overlay ping and traceroute processes are successful and that the output for each command is accurate. If you do not specify a value for one or more of the hash parameters, the system sends an OAM request that might include incorrect hash values and generates a warning message.
Hash computation supports TCP and UDP protocols only.
Range: 1 through 4094
Range: 1 through 255
Range: 1 through 65,535
Range: 1 through 65,535
Required Privilege Level
List of Sample Outputrun traceroute overlay
Use the traceroute overlay command to determine overlay segments within a VXLAN tunnel. The output is useful for diagnosing a point of failure in the path from the device to the destination host, and for addressing network traffic latency and throughput problems.
Table 1 lists the output fields for the traceroute overlay command. Output fields are listed in the approximate order in which they appear.
Table 1: traceroute overlay Output Fields
The VNI of the VXLAN overlay segment.
tunnel src ip
The IP address of the source end of the tunnel.
tunnel dst ip
The IP address of the destination end of the tunnel.
The physical or hardware address of the end host you are trying to reach.
TTL value for the maximum number of hops in the traceroute request.
The hash parameters provide the input interface, source MAC address, destination MAC address, source IP address, destination IP address, and the VLAN ID of the two end hosts within an overlay segment. Hash parameters enable platform-specific hash computation to use as the source port in the outer UDP header.
Number of hops remaining in the traceroute message. The TTL is decremented at each hop.
The sending IPv4 address.
Timestamp in microseconds when hop was sent.
Timestamp in microseconds when hop was received.
Time in microseconds for traceroute to respond.
run traceroute overlay
user@host> traceroute overlay tunnel-type vxlan vni 100 tunnel-src 192.0.2.10 tunnel-dst 192.0.2.20 mac 00:00:5E:00:53:cc hash-source-mac 00:00:5E:00:53:aa hash-destination-mac 00:00:5E:00:53:cc hash-source-address 198.51.100.1 hash-destination-address 198.51.100.3 hash-vlan 150 hash-input-interface xe-0/0/2 hash-protocol 17 hash-source-port 4456 hash-destination-port 4540
traceroute-overlay protocol vxlan vni 100 tunnel src ip 192.0.2.10 tunnel dst ip 192.0.2.20 mac address 00:00:5E:00:53:cc ttl 255 hash-parameters: input-ifd-idx 653 end-host smac 00:00:5E:00:53:aa end-host dmac 00:00:5E:00:53:cc end-host src ip 198.51.100.1 end-host dst ip 198.51.100.3 end-host protocol 17 end-host l4-src-port 4456 end-host l4-dst-port 4540 end-host vlan 150 ttl Address Sender Timestamp Receiver Timestamp Response Time 1 10.1.0.1 09-25 00:56:17 PDT.663 msecs * 10 msecs 2 192.0.2.20 09-25 00:56:17 PDT.684 msecs 09-25 00:56:17 PDT.689 msecs 11 msecs Overlay-segment present at RVTEP 192.0.2.20 End-System Present