Skip to main content

Client Reports

Client Reports are complex objects that are specific to the technology that was used to measure the data.

We provide them so you can dig deeper into the data and analyze it in more detail.

Each Client Report contains:

  • metadata (e.g., the type and timestamp) common to all Client Reports
  • the actual data that was measured by the client

Normally, each measured subject has its own type of Client Report. For example:

  • A video study with subject youtube has a YoutubeClientReport
  • A network study with subject dns has a DnsClientReport
  • … and so on

However, there are also some generic Client Reports that can be used for multiple services:

  • Each video study has a P1203ClientReport which contains information about the video quality and a PerformanceClientReport which contains information about the performance of the playback.

Finally, some services could have multiple types of Client Reports (e.g., YouTube has one Client Report for its Stats for Nerds and one for its startup values). In the latter case, the data_type attribute may identify the specific type of the Client Report.

Example​

Here is are two example Client Reports, both for a video measurement (as identified by the measurement_id):

We provide this one for every video measurement. This corresponds to the input format of the P.1203 video QoE model. It allows you to get a good overview of what happened during a streaming session.

{
"id": 43009,
"measurement_id": 874,
"type": "P1203ClientReport",
"data_type": "object",
"created_at": "2023-02-11T13:42:58.510Z",
"updated_at": "2023-02-11T13:42:58.510Z",
"client_time": "2023-02-11T13:42:54.875Z",
"client_time_skewed": "2023-02-11T13:42:54.878Z",
"data": {
"I11": {
"segments": [
{
"codec": "opus",
"start": 0,
"bitrate": 125.36497312878555,
"duration": 0.6666666666666666
},
{
"codec": "opus",
"start": 0.6666666666666666,
"bitrate": 125.36497312878555,
"duration": 19.333333333333332
},
{
"codec": "opus",
"start": 20,
"bitrate": 127.71297482399984,
"duration": 20.333333333333332
},
{
"codec": "opus",
"start": 40.333333333333336,
"bitrate": 133.1045843559189,
"duration": 19
}
],
"streamId": 1
},
"I13": {
"segments": [
{
"fps": 25,
"codec": "vp9",
"start": 0,
"bitrate": 296.51000006291014,
"duration": 0.6666666666666666,
"resolution": "640x360"
},
{
"fps": 29.666666666666668,
"codec": "vp9",
"start": 0.6666666666666666,
"bitrate": 296.51000006291014,
"duration": 19.333333333333332,
"resolution": "854x480"
},
{
"fps": 51,
"codec": "vp9",
"start": 20,
"bitrate": 2516.2002482479243,
"duration": 20.333333333333332,
"resolution": "1920x1080"
},
{
"fps": 61,
"codec": "vp9",
"start": 40.333333333333336,
"bitrate": 2401.3066847336336,
"duration": 19,
"resolution": "1920x1080"
}
],
"streamId": 1
},
"I23": {
"pauses": [
[
0.513657,
0.068
],
[
0.591163,
0.035
],
[
0.674196,
0.05
],
[
0.702526,
0.009
],
[
0.768459,
0.003
]
],
"stalling": [
[
0,
0.901
]
],
"streamId": 1
},
"IGen": {
"device": "pc",
"displaySize": "1920x1080",
"viewingDistance": "150cm"
}
}
}
  1. This is a P1203ClientReport data type (see below for its definition).

Properties​

Common Properties​

General attributes for a client report.

PropertyTypeDescription
clientTimestring, or numberThe time at which the report was created
clientTimeSkewedstring, or number (optional)The time at which the report was created, adjusted in case of client skew
dataobject (no predefined properties)The actual client report data
dataTypearray of stringThe type of data (if not explicitly defined, simply 'object')
typearray of stringThe type of client report

Data Properties​

ByteCountClientReport Data​

A report for storing byte counts for a given measurement session.

PropertyTypeDescription
byteCountsarray of [unknown, number]The byte counts, as a tuple of timestamp and bytes
throughputStatisticsThroughputStatistics (optional)Throughput statistics for a measurement, derived from the raw network requests. Two views are provided because they answer different questions and neither one on its own is "the link rate": - aggregate is computed from the per-second byte counts and therefore sums all connections that were active at the same time. This is the closest thing to what the network link actually delivered. - perRequest is computed from individual requests. It systematically understates the link whenever several requests are in flight, since each one only gets a share of it, but it does describe how individual segments and CDNs behaved.
ThroughputStatistics​

