Utility
SoftLayer_Utility_Network::traceroute

Overview

Perform an ICMP traceroute from SoftLayer's application servers to the given IP address or hostname and return the raw results of that command. The returned result is similar to the result received from running the command `traceroute` from a UNIX command shell. A traceroute sends small diagnostic packets to every hop along the network route to a given host. Traceroutes are useful tools for debugging network connectivity to a host on the Internet. Routing loops and intermediate hop timeouts help to narrow down problematic providers along the network chain. Some providers elect to deny ICMP on their networks, which may cause a traceroute to show skewed results. Furthermore, many providers assign a low priority to traceroutes in their infrastructure which may lead to inaccurate hop response times. Running traceroute on a hostname instead of an IP address may fail if DNS lookup for that hostname also fails.

Parameters

address

string

An IP address or hostname to traceroute.

Headers

n/a
authenticate

Return Values

string

Associated Methods

SoftLayer_Utility_Network::ping
SoftLayer_Utility_Network::nslookup
SoftLayer_Utility_Network::whois

Error Handling

  • SoftLayer_Exception_Public: Throw the exception "Please provide an address to traceroute." if the address parameter is empty.
  • SoftLayer_Exception_Public: Throw the exception "Please provide a valid IP address or hostname." if the address parameter is not a valid IP address or hostname.