ThousandEyes for OpenTelemetry Metrics

Supported Tests Types

Note: An asterisk (*) signifies attributes that are commonly found in many tests. Tests that do not include these common attributes typically have other agent-related attributes, such as OneWay metrics.

Cloud & Enterprise Agents

Test Type
Metrics
Specific Attributes
Http Server
  • http.metrics.availability (percentage)
  • http.metrics.throughput (bytes/second)
  • http.metrics.response.time (milliseconds)
  • Url
  • Server.ip
  • Response.code
  • error.type
Agent-to-Server (Network)
  • net.metrics.latency (milliseconds)
  • net.metrics.loss (percentage)
  • net.metrics.jitter (milliseconds)
  • server.name
  • server.ip
One-way Agent-to-Agent (Network)
  • net.metrics.latency (milliseconds)
  • net.metrics.loss (percentage)
  • net.metrics.jitter (milliseconds)
  • direction
  • source.agent.*
  • target.agent.*
Two-way Agent-to-Agent (Network)
  • net.metrics.latency (milliseconds)
  • net.metrics.loss (percentage)
  • net.metrics.jitter (milliseconds)
  • direction
Web Transaction
  • transaction.metrics.time (milliseconds)
  • transaction.metrics.errors (number: 0 if there are no errors, 1 if there are errors)
  • transaction.metrics.completion (percentage)
  • error.type
  • error.details
DNS Server
  • dnsserver.metrics.availability (percentage)
  • dnsserver.metrics.resolution.time (milliseconds)
  • error.details
  • server.id
  • server.name
DNSSEC
  • dnssec.metrics.validity (percentage)
  • error.details
DNS Trace
  • dnstrace.metrics.availability (percentage)
  • dnstrace.metrics.query.time (milliseconds)
  • error.details
  • query.count
  • query.failed_count
  • finalserver
Page Load
  • pageload.metrics.completion (percentage)
  • pageload.metrics.time (milliseconds)
  • error.details
  • error.num
  • response.time.first
  • response.time.dom
  • object.size
  • object.num
FTP Server
  • ftp.metrics.availability (percentage)
  • ftp.metrics.response.time (milliseconds)
  • ftp.metrics.throughput (bytes/second)
  • error.type
  • server.ip
SIP Server
  • sip.metrics.availability (percentage)
  • sip.metrics.response.time (milliseconds)
  • sip.metrics.total.time (milliseconds)
  • error.type
  • error.details
  • server.ip
RTP Stream
  • rtp.metrics.mos (score)
  • rtp.metrics.loss (percentage)
  • rtp.metrics.discards (percentage)
  • rtp.metrics.latency (milliseconds)
  • server.ip

Endpoint Agents

Test Type
Metrics
Specific Attributes
Http Server
  • http.metrics.availability (percentage)
  • http.metrics.throughput (bytes/second)
  • http.metrics.response.time (milliseconds)
  • url
  • server.ip
  • response.code
  • error.type
Agent-to-Server (Network)
  • net.metrics.latency (milliseconds)
  • net.metrics.loss (percentage)
  • net.metrics.jitter (milliseconds)
  • server.ip

Attributes

The OpenTelemtry pipepline supports the following OTel test data attributes:

Common Attributes

Key
Data Type
Description
test.domain
String
Identifies the origin of the test data. Possible values: cea, endpoint.
test.type
String
Identifies the type of test. Possible values: "agent-to-agent", "agent-to-server", "dns-dnssec", "dns-server", "dns-trace", "ftp-server", "http-server", "page-load", "voice" , "sip-server, "web-transactions".
agent.id*
Int64
Identifies the ThousandEyes agent that ran the test.
agent.location*
String
Agent location.
agent.name*
String
Agent name.
datapoint.created
Int64 (milliseconds)
Time in milliseconds when the DataPoint was created on the CEA side.
datapoint.id
String
Unique ID for each data point.
datapoint.received
Int64 (milliseconds)
Time in milliseconds when the DataPoint was received from Kafka by the collectors.
integration.id
String (UUID)
ID of the integration used to route the data point to the external service.
permalink
String (URL)
URL for the network test instance that generated the data.
round.id
Int64
Identifies the network test instance that generated the data.
test.id
String
Identifies the ThousandEyes network test.

Cloud & Enterprise Agents Test Attributes

Agent-to-Agent (One Way)

Key
Data Type
Description
direction
Enum
SOURCE_TO_TARGET or TARGET_TO_SOURCE.
source.agent.id
Int64
Identifies the ThousandEyes agent that ran the test.
source.agent.location
String
Source agent location.
source.agent.name
String
Source agent name.
target.agent.id
Int64
Identifies the ThousandEyes agent that was the target of the network test.
target.agent.location
String
Target agent location.
target.agent.name
String
Target agent name.

Agent-to-Agent (Two Way)

Key
Data Type
Description
direction
String
BIDIRECTIONAL

Web Transaction

Key
Data Type
Description
error.type
String
The type of error which occurred during the execution of the transaction. This attribute only exists if there are errors.
error.details
String
Details of errors during the execution of the transaction. This attribute only exists if there are errors.

DNS Server

Key
Data Type
Description
error.details
String
Details of errors during test execution. This attribute only exists if there are errors.
server.id
String
ID of the server targeted by the test.
server.name
String
Test target server host name.

DNSSEC

Key
Data Type
Description
error.details
String
Details of errors during test execution. This attribute only exists if there are errors.

DNS Trace

Key
Data Type
Description
error.details
String
Details of errors during test execution. This attribute only exists if there are errors.
query.count
Int64
Number of required queries to get to the requested result.
query.failed_count
Int64
Number of failed queries while getting the requested result.
finalserver
String
DNS server that provided the final result

Page load

Key
Data Type
Description
error.details
String
Details of errors during test execution. This attribute only exists if there are errors.
error.num
Int64
Number of objects which encountered errors during download
response.time.first
float64
Time to first byte.
response.time.dom
float64
Time to interaction.
object.size
Int64
Sum of wire size of all objects on page
object.num
Int64
Number of objects found on the page.

FTP Server

Key
Data Type
Description
server.ip
String
IP of the server targeted by the FTP test.
error.type
String
The error type for the test (not set if there is no error).

SIP Server

Key
Data Type
Description
server.ip
String
IP of the server targeted by the SIP test (or SIP proxy, if proxy is configured).
error.type
String
The error type for the test (not set if there is no error).
error.details
String
Details about the error which occurred during the execution. This attribute only exists if there are errors.

Endpoint Agents Test Attributes

Http Server

Key
Data Type
Description
url
String
The final URL after redirects.
server.ip
String
IP of the server targeted by the network test.
response.code
Int64
HTTP response status code (only set if there was a HTTP response).
error.type
String
The error type for the test (not set if there is no error).

Agent-to-Server (Network)

Key
Data Type
Description
server.name
String
The final URL after redirects.
server.ip
String
IP of the server targeted by the network test.

Metrics

Cloud & Enterprise Agents Test Data

Http Server

Key
Data Type
Description
http.metrics.availability
Float (percentage)
Calculated depending on the errors reported during the test. In case there is any error, the availability is 0, otherwise 100%.
http.metrics.throughput
Long (bytes/second)
Throughput of test in bytes/second.
http.metrics.response.time
Long (milliseconds)
Total time it took to execute the request.

Agent-to-Server (Network)

Key
Data Type
Description
net.metrics.latency
Long (milliseconds)
The maximum round trip time for the packets sent to the target.
net.metrics.loss
Float (percentage)
Packet loss.
net.metrics.jitter
Long (milliseconds)
Standard deviation for the round trip times.

Agent-to-Agent (One Way)