Throughput statistics for a measurement, derived from the raw network requests.

Two views are provided because they answer different questions and neither one on its own is "the link rate":

  • aggregate is computed from the per-second byte counts and therefore sums all connections that were active at the same time. This is the closest thing to what the network link actually delivered.
  • perRequest is computed from individual requests. It systematically understates the link whenever several requests are in flight, since each one only gets a share of it, but it does describe how individual segments and CDNs behaved.
PropertyTypeDescription
aggregateThroughputSummaryDescriptive statistics over a set of throughput samples. All values are in bit/s. These are deliberately summary statistics rather than the raw samples: the raw per-request data is orders of magnitude larger and would have to be stored and cleaned up server-side, while the summary answers the questions customers actually ask ("how fast was the link", "was one CDN slower than another").
binDurationMsnumberThe width of one bin of the byteCounts series in milliseconds (e.g. 1000 for one second)
perHostarray of PerHostThroughputStatistics (optional)Per-host breakdown of the per-request throughput, if it could be computed
perRequestPerRequestThroughputStatisticsThroughput statistics derived from individual network requests. Very small or very short requests are excluded, because their duration is dominated by round-trip latency rather than by the available data rate, which yields wildly unrealistic values. The thresholds that were actually applied are part of this object so the numbers stay interpretable later on.
totalBytesnumberThe total number of bytes transferred over the whole measurement
PerHostThroughputStatistics​

Per-request throughput statistics for a single host.

This is an array entry rather than a map keyed by hostname on purpose. A hostname used as an object key would be destroyed by the automatic snake-casing that the API request handling applies to request bodies (nrodlzdf-a.akamaihd.net becomes nrodlzdf_a_akamaihd_net, irreversibly). As a value it is left untouched. It also keeps the door open to indexing this as an Elasticsearch nested field later, which a hostname-keyed map cannot support without a mapping explosion.

PropertyTypeDescription
bytesnumberThe total number of bytes transferred from this host
countnumberThe number of requests that passed the thresholds and were included
hostnamestringThe hostname the requests were served from
maxnumberThe highest throughput sample
meannumberThe arithmetic mean throughput
mediannumberThe median (50th percentile) throughput
minnumberThe lowest throughput sample
p95numberThe 95th percentile throughput
stdDevnumberThe standard deviation of the throughput samples
PerRequestThroughputStatistics​

Throughput statistics derived from individual network requests.

Very small or very short requests are excluded, because their duration is dominated by round-trip latency rather than by the available data rate, which yields wildly unrealistic values. The thresholds that were actually applied are part of this object so the numbers stay interpretable later on.

PropertyTypeDescription
countnumberThe number of requests that passed the thresholds and were included
maxnumberThe highest throughput sample
meannumberThe arithmetic mean throughput
mediannumberThe median (50th percentile) throughput
minnumberThe lowest throughput sample
minBytesnumberThe minimum transferred size in bytes a request needed to be included
minDurationMsnumberThe minimum download duration in milliseconds a request needed to be included
p95numberThe 95th percentile throughput
stdDevnumberThe standard deviation of the throughput samples
ThroughputSummary​

Descriptive statistics over a set of throughput samples. All values are in bit/s.

These are deliberately summary statistics rather than the raw samples: the raw per-request data is orders of magnitude larger and would have to be stored and cleaned up server-side, while the summary answers the questions customers actually ask ("how fast was the link", "was one CDN slower than another").

PropertyTypeDescription
maxnumberThe highest throughput sample
meannumberThe arithmetic mean throughput
mediannumberThe median (50th percentile) throughput
minnumberThe lowest throughput sample
p95numberThe 95th percentile throughput
stdDevnumberThe standard deviation of the throughput samples

DnsClientReport Data​

A report for dig-based DNS measurements.

PropertyTypeDescription
answerIpstringThe resolved IP for the host, as returned by the DNS server (may be IPv4 or IPv6)
avgQueryTimenumberAverage query time in microseconds
hoststringThe host that was queried (multiple client reports will be used for multiple hosts)
individualQueryTimesarray of numberIndividual query times in microseconds
maxQueryTimenumberThe maximum query time in microseconds
nameserverstringThe used nameserver for this request, may be empty if useGetAddrInfo was used for the study

HttpProberClientReport Data​

A report for HTTP prober measurements containing results for a single URL being probed.

