Synthetic Metrics

Synthetic Metrics

Metrics

The following metrics are generated by Synthetic Monitoring tests.

Metrics starting with:

  • synthetics.test_runs come from all your Synthetic tests
  • datadog.estimated_usage.synthetics.* return relevant usage data from your Synthetic tests

Metrics starting with:

General metrics

synthetics.test_runs
(count)
The number of Synthetic test runs.
Shown as run
datadog.estimated_usage.synthetics.api_test_runs
(count)
Estimated usage for API tests.
Shown as run
datadog.estimated_usage.synthetics.browser_test_runs
(count)
Estimated usage for browser tests.
Shown as run

API tests

synthetics.api.response
(count)
The count of API responses we receive.
Shown as request

HTTP tests

synthetics.http.response.time
(gauge)
The overall time the request took to be processed.
Shown as millisecond
synthetics.http.response.size
(gauge)
The size of the response in bytes.
Shown as byte
synthetics.http.redirect.time
(gauge)
The time spent during redirections.
Shown as millisecond
synthetics.http.dns.time
(gauge)
The time spent resolving the DNS name of the last request.
Shown as millisecond
synthetics.http.connect.time
(gauge)
The time to establish the TCP connection to the server.
Shown as millisecond
synthetics.http.ssl.time
(gauge)
The duration of the TLS handshake. This metric does not appear if the last request is not over HTTPS.
Shown as millisecond
synthetics.http.send.time
(gauge)
The time to send the request.
Shown as millisecond
synthetics.http.firstbyte.time
(gauge)
The time spent waiting for the first byte of response to be received.
Shown as millisecond
synthetics.http.download.time
(gauge)
The time spent downloading the response.
Shown as millisecond
synthetics.http.response
(count)
The count of HTTP responses we receive.
Shown as request

SSL tests

synthetics.ssl.dns.time
(gauge)
The duration of the DNS lookup.
Shown as millisecond
synthetics.ssl.handshake.time
(gauge)
The duration of the TLS handshake.
Shown as millisecond
synthetics.ssl.response.time
(gauge)
The overall time the request took to be processed.
Shown as millisecond
synthetics.ssl.time_to_expiry
(gauge)
The remaining time before the SSL certificate expires.
Shown as minute
synthetics.ssl.response
(count)
The count of SSL responses we receive.
Shown as request

DNS tests

synthetics.dns.response.time
(gauge)
The overall time the request took to be processed.
Shown as millisecond

TCP tests

synthetics.tcp.response.time
(gauge)
The overall time the request took to be processed.
Shown as millisecond
synthetics.tcp.dns.time
(gauge)
The duration of the DNS lookup.
Shown as millisecond
synthetics.tcp.connect.time
(gauge)
The time to establish the TCP connection.
Shown as millisecond

ICMP tests

synthetics.icmp.hops
(gauge)
The number of hops associated with the traceroute execution.
Shown as hop
synthetics.icmp.packet_loss_percentage
(gauge)
The percentage of packet loss associated with the last ping.
Shown as percent
synthetics.icmp.latency_avg
(gauge)
The average latency across all pings.
Shown as millisecond
synthetics.icmp.latency_max
(gauge)
The maximum latency across all pings.
Shown as millisecond
synthetics.icmp.latency_min
(gauge)
The minimum latency across all pings.
Shown as millisecond
synthetics.icmp.latency_stddev
(gauge)
The standard deviation latency across all pings.
Shown as millisecond
synthetics.icmp.packets_received
(gauge)
The number of packets successfully received.
Shown as packet
synthetics.icmp.packets_sent
(gauge)
The number of packets sent.
Shown as packet

For more information on API test timings, read the guide on API Test Timings and Variations.

Browser tests

synthetics.browser.test_duration
(gauge)
The total time it took to execute the browser test.
Shown as millisecond
synthetics.browser.time_to_interactive
(gauge)
The time until a page can be interacted with. Calculated from the first page in a browser test.
Shown as millisecond
synthetics.browser.number_of_buckets
(count)
The number of buckets in a browser test. Every 25 steps in a browser test is a single bucket.
synthetics.browser.step.largest_contentful_paint
(gauge)
The Largest Contentful Paint (core web vital) in a browser test step.
Shown as millisecond
synthetics.browser.step.cumulative_layout_shift
(gauge)
The Cumulative Layout Shift (core web vital) in a browser test step.
synthetics.browser.step.duration
(gauge)
The total time it took to execute a browser test step.
Shown as millisecond

Further Reading

Additional helpful documentation, links, and articles: