# Trace Measurements

> Configure traceroute measurements, where the agent sends ICMP Echo requests with an increasing time-to-live.

Source: https://docs.capaone.com/performanceguard/technical-reference/concepts/trace-measurements/  
Product: PerformanceGuard — a separate CapaSystems product; do not apply this page to any other.

A series of ICMP Echo requests are sent out by the agent. For each request the time-to-live (TTL) is increased. The destination IP address for the requests is set to the trace destination.

You can specify a number of parameters for traceroutes:

**Text**

```text
host = <hostname or IP address>, that is the traceroute endpoint.
```

**Text**

```text
MaxTTL = Maximum number of routers that will be traced, the default is 30.
```

**Text**

```text
Timeout = Number of milliseconds that the agent will wait for a reply, the default is 5000 (5 seconds).
```

**Text**

```text
Repetitions = Number of times a traceroute should be repeated to improve precision of measurement, the default is 2.
```

For each TTL a report line is produced that reflects the response time to the particular router. If a router doesn't respond to the ICMP Echo request, the line inserted has a router IP of 255.255.255.255, and the status code will be set to 10000.

**Text**

```text
Napp ID : 900
Protocol : 1
Agent Ip : 192.168.101.101
# : 1141921307

JumpCount Router          Success Status Iterations Response Time
-----------------------------------------------------------------   
1      192.168.101.001 yes      11013           1          500   
2      080.196.040.137 yes      11013           1        17000   
3      083.088.008.066 yes      11013           1         8000   
4      083.088.012.089 yes      11013           1         8000   
5      083.088.020.021 yes      11013           1         9000   
6      083.088.020.222 yes      11013           1         8000   
7      083.088.000.166 yes      11013           1         8000   
8      195.215.109.098 yes      11013           1         9000   
9      195.184.096.046 yes          0           1        11000 

Number of reports : 1
```

| **Parameter**     | **Description**                                                                                                                                                                                                                                                                                                                                                                |
|:------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **JumpCount**     | The Time To Live (TTL) value used to reach                                                                                                                                                                                                                                                                                                                                     |
| **Router**        | Depending on the Status code this value is: <br/>1. 0 - address of the final destination<br/>2. 10000 - 255.255.255.255 'ghost' router address non-replying router<br/>3. 11010 - address of the final destination - destination was never reached<br/>4. 11013 - address of in-route router                                                                                      |
| **Success**       | Depends on the Status code: <br/>1. 0 - 1 (success)<br/>2. 10000 - 1 (success)<br/>3. 11010 - 0 (failure)<br/>4. 11011 - 0 (failure)<br/>5. 11013 - 1 (success)                                                                                                                                                                                                                    |
| **Status**        | The following codes are used: <br/>1. 0 - Proper reply from the final destination<br/>2. 10000 - Non replying in-route router<br/>3. 11010 - Non replying destination<br/>4. 11011 - Bad request - no request sent (ICMP library unavailable, or destination IP couldn't be resolved)<br/>5. 11013 - Packet expired in transit, this is the code reported by all in-route routers. |
| **Iterations**    | Always 1                                                                                                                                                                                                                                                                                                                                                                       |
| **Response time** | Number of microseconds that the round-trip has taken. If the operating system reports a round-trip time of zero, a value of 500 microseconds (0.5 milliseconds) is used.                                                                                                                                                                                                       |