PropertyTypeDescription
abortedAtstring, or nullISO datetime when testing was aborted, or null if not aborted
abortedReasonstring (optional)Reason for aborting, if applicable
byteRangeByteRangeTestResult (optional)Results for byte range request tests
enabledTestsarray of stringList of test types that were enabled for this URL
errorRateErrorRateTestResult (optional)Results for error rate tests
finishedAtstringISO datetime when testing finished
httpComplianceHttpComplianceTestResult (optional)Results for HTTP compliance tests
protocolProtocolTestResult (optional)Results for protocol tests
startedAtstringISO datetime when testing started
urlstringURL that was tested
userAgentarray of UserAgentTestResult (optional)User agent test results (one per user agent tested)
ByteRangeTestResult​

Results for byte range request tests

PropertyTypeDescription
clientErrorRequestsnumberNumber of client error responses (4xx status codes)
failedRequestsnumberNumber of requests that failed due to network errors
fullContentRequestsnumberNumber of full content responses (200)
otherStatusRequestsnumberNumber of responses with other status codes
partialContentRequestsnumberNumber of successful partial content requests (206)
requestsarray of ByteRangeRequestResultIndividual request results for detailed analysis
responseTimeAvgnumberAverage response time in milliseconds
responseTimeMaxnumberMaximum response time in milliseconds
responseTimeMediannumberMedian response time in milliseconds
responseTimeMinnumberMinimum response time in milliseconds
serverErrorRequestsnumberNumber of server error responses (5xx status codes)
totalRequestsnumberTotal number of requests made
totalTimenumberTotal time taken for all requests in milliseconds
ErrorRateTestResult​

Results for error rate tests

PropertyTypeDescription
cacheHitsnumberNumber of cache hits detected from X-Cache header
cacheMissesnumberNumber of cache misses detected from X-Cache header
clientErrorRequestsnumberNumber of client error responses (4xx status codes)
errorRatenumberServer error rate as percentage (serverErrorRequests / totalRequests * 100)
failedRequestsnumberNumber of requests that failed due to network errors
otherStatusRequestsnumberNumber of responses with other status codes (1xx, 3xx)
serverErrorRequestsnumberNumber of server error responses (5xx status codes)
successRequestsnumberNumber of successful requests (2xx status codes)
totalRequestsnumberTotal number of requests made
totalTimenumberTotal time taken for all requests in milliseconds
HttpComplianceTestResult​

Results for HTTP compliance tests

PropertyTypeDescription
errorstring (optional)Error message if request failed
headersobjectResponse headers as key-value pairs
statusCodenumberHTTP status code returned by the server
violationsarray of stringList of HTTP compliance violations found
ProtocolTestResult​

Results for protocol tests

PropertyTypeDescription
errorstring (optional)Error message if request failed
headersobjectResponse headers as key-value pairs
httpVersionstringHTTP version detected (1.1, 2.0)
isChunkedbooleanWhether the response uses chunked transfer encoding
protocolstringProtocol used for the request (http, http2)
redirectsarray of RedirectHop (optional)Redirect chain details when enabled
responseTimenumber (optional)Response time in milliseconds
statusCodenumberHTTP status code returned by the server
timingsRequestTimings (optional)HAR-like timing information for HTTP requests
transferEncodingstring (optional)Transfer-Encoding header value
UserAgentTestResult​

Results for user agent tests

PropertyTypeDescription
errorstring (optional)Error message if request failed
headersobjectResponse headers as key-value pairs
statusCodenumberHTTP status code returned by the server
userAgentstringUser-Agent string used for the request
ByteRangeRequestResult​

Result of a single byte range request

PropertyTypeDescription
contentLengthnumberNumber of bytes in the response body
contentRangestring (optional)Content-Range header value from server response
errorstring (optional)Error message if request failed
headersobjectResponse headers as key-value pairs
isPartialContentbooleanWhether the response is partial content (206) or full content (200)
rangeMaxnumberMaximum byte position of the requested range
rangeMinnumberMinimum byte position of the requested range
responseTimenumberTime taken for the request in milliseconds
statusCodenumberHTTP status code returned by the server
timingsobject with properties: connect, download, lookup, response, ... (optional)HAR-like timing information for HTTP requests
RedirectHop​

Redirect hop information for HTTP requests

PropertyTypeDescription
headersobjectResponse headers as key-value pairs
locationstring (optional)Location header value, if present
responseTimenumberTime taken for the redirect response in milliseconds
statusCodenumberHTTP status code for the redirect response
timingsobject with properties: connect, download, lookup, response, ... (optional)HAR-like timing information for HTTP requests
urlstringURL that returned the redirect response
RequestTimings​

