Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

traceroute

Syntax

Syntax (QFX Series and OCX Series)

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.

ce-ip IPv4 or IPv6 address

(MX Series routers with MPC and MIC interfaces only) (Optional) Check the route to a customer edge (CE) IP address in a virtual private LAN service (VPLS) and Ethernet VPN (EVPN) network.

clns

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

ethernet host

(Optional) Trace the route to an Ethernet host using unicast MAC address.

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 (all | logical-system-name)

(Optional) This option is not supported for Junos OS Evolved Release 18.3R1. Perform this operation on all logical systems or on a particular logical system.

tenant tenant-name

(Optional) Name of a particular tenant system for traceroute attempt.

monitor host

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

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

(Optional) See traceroute mpls ldp and traceroute mpls rsvp.

next-hop

The next-hop through which to send packets to a destination.

no-resolve

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

overlay

(Optional) Traceroute overlay path.

port

(Optional) Base port number to use in traceroute probes.

propagate-ttl

(Optional) On the PE routing device, 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.

The remaining statements are explained separately. See CLI Explorer.

Required Privilege Level

network

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

traceroute as-number-lookup host

traceroute no-resolve

traceroute propogate-ttl

traceroute (Between CE Routers, Layer 3 VPN)

traceroute (Through an MPLS LSP)

traceroute routing-instance no-resolve (Through an MPLS LSP)

traceroute (Junos OS Evolved, Through an MPLS LSP)

The Junos OS Evolved traceroute command parses MPLS data in the same way as the Linux traceroute command: L=label, E=exp_use, S=stack_bottom, and T=TTL. In the example below, T=1/L=16 indicates the TTL with label 16.

Release Information

Command introduced before Junos OS Release 7.4.

mpls option introduced in Junos OS Release 9.2.

propagate-ttl option introduced in Junos OS Release 12.1.

Support for IPv6 traceroute with as-number-lookup introduced with Junos OS Release 18.3R1.

The command tenant option is introduced in Junos OS Release 19.2R1 for the SRX Series.

The following options are deprecated in Junos OS Evolved Release 18.3R1: logical-system and propagate-ttl.