traceroute

This command performs a traceroute and displays the route (path) and packet transit delays across an IP network, for diagnostic purposes.

Syntax

traceroute {<IPv4 Address or Hostname>|ethernet|ipv6}
traceroute ethernet mpid <Endpoint Identifier> domain <Domain Name> 
traceroute  {ipv6 <IPv6 Address>|<IPv4 Address>} [max-ttl <Hop Limit>] [proto udp|icmp] [resolve-to-name]
traceroute {ipv6 <IPv6 Address>|<IPv4 Address>} source data {source-address interface <Interface Type> <Slot/Port/VLAN>|vrf <VRF Name> [max-ttl <Hop Limit>] [proto udp|icmp] [resolve-to-name]
traceroute {ipv6 <IPv6 Address>|<IPv4 Address>} source network-source <IP address alias or VRF> [proto udp|icmp]

Command

Description

IPv4 Address or Hostname

The IPv4 address or hostname to which the trace is sent.

source data source-address interface

Source interface, for example, gigabitethernet 0/0.

source data vrf

Source VRF name.

source network-source

Source network (alias or VRF).

max-ttl

Defines the maximum number of hops to the destination (1-30; default is 30).

proto {icmp|udp}

Defines the protocol type. The default is UDP. IPv4 traceroute also supports icmp protocol type.

resolve-to-name

If a DNS server has been configured, this option displays the FQDN of each node on the path to the destination (where possible). After entering this command option, no other options can be entered.

Note

Supports both IPv4 and IPv6 addresses.
In IPv4, it supports hostname resolution as well.
Sends three requests to each hop on the way to the destination.

Command Mode

Basic and Privileged User

Example

Examples of using this command:

IPv6:
traceroute ipv6 2014:6666::dddd
1  2014:7777::aa55 (2014:7777::aa55)  2.421 ms  2.022 ms  2.155 ms 
2  2014:6666::dddd (2014:6666::dddd)  2.633 ms  2.481 ms  2.568 ms 
Traceroute: Destination reached
IPv4:
traceroute 10.3.0.2
1  1 (10.4.0.1)  2.037 ms  3.665 ms  1.267 ms 
2  1 (10.3.0.2)  1.068 ms  0.796 ms  1.070 ms
Traceroute: Destination reached