HAR-like timing information for HTTP requests

PropertyTypeDescription
connectnumberTime taken to establish connection (ms)
downloadnumberTime taken to download response body (ms)
lookupnumberTime taken for DNS lookup (ms)
responsenumberTime taken to receive response (ms)
secureConnectnumberTime taken for TLS handshake (ms, 0 for HTTP)
startnumberStart time of the request (timestamp)
totalnumberTotal time taken for the request (ms)
uploadnumberTime taken to upload request (ms)

IcmpPingClientReport Data​

A report for ping-based ICMP measurements.

PropertyTypeDescription
avgRttnumberThe average round-trip time (in milliseconds)
dataBytesnumberThe number of bytes of data sent in each ping
hoststringThe host that was pinged
individualPingsarray of IndividualPingsIndividualPing (optional)An array of individual ping results
ipAddressstringThe IP address of the host that was pinged
maxRttnumberThe maximum round-trip time (in milliseconds)
minRttnumberThe minimum round-trip time (in milliseconds)
packetsLostnumberThe packet loss percentage (from 0 to 100)
packetsReceivednumberThe number of ping packets received
packetsTransmittednumberThe number of ping packets transmitted
stdevRttnumberThe standard deviation of round-trip times (in milliseconds)
IndividualPingsIndividualPing​
PropertyTypeDescription
dataBytesnumberThe number of bytes
icmpSeqnumberThe ICMP sequence number of the ping packet.
ipAddressstringThe IP address of the host that was pinged.
timenumberThe time (in milliseconds) that the ping was sent.
ttlnumberThe time-to-live value of the ping packet.

LighthouseClientReport Data​

A Lighthouse measurement result. Simplified type definition from the original Lighthouse project.

PropertyTypeDescription
auditsobjectAn object containing the results of the audits, keyed by the audits' id identifier.
categoriesobject (optional)The top-level categories, their overall scores, and member audits.
categoryGroupsobject (optional)Descriptions of the groups referenced by CategoryMembers.
configSettingsobjectThe config settings used for these results.
entitiesobject (optional)All the origins encountered during this Lighthouse run, and information about what web property (aka "entity") they belong to. Won't be present for snapshot mode.
environmentobjectInformation about the environment in which Lighthouse was run.
fetchTimestringThe ISO-8601 timestamp of when the results were generated.
finalDisplayedUrlstringThe URL displayed on the page after Lighthouse finishes.
finalUrlstring (optional)For historical reasons, this will always be the same as mainDocumentUrl.
fullPageScreenshotobject, or null (optional)Screenshot taken of the full page, with node rects referencing audit results. If there was an error with collection, this is null. If disabled via the disableFullPageScreenshot setting, this is undefined.
gatherModestringGather mode used to collect artifacts for this result.
i18nobject (optional)Strings for the report and the record of all formatted string locations in the LHR and their corresponding source values.
lighthouseVersionstringThe version of Lighthouse with which these results were generated.
mainDocumentUrlstring (optional)URL of the last document request during a Lighthouse navigation. Will be undefined in timespan/snapshot.
requestedUrlstring (optional)The URL that Lighthouse initially navigated to. Will be undefined in timespan/snapshot.
runWarningsarray of stringList of top-level warnings for this Lighthouse run.
runtimeErrorRuntimeError (optional)A top-level error message that, if present, indicates a serious enough problem that this Lighthouse result may need to be discarded.
stackPacksarray of object (optional)An array containing the result of all stack packs.
timingobject (optional)Execution timings for the Lighthouse run
userAgentstringThe User-Agent string of the browser used run Lighthouse for these results.
RuntimeError​

A top-level error message that, if present, indicates a serious enough problem that this Lighthouse result may need to be discarded.

PropertyTypeDescription
codestring
messagestring

LightweightVideoPlayerPerformanceClientReport Data​

Derived request-performance statistics for a Lightweight Video Player run.

Everything here is computed from the request event log, so the numbers describe HTTP delivery only: how many requests were made, how they ended, how long they took, how fast they ran, and how much of the session had a request in flight. Playback-derived quality statistics (startup delay, stalling ratio, quality switches) deliberately stay out of this report; they are computed downstream from the P.1203 client report.

Request kinds are manifest, index, initialization, audio, and video. Media requests are initialization, audio, and video requests. Media types are video, audio, and muxed (video and audio in one stream).

