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, or monitor information for BGP tests.

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

BGP

  • bgp.metrics.path.changes (number)

  • bgp.metrics.reachability (percentage)

  • bgp.metrics.updates (number)

  • monitor.id

  • monitor.name

  • monitor.location

  • prefix

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:

Resource Attributes

Key

Data Type

Description

thousandeyes.stream.id

String (UUID)

ID of the integration used to route the data point to the external service.

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

BGP

Key

Data Type

Description

bgp.metrics.path.changes

Int64

Number of path changes observed for the given prefix by this monitor.

bgp.metrics.reachability

Float (percentage)

Percentage reachability.

bgp.metrics.updates

Int64

Number of updates observed for the given prefix by this monitor.

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.

PreviousConfiguring ThousandEyes for OpenTelemetryNextOpenTelemetry Collector Data Format

Last updated