Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation

traceroute

Syntax

traceroute host <as-number-lookup> <bypass-routing> <clns><gateway address><inet | inet6> <interface interface-name><logical system logical-system-name><monitor host> <mpls (ldp FEC address | rsvp label-switched-path-name)><no-resolve> <propagate-ttl><routing-instance routing-instance-name> <source source-address> <tos value> <ttl value><wait seconds>

Syntax (QFX Series)

traceroute host<as-number-lookup> <bypass-routing> <gateway address><inet> <interface interface-name><monitor host> <no-resolve> <routing-instance routing-instance-name> <source source-address> <tos value> <ttl value><wait seconds>

Release Information

Command introduced before Junos OS Release 7.4.

Command introduced in Junos OS Release 9.0 for EX Series switches.

mpls option introduced in Junos OS Release 9.2.

Command introduced in Junos OS Release 11.1 for the QFX Series.

propagate-ttl option introduced in Junos OS Release 12.1.

Description

Display the route that packets take to a specified network host. Use traceroute as a debugging tool to locate points of failure in a network.

Options

host

IP address or name of remote host.

as-number-lookup

(Optional) Display the autonomous system (AS) number of each intermediate hop on the path from the host to the destination.

bypass-routing

(Optional) Bypass the normal routing tables and send requests directly to a system on an attached network. If the system is not on a directly attached network, an error is returned. Use this option to display a route to a local system through an interface that has no route through it.

clns

(Optional) Trace the route belonging to the Connectionless Network Service (CLNS).

gateway address

(Optional) Address of a router or switch through which the route transits.

inet | inet6

(Optional) Trace the route belonging to IPv4 or IPv6, respectively.

interface interface-name

(Optional) Name of the interface over which to send packets.

logical-system logical-system-name

(Optional) Perform this operation on all logical systems or on a particular logical system.

monitor host

(Optional) Display real-time monitoring information for the specified host.

mpls (ldp FEC address | rsvp label-switched-path name)
no-resolve

(Optional) Do not attempt to determine the hostname that corresponds to the IP address.

propagate-ttl

(Optional) On the PE router, use this option to view locally generated Routing Engine transit traffic. This is applicable for MPLS L3VPN traffic only.

Use for troubleshooting, when you want to view hop-by-hop information from the local provider router to the remote provider router, when TTL decrementing is disabled on the core network using the no-proagate-ttl configuration statement.

Note: Using propagate-ttl with traceroute on the CE router does not show hop-by-hop information.

routing-instance routing-instance-name

(Optional) Name of the routing instance for the traceroute attempt.

source source-address

(Optional) Source address of the outgoing traceroute packets.

tos value

(Optional) Value to include in the IP type-of-service (ToS) field. The range of values is 0 through 255.

ttl value

(Optional) Maximum time-to-live value to include in the traceroute request. The range of values is 0 through 128.

wait seconds

(Optional) Maximum time to wait for a response to the traceroute request.

Required Privilege Level

network

 

Related Documentation

 

List of Sample Output

traceroute
traceroute as-number-lookup host
traceroute no-resolve
traceroute propogate-ttl
traceroute (Between CE Routers, Layer 3 VPN)
traceroute (Through an MPLS LSP)

Output Fields

Table 1 describes the output fields for the traceroute command. Output fields are listed in the approximate order in which they appear.

Table 1: traceroute Output Fields

Field Name

Field Description

traceroute to

IP address of the receiver.

hops max

Maximum number of hops allowed.

byte packets

Size of packets being sent.

number-of-hops

Number of hops from the source to the named router or switch.

router-name

Name of the router or switch for this hop.

address

Address of the router or switch for this hop.

Round trip time

Average round-trip time, in milliseconds (ms).

Sample Output

traceroute

user@host> traceroute santacruz
traceroute to green.company.net (10.156.169.254), 30 hops max, 40 byte packets
 1  blue23 (10.168.1.254)    2.370 ms  2.853 ms  0.367 ms
 2  red14  (10.168.255.250)  0.778 ms  2.937 ms  0.446 ms
 3  yellow (10.156.169.254)  7.737 ms  89.905 ms  0.834 ms

traceroute as-number-lookup host

user@host> traceroute as-number-lookup 10.100.1.1
traceroute to 10.100.1.1 (10.100.1.1), 30 hops max, 40 byte packets
 1  10.39.1.1 (10.39.1.1)  0.779 ms  0.728 ms  0.562 ms
 2  10.39.1.6 (10.39.1.6) [AS  32]  0.657 ms  0.611 ms  0.617 ms
 3  10.100.1.1 (10.100.1.1) [AS  10, 40, 50]  0.880 ms  0.808 ms  0.774 ms

traceroute no-resolve

user@host> traceroute santacruz no-resolve
traceroute to green.company.net (10.156.169.254), 30 hops max, 40 byte packets
 1  10.168.1.254  0.458 ms  0.370 ms  0.365 ms
 2  10.168.255.250  0.474 ms  0.450 ms  0.444 ms
 3  10.156.169.254  0.931 ms  0.876 ms  0.862 ms

traceroute propogate-ttl

user@host> traceroute propagate-ttl 100.200.2.2 routing-instance VPN-A
traceroute to 100.200.2.2 (100.200.2.2) from 1.1.0.2, 30 hops max, 40 byte packets
 1  1.2.0.2 (1.2.0.2)  2.456 ms  1.753 ms  1.672 ms
     MPLS Label=299776 CoS=0 TTL=1 S=0
     MPLS Label=299792 CoS=0 TTL=1 S=1
 2  1.3.0.2 (1.3.0.2)  1.213 ms  1.225 ms  1.166 ms
     MPLS Label=299792 CoS=0 TTL=1 S=1
 3  100.200.2.2 (100.200.2.2)  1.422 ms  1.521 ms  1.443 ms

traceroute (Between CE Routers, Layer 3 VPN)

user@host> traceroute vpn09
traceroute to vpn09.skybank.net (10.255.14.179), 30 hops max, 40 
      byte packets 
       1  10.39.10.21 (10.39.10.21)  0.598 ms  0.500 ms  0.461 ms 
       2  10.39.1.13 (10.39.1.13)  0.796 ms  0.775 ms  0.806 ms 
           MPLS Label=100006 CoS=0 TTL=1 S=1 
       3  vpn09.skybank.net (10.255.14.179)  0.783 ms  0.716 ms  0.686

traceroute (Through an MPLS LSP)

user@host> traceroute mpls1
traceroute to 10.168.1.224 (10.168.1.224), 30 hops max, 40 byte packets
 1  mpls1-sr0.company.net (10.168.200.101)  0.555 ms  0.393 ms  0.367 ms
     MPLS Label=1024 CoS=0 TTL=1
 2  mpls5-lo0.company.net (10.168.1.224)  0.420 ms  0.394 ms  0.401 ms

Published: 2013-08-15

 

Related Documentation

 

Published: 2013-08-15