PropertyTypeDescription
bytesBytesDelivered response body sizes in bytes.
concurrencyConcurrencyHow busy the connection was over the measurement. busyMs is the union of the request intervals, so overlapping requests are counted once. The window is the measurement itself, not just the part of it with traffic, so utilization shows how much of the session the player spent transferring rather than waiting on a full buffer.
latencyMsLatencyMsRequest timing statistics in milliseconds. Each value is null if there were no samples.
requestsRequestsRequest outcome counts and the histograms that explain them.
throughputKbpsThroughputKbpsDelivery rates in kbit/s. Per-request rates cover media segments only: a manifest arrives in a packet or two, so dividing its size by a sub-millisecond download window says more about the timer than the network.
Bytes​

Delivered response body sizes in bytes.

PropertyTypeDescription
byKindobjectDelivered bytes per request kind.
byMediaTypeobjectDelivered bytes per media type. Media requests only, since a manifest request carries no media type.
deliveredTotalnumberTotal delivered bytes over all attempts.
perRequestLightweightVideoPlayerPerformanceStats, or nullDelivered body size per request attempt, in bytes. null if there were no attempts.
Concurrency​

How busy the connection was over the measurement.

busyMs is the union of the request intervals, so overlapping requests are counted once. The window is the measurement itself, not just the part of it with traffic, so utilization shows how much of the session the player spent transferring rather than waiting on a full buffer.

PropertyTypeDescription
busyMsnumberTime with at least one request in flight, in milliseconds.
idleMsnumberTime without any request in flight, in milliseconds.
maxInFlightnumberLargest number of requests in flight at the same time.
meanInFlightnumberAverage number of requests in flight over the measurement window.
utilizationnumberRatio of busyMs to windowMs, from 0 to 1.
windowMsnumberDuration of the measurement window in milliseconds.
LatencyMs​

Request timing statistics in milliseconds. Each value is null if there were no samples.

PropertyTypeDescription
downloadLightweightVideoPlayerPerformanceStats, or nullFirst byte to last byte.
mediaTtfbLightweightVideoPlayerPerformanceStats, or nullTime to first byte for media segment requests only, which excludes the manifest and playlist requests made before any connection was warm.
mediaTtfbByCacheStatusobject (optional)Time to first byte for media segment requests per CDN cache status (see requests.byCacheStatus for the values). Contains only cache statuses with at least one sample. Absent for older Lightweight Video Player versions.
totalLightweightVideoPlayerPerformanceStats, or nullRequest start to completion, including connect and TLS setup.
ttfbLightweightVideoPlayerPerformanceStats, or nullTime to first byte, over the attempts that received one.
Requests​

Request outcome counts and the histograms that explain them.

PropertyTypeDescription
abandonednumberRequests the ABR logic cancelled mid-download, which are not failures.
byCacheStatusobject (optional)Number of attempts per CDN cache status: hit, miss, stale, revalidated, bypass, expired, other (unrecognized value), or unknown (no recognized cache header). Media requests that received an HTTP response only. Absent for older Lightweight Video Player versions.
byEdgeobject (optional)Number of attempts per CDN edge server ID, as reported by the CDN in the response headers. Keeps the 10 edges with the most attempts and sums the rest under other. Attempts without an edge ID are not counted. Media requests that received an HTTP response only. Absent for older Lightweight Video Player versions.
byHttpVersionobjectNumber of attempts per HTTP version.
byKindobjectNumber of attempts per request kind.
byMediaTypeobjectNumber of attempts per media type. Media requests only, since a manifest request carries no media type.
byStatusobjectNumber of attempts per HTTP status code. Attempts without a response are not counted.
cacheHitRatenumber, or null (optional)Ratio of hit attempts to attempts with a known cache status (all except unknown), from 0 to 1. Media requests that received an HTTP response only. null if no attempt has a known cache status. Absent for older Lightweight Video Player versions.
failednumberAttempts that failed. See failureCategories for the reasons.
failureCategoriesobjectNumber of failed attempts per failure reason: timeout, network, httpstatus (error status code), redirect, invalidresponse, bodylimit (response larger than the configured limit), cancelled, or transport (other transport error).
failureRatenumberRatio of failed attempts to all attempts, from 0 to 1.
retriesnumberAttempts that repeated an earlier failed attempt.
retryRatenumberRatio of retries to all attempts, from 0 to 1.
succeedednumberAttempts that neither failed nor were abandoned.
totalnumberLogical attempts, so a retried request contributes one entry per try.
ThroughputKbps​

