Metrics and Dimensions

Metrics and dimensions determine the set of statistics that will be included within a report. Additionally, you may filter a report by a specific dimension.

The Time dimension is automatically included when a time interval is set via the Granularity option.

Metrics

A metric measures the rate, an amount, or the total number of times that a particular attribute occurred over a given record. Measurements are performed on requests that meet the following conditions:

Definitions for each metric are provided below.

Metric Description

2xx Rate

status_2xx_percentage

Indicates the percentage of requests that resulted in a 2xx response code.

2xx Responses

status_2xx

Indicates the total number of requests that resulted in a 2xx response code.

3xx Rate

status_3xx_percentage

Indicates the percentage of requests that resulted in a 3xx response code.

3xx Responses

status_3xx

Indicates the total number of requests that resulted in a 3xx response code.

4xx Error Rate

status_4xx_percentage

Indicates the percentage of requests that resulted in a 4xx response code.

4xx Responses

status_4xx

Indicates the total number of requests that resulted in a 4xx response code.

5xx Error Rate

status_5xx_percentage

Indicates the percentage of requests that resulted in a 5xx response code.

5xx Responses

status_5xx

Indicates the total number of requests that resulted in a 5xx response code.

Bytes In

bytes_in

Indicates the total number of bytes read.

Cache Hits

cache_hit

Indicates the total number of cacheable requests that were served directly from cache to the requester.

Learn more.

Cache Hit Ratio

cache_hit_percentage

Indicates the percentage of cacheable requests that were served directly from cache to the requester.

Learn more.

Cache Misses

cache_miss

Indicates the total number of requests that were served from an origin server or an Origin Shield server.

Learn more.

Cache Miss Ratio

cache_miss_percentage

Indicates the percentage of requests that were served from an origin server or an Origin Shield server.

Learn more.

Completed Downloads

completed_downloads

Indicates the total number of times that assets were downloaded completely to a client. In calculating whether a request is a "complete download," we take the following into consideration:

  • A request must return a 200 OK or a 206 Partial Content status code.
  • Byte-Range Requests: We will:

    • Ensure that they provide full coverage for the requested asset.
    • Sum up the total data transferred for all requests for the same asset that originate from the same client. The amount of data transferred must be equal to or greater than the file size.

If compression has been enabled on your account, then the recorded file size may be larger than the total bytes transferred. This may lead to inaccurate data.

CONFIG_NOCACHE

config_nocache

Indicates the number of requests that were not cached due to the customer's CDN configuration. The payload for each of these requests was served directly from the origin server.

Learn more.

Data Transferred

bytes_out

Indicates the total amount of data transferred to clients.

Define the units for this metric upon its selection.

Download Attempts

download_attempts

Indicates the total number of unique requests. This statistic is calculated by summing the following types of requests:

  • All requests that result in a 200 OK.
  • All byte-range requests for the start of an asset (e.g., bytes=0-499) that result in a 206 Partial Content.

This field does not take into account whether the client downloaded the entire asset.

File Size

file_size

Indicates the total size, in bytes, for all assets.

File size is determined by the request's payload and does not include header data.

Requests

request_count

Indicates the total number of requests that meet the report's criteria.

A request occurs whenever CDN content is requested, regardless of the status code returned to the client.

Total Time

total_time

Indicates the average amount of time, in milliseconds, that it took our CDN to serve an asset to a client.

Transfer Rate

transfer_rate

Indicates the sum of the rate at which edge servers delivered content to HTTP clients (e.g., web browsers).

Define the units for this metric upon its selection.

TCP_CLIENT_REFRESH_MISS

tcp_client_refresh_miss

Indicates the number of requests issued by an HTTP client (e.g., browser) that forced an edge server to retrieve a new version of a stale asset from the origin server.

Learn more.

TCP_EXPIRED_HIT

tcp_expired_hit

Indicates the number of requests for an asset with an expired time to live (TTL) that was served directly from the POP to the client.

Learn more.

TCP_EXPIRED_MISS

tcp_expired_miss

Indicates the number of requests that result in a newer version of an expired cached asset being served.

Learn more.

TCP_HIT

tcp_hit

Indicates the number of requests served directly from the POP to the client.

Learn more.

TCP_MEM_HIT

tcp_mem_hit

Reserved for future use.

TCP_MISS

tcp_miss

Indicates the number of requests for content that was not cached on the POP closest to the client.

Learn more.

TCP_PARTIAL_HIT

tcp_partial_hit

Indicates the number of requests that resulted in a partially cached asset.

Learn more.

