traceroute

Last updated
Save as PDF

traceroute—Display the path that packets take to reach a host or IP address on the network.

Command Syntax

traceroute interface interface-name [size bytes] [options options] (hostname | ip-address)
traceroute vpn vpn-id [interface interface-name] [size bytes] [options "options"] (hostname | ip-address)

Options

Interface: interface interface-name
Interface through which traceroute probe should send packets.
Network Host: (hostname | ip-address)
Hostname or IPv4 or IPv6 address of a system on the network.
Options: options "options"
One or more options for the traceroute probe. option can be one or more of the following. Enclose the options in quotation marks (" ").
–d: Set the SO_DEBUG options to socket.
–f first-ttl: Report the traceroute probe results starting with the specified hop in the path.
–g gateway: Add an IP source route gateway to the outgoing packet.
–I (capital letter "i"): Use ICMP echo packets instead of UDP datagrams.
–i (lowercase letter "i") interface-name: Network interface from which to obtain the source IP address for outgoing traceroute probe packets.
–m maximum-ttl: Set the maximum time-to-live value, which is the maximum number of hops.
–n: Print numeric IP addresses.
–p port: Base UDP port number to use in traceroute probes. The default port is 33434.
–q probes: Number of probes to send per TTL. The default is 3.
–r: Bypass the normal route tables, and send the traceroute probe directly to a host.
–s source-ip-address: Source IP address to use in the probe packets.
–t tos: Type-of-service value to use in the probe packets. The default is 0.
–v: Display output in verbose mode.
–w wait-time: Time, in seconds, to wait for a response. The default is 3 seconds.
–z pause-time: Time, in milliseconds, to pause between probes. The default is 0 milliseconds.
Probe Packet Size: size bytes
Size of the traceroute probe packets, in bytes. The maximum packet size is 32,768 bytes.

VPN: vpn vpn-id
VPN in which the network host is located.

Output Fields

The output is self-explanatory.

Example Output

vEdge-112# traceroute vpn 1 192.168.111.30
Traceroute in vpn 1
traceroute to 192.168.111.30 (192.168.111.30), 30 hops max, 46 byte packets
1  172.23.2.2 (172.23.2.2)  0.171 ms  0.196 ms  0.126 ms
2  100.100.100.11 (100.100.100.11)  0.128 ms  0.197 ms  0.127 ms
3  100.100.100.12 (100.100.100.12)  0.165 ms  0.194 ms  0.146 ms
4  172.23.111.2 (172.23.111.2)  0.218 ms  0.227 ms  0.214 ms
5  192.168.111.30 (192.168.111.30)  1.173 ms  0.824 ms  1.239 ms

vEdge# traceroute host 10.2.3.12 size 1000 vpn 1 options "-q1 -w1 -m5"
Traceroute -q1 -w1 -m5 10.2.3.12 in VPN 1
traceroute to 10.2.3.12 (10.2.3.12), 5 hops max, 1000 byte packets
1 10.20.24.15 (10.20.24.15) 0.254 ms
2 10.0.5.21 (10.0.5.21) 1.318 ms
3 10.2.3.12 (10.2.3.12) 1.310 ms

Release Information

Command introduced in Viptela Software Release 14.1.
In Release 14.2, add interface, options, size, and vpn options.
In Release 16.3, add support for IPv6 host addresses.

Additional Information

ping
show interface
show ipv6 interface
tools nping