Delivery rates in kbit/s. Per-request rates cover media segments only: a manifest arrives in a packet or two, so dividing its size by a sub-millisecond download window says more about the timer than the network.

PropertyTypeDescription
activeMeannumberDelivered bits over the time at least one request was in flight.
coefficientOfVariationnumber, or nullStandard deviation over mean of mediaDownload, as a scale-free measure of how steady delivery was. null with too few samples.
mediaDownloadLightweightVideoPlayerPerformanceStats, or nullPer-segment rate over the download window, first byte to last. null if there were no samples.
mediaRequestLightweightVideoPlayerPerformanceStats, or nullPer-segment rate over the whole request, connect and time to first byte included. This is the view an ABR estimator works from. null if there were no samples.
sessionMeannumberDelivered bits over the whole measurement, idle gaps included.
LightweightVideoPlayerPerformanceStats​

Summary statistics over a set of samples. The unit is given by the field that holds the statistics.

PropertyTypeDescription
countnumberNumber of samples.
maxnumberLargest sample.
meannumberArithmetic mean of the samples.
mediannumberMedian of the samples.
minnumberSmallest sample.
p95number95th percentile of the samples (nearest-rank method).
stddevnumberStandard deviation of the samples.

NetflixClientReport Data​

Information gathered from the Netflix player debug window. Note that in practice some data may not be available.

PropertyTypeDescription
audioBitratenumberThe bitrate of the audio in kbps
audioCdnstring (optional)The domain of the CDN used to deliver the audio content, if the debug window shows it
audioCodecstringThe audio codec used by the stream in MIME format, e.g. "audio/mp4; codecs="mp4a.40.5" (he-aac)"
bufferingStatestringThe state of the player's internal buffering
bufferingVmafnumberThe VMAF score of the stream for buffering
corruptedFramesnumberThe number of corrupted frames in the stream
decodedFramesnumberThe number of decoded frames in the stream
droppedFramesnumberThe number of dropped frames in the stream
durationnumberThe duration of the stream in seconds
frameratenumberThe framerate of the stream in frames per second
playerStatestringThe state of the player
playingVmafnumberThe VMAF score of the stream for playing
positionnumberThe position of the player in the stream in seconds
renderingStatestringThe state of the player's rendering
resolutionstringThe resolution of the stream
throughputstring, or numberThe throughput as a string formatted as "69000 kbps" or similar, or a number in kbps (legacy)
totalFrameDelaynumber, or null (optional)The total frame delay of the stream, or null if the debug window does not show it
videoBitratenumberThe bitrate of the video in kbps
videoCdnstring (optional)The domain of the CDN used to deliver the video content, if the debug window shows it
videoCodecstringThe video codec used by the stream in MIME format, e.g. "video/mp4;codecs=vp09.00.11.08.02 (vp9)"

NetworkPerformanceClientReport Data​

This report contains global and domain-specific metrics based on a set of network requests and responses.

PropertyTypeDescription
domainPerformancearray of NetworkPerformanceDomainMetricsThe domain-specific metrics
firstRequestTimestringThe time of the first request in ISO 8601 format
globalMetricsNetworkPerformanceGlobalMetricsThe global metrics
parentDomainstringThe parent domain from which requests were made
totalRequestsnumberThe number of requests
NetworkPerformanceDomainMetrics​

Performance metrics for a specific domain

PropertyTypeDescription
averageResponseTimenumberThe average of the total time for each request, in seconds
contentTypeBreakdownobjectThe content type breakdown - how often each content type was requested
domainstringThe domain name
performanceProfilePerformanceProfileThe fastest and slowest request
totalEncodedDataLengthnumberTotal transferred size in bytes
totalRequestsnumberThe number of requests
NetworkPerformanceGlobalMetrics​

The global metrics

PropertyTypeDescription
averageRequestTimenumber
contentTypeDistributionobject
totalTransferSizenumber
PerformanceProfile​

The fastest and slowest request

PropertyTypeDescription
fastestRequestobject with properties: connectionReused, contentLength, contentType, contentTypeClassification, ... (optional)Performance entry for a single network request
slowestRequestobject with properties: connectionReused, contentLength, contentType, contentTypeClassification, ... (optional)Performance entry for a single network request

OoklaSpeedtestClientReport Data​