Key
Data Type
Description
net.metrics.latency
Long (milliseconds)
The average latency for this data point.
net.metrics.loss
Float (percentage)
Packet loss.
net.metrics.jitter
Long (milliseconds)
The average jitter for this data point.

Agent-to-Agent (Two Way)

Key
Data Type
Description
net.metrics.latency
Long (milliseconds)
The average latency for this data point.
net.metrics.loss
Float (percentage)
The average loss for this data point.
net.metrics.jitter
Long (milliseconds)
The average jitter for this data point.

Web Transaction

Key
Data Type
Description
webtransaction.metrics.transaction.time
Long (milliseconds)
The time it took the transaction to complete successfully.
This metric is not exposed if there are errors.
webtransaction.metrics.completion
Float (percentage)
Percentage of completion of the transaction. 100% if the transaction completes successfully, 0% if there are errors.
webtransaction.metrics.errors
Long (count)
Determines whether there were errors or not. 1 if there’s an error processing the transaction, 0 if not.

DNS Server

Key
Data Type
Description
dnsserver.metrics.availability
Float (percentage)
Calculated depending on the errors reported during the test. In case there is any error, the availability is 0, otherwise 100%.
dnsserver.metrics.resolution.time
Long (milliseconds)
DNS resolve time.

DNSSEC

Key
Data Type
Description
dnssec.metrics.validity
Float (percentage)
Calculated depending on the errors reported during the test. In case there is any error, the validity is 0, otherwise 100%.

DNS Trace

Key
Data Type
Description
dnstrace.metrics.availability
Float (percentage)
Calculated depending on the errors reported during the test. In case there is any error, the validity is 0, otherwise 100%.
dnstrace.metrics.query.time
Long (milliseconds)
Final query time.

Page load

Key
Data Type
Description
pageload.metrics.completion
Float (percentage)
Calculated depending on the errors reported during the test. In case there is any error, the validity is 0, otherwise 100%.
pageload.metrics.time
Long (milliseconds)
Time to completely load the page.

FTP Server

Key
Data Type
Description
ftp.metrics.availability
Float (percentage)
Calculated depending on the errors reported during the test. In case there is any error, the availability is 0, otherwise 100%.
ftp.metrics.throughput
Long (bytes/second)
Throughput of test in bytes/second.
ftp.metrics.response.time
Long (milliseconds)
Total time it took to get the first byte while executing the request.

SIP Server

Key
Data Type
Description
sip.metrics.availability
Float (percentage)
Calculated depending on the errors reported during the test. In case there is any error, the availability is 0, otherwise 100%.
sip.metrics.response.time
Long (milliseconds)
Total time it took to get the first byte while executing the request.
sip.metrics.total.time
Long (milliseconds)
Total time it took until the last response was received.

RTP Stream

Key
Data Type
Description
rtp.metrics.mos
Float (score)
Mean opinion score (MOS). A measurement of perceived voice quality, ranging from 1 to 5. A MOS of 5 indicates excellent voice call quality, while a MOS of 1 indicates poor voice call quality.
rtp.metrics.loss
Float (percentage)
Percentage of frames lost computed from lost frames count and total frames.
rtp.metrics.discards
Float (percentage)
Percentage of frames discarded computed from discarded frames count and total frames.
rtp.metrics.latency
Long (milliseconds)
Total time it took for the test round execution.

Endpoint Test Data

Http Server

Key
Data Type
Description
http.metrics.availability
Float (percentage)
Calculated depending on the errors reported during the test. In case there is any error, the availability is 0, otherwise 100%.
http.metrics.throughput
Long (bytes/second)
Throughput of test in bytes/second.
http.metrics.response.time
Long (milliseconds)
Time to first byte to execute the request.

Agent-to-Server (Network)

Key
Data Type
Description
net.metrics.latency
Long (milliseconds)
The maximum round trip time for the packets sent to the target.
net.metrics.loss
Float (percentage)
Packet loss.
net.metrics.jitter
Long (milliseconds)
Standard deviation for the round trip times.