GET
/v6/endpoint-data/tests/net/metrics/{testId}
(Network) End-to-End metrics
Returns network metrics (loss, latency, jitter and bandwidth) from each endpoint agent, for each roundId in the requested window. A time frame must be specified, or the current round of data will be returned.
Optional (Querystring) Parameters
format=json|xmloptional, specifies the format of output requested. See Output Formats for more informationwindow=[0-9]+[smhdw]?specifies a window of time for the result set. See Time Ranges for more information.from=YYYY-mm-ddTHH:MM:SS&to=YYYY-mm-ddTHH:MM:SSspecifies an explicit start (and optionally, end) for your range of data. See Time Ranges for more information.aid={aid}optional and requires the user to be assigned to the target account group, specifies the account group context of the request, obtained from the/account-groupsendpoint. Specifying this parameter without the user being assigned to the target account will result in an error response. See Account group context for more information
Request
{testId}the ID of the endpoint scheduled test you wish to retrieve- There is no request body for this request.
Response
| Field | Data Type | Units | Notes |
|---|---|---|---|
| agentId | string | n/a | unique ID of endpoint agent, from /endpoint-agents endpoint |
| avgLatency | float | milliseconds | average RTT for packets sent to destination |
| errorDetails | string | n/a | error details, if an error was encountered |
| jitter | float | milliseconds | standard deviation of latency |
| loss | float | percentage | % of packets not reaching destination |
| maxLatency | integer | milliseconds | maxmimum RTT for packets sent to destination |
| minLatency | integer | milliseconds | minimum RTT for packets sent to destination |
| permalink | url | n/a | link to jump to this result in the front end |
| roundId | long | seconds | epoch time (seconds) indicating the start time of the round |
| serverIp | string | n/a | IP address of target server |
Example
$ curl https://api.thousandeyes.com/v6endpoint-data/tests/net/metrics/273.json \
-u noreply@thousandeyes.com:g351mw5xqhvkmh1vq6zfm51c62wyzib2
Header
HTTP/1.1 200 OK
HTTP/1.1 200 OK
Server: nginx
Date: Sat, 25 Aug 2018 21:19:54 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Cache-Control: no-store
X-Organization-Rate-Limit-Limit: 240
X-Organization-Rate-Limit-Remaining: 239
X-Organization-Rate-Limit-Reset: 1535232000
Strict-Transport-Security: max-age=31536000
X-Content-Type-Options: nosniff
X-Server-Name: 1-2
Body
{
"endpointNet": {
"endpointTest": {...},
"metrics": [
{
"agentId": "1cf6d996-2400-4724-a805-2de78756c209",
"avgLatency": 10.0,
"jitter": 1.0,
"loss": 0.0,
"maxLatency": 13.0,
"minLatency": 7.0,
"permalink": "https://app.thousandeyes.com/view/endpoint-agent?__a=160&scenarioId=eyebrowNetworkTest&testId=273&roundId=1535228220",
"roundId": 1535228220,
"serverIp": "185.199.108.153"
},
...
]
},
"pages": {
"current": 1
}
}
For more information on our HTTP response status codes, see the response status codes documentation.