A report for Ookla Speedtest measurements made with the Ookla Speedtest CLI.

PropertyTypeDescription
downloadOoklaSpeedtestSingleResultA single speedtest result.
interfaceInterfaceNetwork interface information
ispstringInternet Service Provider
packetLossnumberPacket loss percentage
pingPingNetwork ping information
resultResultTest result information
serverServerServer information
timestampstringThe timestamp of the report in ISO 8601 format
typestringThe type of report, should be fixed to "result"
uploadOoklaSpeedtestSingleResultA single speedtest result.
Interface​

Network interface information

PropertyTypeDescription
externalIpstringExternal IP address
internalIpstringInternal IP address
isVpnbooleanWhether using a VPN
macAddrstringMAC address
namestringNetwork name
OoklaSpeedtestSingleResult​

A single speedtest result.

PropertyTypeDescription
bandwidthnumberThe speed in bytes per second
bytesnumberThe number of bytes transferred
elapsednumberThe time in milliseconds that this test took
latencyLatency (optional)Latency information for this channel
Ping​

Network ping information

PropertyTypeDescription
highnumber (optional)Upper bound latency in ms
jitternumberNetwork jitter
latencynumberNetwork latency in ms
lownumber (optional)Lower bound latency in ms
Result​

Test result information

PropertyTypeDescription
idstringUnique ID of the results
persistedbooleanWhether the result was persisted
urlstringA URL where to see the results
Server​

Server information

PropertyTypeDescription
countrystringServer country
hoststringServer hostname
idnumberServer ID
ipstringServer IP address
locationstringServer location
namestringServer name
portnumberServer port
Latency​

Latency information for this channel

PropertyTypeDescription
highnumberUpper bound latency in ms
iqmnumberInter-Quartile Mean
jitternumberJitter
lownumberLower bound latency in ms

P1203ClientReport Data​

P1203ClientReport is the same as P1203InputReport, but with additional options for the programmatic calculation.

PropertyTypeDescription
I11I11Audio segments information
I13I13Video segments information
I23I23Stalling, seeking and pause events
IGenIGenDevice and viewing conditions
O21array of number (optional)A list of input scores to use instead of audio segments for computing final score
O22array of number (optional)A list of input scores to use instead of video segments for computing final score
calculationSettingsPartial_P1203StandaloneOptsWithoutClasses (optional)Extra options for the calculation
IGen​

Device and viewing conditions

PropertyTypeDescription
devicestring (one of: mobile, pc)The type of device
displaySizestringThe display size in pixels, e.g. "1920x1080"
viewingDistancestringThe viewing distance in centimeters, e.g. "150cm", or viewing height, e.g. "3H"
I11​

Audio segments information

PropertyTypeDescription
segmentsarray of I11Segment
streamIdstring, or number (optional)
I13​

Video segments information

PropertyTypeDescription
segmentsarray of I13SegmentA list of video segments
streamIdstring, or number (optional)Optional stream ID
I23​

Stalling, seeking and pause events

PropertyTypeDescription
pausesarray of [number, number] — A pause event, consisting of position (media time) and duration, in seconds (optional)A list of pause events
seekingarray of [number, number] — A seeking event, consisting of position (media time) and target, in seconds (optional)A list of seeking events
stallingarray of [number, number] — A stalling event, consisting of position (media time) and duration, in secondsA list of stalling events
streamIdstring, or number (optional)
Partial_P1203StandaloneOptsWithoutClasses​

Extra options for the calculation

PropertyTypeDescription
amendment1App2boolean (optional)Enable the amendment 1 appendix 2 for bitstream-based/FR model O22 scores
amendment1Audiovisualboolean (optional)Enable the amendment 1 for low audiovisual quality
amendment1Stallingboolean (optional)Enable the amendment 1 for stalling
fastModeboolean (optional)Calculate the fast (but less accurate) mode
pastring (optional)The audio model to use
pqstring (optional)The integration model to use
pvstring (one of: P1203PvRetrained, P12043BitstreamMode0) (optional)The video model to use
verboseboolean (optional)Enable verbose logging
I11Segment​
PropertyTypeDescription
bitratenumber
codecstring (one of: aac, aaclc, ac3, heaac, ...)
durationnumber
representationstring (optional)
startnumber
I13Segment​
PropertyTypeDescription
bitratenumber
codecstring (one of: av1, h264, hevc, vp9)
displaySizestring (optional)
durationnumber
fpsnumber
representationstring (optional)
resolutionstring
startnumber

