traceroute overlay
Syntax
traceroute overlay <tunnel-type> vni vni tunnel-src source-ip-address tunnel-dst destination-ip-address <mac mac-address> <ttl value> <hash source-udp-port> <hash-input-interface input-interface> <hash-source-mac source-mac-address> <hash-destination-mac destination-mac-address> <hash-source-address source-IP-address> <hash-destination-address destination-IP-address> <hash-vlan vlan-id> <hash-protocol protocol-id> <hash-source-port source-layer4-port> <hash-destination-port destination-layer4-port>
Description
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.
Options
| tunnel-type | (Optional) Specify the overlay tunnel type used in a virtualized environment such as: VXLAN, Network Virtualization using Generic Routing Encapsulation (NVGRE), MPLS over User Datagram Protocol (UDP), and MPLS over General Routing Encapsulation (GRE) tunnels. Note:
Only VXLAN overlay tunnel types are supported. |
| vni vni | Specify the VNI of the VXLAN overlay segment.
|
| tunnel-src source-ip-address | Specify the IP address of the source entity at end of the tunnel, such as the source VTEP. |
| tunnel-dst destination-ip-address | Specify the IP address of the destination entity at the end of the tunnel, such as the remote VTEP. |
| mac mac-address | (Optional) Include the physical or hardware address on the end host you are trying to reach. |
| ttl value | (Optional) Time-to-live (TTL) value to include as the maximum number of hops in the traceroute request. For MX Series routers, the range of values is 0 through 255. The default value is 255.
|
| hash source-udp-port | (Optional) Specify the UDP source port. The range of values is 1 through 65,535. Usage of this parameter will override all other hash-* parameters used to calculate the UDP source port. |
| hash-source-mac source-mac-address | (Optional) Specify the MAC address of the source end host. Note:
The hash parameters provide values that correspond to
a particular data flow that the 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. |
| hash-destination-mac destination-mac-address | (Optional) Specify the MAC address of the destination end host. |
| hash-source-address source-IP-address | (Optional) Specify the IP address of the source end host. |
| hash-destination-address destination-IP-address | (Optional) Specify the IP address of the destination end host. |
| hash-vlan vlan-id | (Optional, QFX Series switches only) Specify the VLAN ID of the end host.
|
| hash-input-interface interface-name | (Optional, QFX Series switches only) Specify the ingress interface of the flow on the Juniper Networks device. |
| hash-protocol protocol-id | (Optional) Specify the TCP/UDP IP protocol ID of the end host.
|
| hash-source-port source-layer4-port | (Optional) Specify the Layer 4 source port of the end host.
|
| hash-destination-port destination-layer4-port | (Optional) Specify the Layer 4 destination port of the end host.
|
Required Privilege Level
network
Output Fields
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.
Field Name |
Field Description |
|---|---|
vni |
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. |
mac address |
The physical or hardware address of the end host you are trying to reach. |
ttl |
TTL value for the maximum number of hops in the traceroute request. |
hash-parameters |
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. |
ttl |
Number of hops remaining in the traceroute message. The TTL is decremented at each hop. |
Address |
The sending IPv4 address. |
Sender Timestamp |
Timestamp in microseconds when hop was sent. |
Receiver Timestamp |
Timestamp in microseconds when hop was received. |
Response Time |
Time in microseconds for traceroute to respond. |
Sample Output
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
Release Information
Command introduced in Junos OS Release 14.1X53-D30.