Traceroutes

Traceroute

POST/accounts/{account_id}/diagnostics/traceroute

ModelsExpand Collapse

Traceroute = object { colos, target }

colos: optional array of object { colo, error, hops, 2 more }

colo: optional object { city, name }

city: optional string

Source colo city.

name: optional string

Source colo name.

error: optional "" or "Could not gather traceroute data: Code 1" or "Could not gather traceroute data: Code 2" or 2 more

Errors resulting from collecting traceroute from colo to target.

One of the following:

"Could not gather traceroute data: Code 1"

"Could not gather traceroute data: Code 2"

"Could not gather traceroute data: Code 3"

"Could not gather traceroute data: Code 4"

hops: optional array of object { nodes, packets_lost, packets_sent, packets_ttl }

nodes: optional array of object { asn, ip, labels, 6 more }

An array of node objects.

asn: optional string

AS number associated with the node object.

ip: optional string

IP address of the node.

labels: optional array of string

Field appears if there is an additional annotation printed when the probe returns. Field also appears when running a GRE+ICMP traceroute to denote which traceroute a node comes from.

max_rtt_ms: optional number

Maximum RTT in ms.

mean_rtt_ms: optional number

Mean RTT in ms.

min_rtt_ms: optional number

Minimum RTT in ms.

name: optional string

Host name of the address, this may be the same as the IP address.

packet_count: optional number

Number of packets with a response from this node.

std_dev_rtt_ms: optional number

Standard deviation of the RTTs in ms.

packets_lost: optional number

Number of packets where no response was received.

packets_sent: optional number

Number of packets sent with specified TTL.

packets_ttl: optional number

The time to live (TTL).

target_summary: optional unknown

Aggregated statistics from all hops about the target.

traceroute_time_ms: optional number

Total time of traceroute in ms.

target: optional string

The target hostname, IPv6, or IPv6 address.