PerformanceClientReport Data​

A report for video playback performance.

PropertyTypeDescription
audioBufferTracearray of [number, number] (optional)The video player audio buffer size. Each entry is a tuple of media timestamp and size in seconds.
bufferTracearray of [number, number]The video player buffer size. Each entry is a tuple of media timestamp and size in seconds.
droppedVideoFramesnumberThe number of dropped video frames
latencyTracearray of [number, number]The video player latency (CDN-to-player). Each entry is a tuple of media timestamp and latency in seconds.
videoBufferTracearray of [number, number] (optional)The video player video buffer size. Each entry is a tuple of media timestamp and size in seconds.

TracerouteClientReport Data​

A report for traceroute-based measurements.

PropertyTypeDescription
firstHopFirstHop (optional)The first hop
hoststringThe host name of the target
individualHopsarray of IndividualHopsIndividualHop (optional)An array of individual hop results
ipAddressstringThe IP address of the target
lastHopLastHop (optional)The last host
maxHopsnumberMaximum number of hops used
numHopsnumber (optional)The final number of hops to the target
packetSizenumberBytes per packet
FirstHop​

The first hop

PropertyTypeDescription
asnsarray of number (optional)The AS numbers of the IP addresses (if AS lookup was enabled in the study)
hostnamesarray of stringThe hostname of the hop
ipAddressesarray of stringThe IP addresses of the hop
rttsarray of numberThe round-trip time (in milliseconds)
seqnumberThe sequence number of the hop
IndividualHopsIndividualHop​
PropertyTypeDescription
asnsarray of number (optional)The AS numbers of the IP addresses (if AS lookup was enabled in the study)
hostnamesarray of stringThe hostname of the hop
ipAddressesarray of stringThe IP addresses of the hop
rttsarray of numberThe round-trip time (in milliseconds)
seqnumberThe sequence number of the hop
LastHop​

The last host

PropertyTypeDescription
asnsarray of number (optional)The AS numbers of the IP addresses (if AS lookup was enabled in the study)
hostnamesarray of stringThe hostname of the hop
ipAddressesarray of stringThe IP addresses of the hop
rttsarray of numberThe round-trip time (in milliseconds)
seqnumberThe sequence number of the hop

WebrtcInternalsClientReport Data​

Data that can be extracted from the chrome://webrtc-internals page via download.

PropertyTypeDescription
PeerConnectionsobject
UserAgentstring
getUserMediaarray

YoutubeClientReport Data (startup_info)​

Values that decide the start format of a session, sent once per session. Only valid for YouTube at the moment.

PropertyTypeDescription
downlinknumber (optional)navigator.connection.downlink in Mbit/s at the first video request, if the browser reports it
initialByteratenumber (optional)Startup bandwidth estimate in bytes/s: the restored estimate, otherwise downlink × 65,536
playerStateRestoredbooleanWhether a bandwidth estimate from an earlier run was restored before the player started

YoutubeClientReport Data​

An object containing the YouTube Stats for Nerds window information.

PropertyTypeDescription
audioCodecMimestringThe audio codec MIME type, e.g. "opus"
audioItagnumberThe audio itag
bufferHealthnumberBuffer health in seconds
colorSpacestring (optional)The color space name, e.g. "bt709". Not always fetchable, e.g. in Safari or for live streams.
connectionSpeednumberThe connection speed in kbps
contentLoudnessnumber (optional)The content loudness. Not always fetchable, e.g. for live streams
currentFpsnumberThe current fps
currentResstringThe current resolution in "<width>x<height>"
framesDroppednumberThe number of dropped frames
framesTotalnumberThe total number of frames
liveLatencynumber (optional)Latency value in seconds, if the video is a YT live stream
liveModestring (optional)Additional information, if the video is a YT live sequence
mysteryTextstringWho knows what this might be?
networkActivitynumberThe current network activity in KB
normalizedVolumenumber, or nullThe normalized volume, optional
optimalFpsnumberThe optimal fps
optimalResstringThe optimal resolution in "<width>x<height>"
sCPNstringThe video title
timestampstring (optional)An ISO 8601 timestamp
videoCodecMimestringThe video codec NIME type, e.g. "av01.0.08M.08"
videoIdstringThe video ID
videoItagnumberThe video itag
viewportstringThe viewport size in "<width>x<height>"
viewportScalenumber (optional)The viewport scale
volumenumber, or nullThe volume, optional