TCP_PARTIAL_MISS

tcp_partial_miss

Reserved for future use.

UNCACHEABLE

uncacheable

Indicates the number of requests that could not be cached due to Cache-Control or Expires headers. The payload for these requests was served directly from the origin server.

Learn more.

Dimensions

A dimension describes an attribute of a request and is typically used to correlate the desired set of requests with metrics.

Filter a report by selecting a dimension under the Filter option and then determining the condition that requests must satisfy in order to be included in the report.

Dimension Description

AS Org

client_as_org

Identifies requests by the organization corresponding to the client's ASN.

ASN

client_asn

Indicates the Autonomous System Number (ASN) associated with the client's IP address.

Cache Status

cache_status

Identifies requests by cache status code.

Learn more.

City

client_city

Indicates the city from which the request originated.

Content Type

content_type

Indicates the media type (aka content type) for the body of the requested content.

Example:

image\/png

Continent Code

continent_code

Identifies requests by one of the following continent codes:

  • AF: Africa
  • AN: Antarctica
  • AS: Asia
  • EU: Europe
  • NA: North America
  • OC: Oceania
  • SA: South America

Country Code

country_code

Identifies requests by country code.

Learn more.

Edge CNAME

host

Identifies requests by edge CNAME.

HTTP Method

method

Identifies requests by HTTP method (e.g., GET, HEAD, and POST).

HTTP Status Code

status

Identifies requests by the HTTP status code (e.g., 200, 206, 301, etc.) for the response generated by an origin server, origin shield server, ADN gateway server, or an edge server.

IP Version

ip_version

Indicates the client's IP version number. Valid values are:

  • INET: IPv4
  • INET6: IPv6

ISP

client_isp

Indicates the Internet Service Provider (ISP) associated with the client's IP address.

Leaf Directory

leaf_directory

Identifies requests by the CDN URL pathRefers to the portion of the CDN URL that appears after the CDN hostname. It identifies a CDN or customer origin and provides the relative path to a specific folder or asset. to the parent directory of the requested content.

Example:

Sample request:

https://wpc.0001.omegacdn.net/800001/marketing/events/widgets/logo.png

The leaf directory for the above request is:

/800001/marketing/events/widgets

Origin

origin

Identifies requests by the origin server on which the requested content resides.

Valid values are:

  • EdgeCast: CDN storage
  • Directory Name: Customer origin traffic is identified by the customer origin's Directory Name option.

Platform

platform

Identifies requests by delivery platform.

Valid values are:

  • cache: HTTP Large
  • wac: HTTP Small
  • adn: ADN

POP

pop

Identifies the POP that handled the client's request by its three-letter abbreviation.

View a list of POPs.

Proxy Type

proxy_type

Indicates the type of server to which an edge server forwarded a request. Valid values are:

Region

client_region

Indicates the geographical region (e.g., state or province) from which the request originated.

Root Directory

root_directory

Identifies requests by the directory that immediately follows the content access pointThis URL segment of a CDN URL identifies where the request should be directed. This relative path starts directly after the CDN hostname. The proper syntax for a content access point is "/yyAN," where "yy" stands for the origin identifier and "AN" stands for a customer account number. A content access point for a customer origin also includes a directory that identifies it..

Example:

Sample request:

https://wpc.0001.omegacdn.net/800001/marketing/events/widgets/logo.png

The root directory for the above request is:

events

Time

date_time

Identifies requests by the time interval during which the request was initiated.

Key information:

  • This field identifies start time for the current record's time interval.
  • The length of this time interval is determined by the Granularity option.
  • This field is automatically included when a time interval is defined via the Granularity option.

Syntax:

TLS Version

client_tls_version

Identifies QUIC requests or the version of the TLS protocol through which the client securely communicated with our network. Valid values are:

TLSvVersion | QUIC

A blank value is reported for requests that do not use QUIC or TLS.

Traffic Type

traffic_type

Describes the type of traffic corresponding to the request. Valid values are:

URI Scheme

scheme

Identifies requests by URI scheme (i.e., http or https).

URL

path

Identifies requests by the CDN URL pathRefers to the portion of the CDN URL that appears after the CDN hostname. It identifies a CDN or customer origin and provides the relative path to a specific folder or asset. of the requested content.

Example:

Sample request:

https://wpc.0001.omegacdn.net/800001/marketing/events/widgets/logo.png

The CDN URL path for the above request is:

/800001/marketing/events/widgets/logo.png

User Agent

user_agent

Identifies request by user agent as determined by the User-Agent request header.