Metrics and Dimensions

Applies To:

HTTP LargeThis platform has been optimized to cache and deliver static content (e.g., HTML, CSS, JavaScript, ISO, multimedia, and software downloads, etc.) over HTTP or HTTPS.

HTTP SmallLegacy. If you are currently serving traffic over this platform, then you may continue to do so. However, we recommend that you serve your traffic over our more robust HTTP Large platform.

ADNThe Application Delivery Network platform has been optimized to deliver dynamic content (e.g., login credentials, account information, etc.) over HTTP or HTTPS. Typically, user-specific and database-driven content are served over this platform.

Report BuilderThis feature generates and delivers custom reports.

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:

Time Period: The request was initiated between the report's start and end date (UTC).
Time Interval: The request was initiated during the current record's time interval (i.e., granularity).

If a time interval was not defined, then each record covers the report's entire time period.
Delivery Platform: The request corresponds to a delivery platform that was enabled on the report.
Filter: The request meets any filter requirements that have been applied to the report.
Dimensions: If the report contains one or more dimensions, then the request must satisfy all dimension criteria defined within the current record.

For example, if the current record contains Country Code set to US and Edge CNAME set to cdn.example.com, then metrics for the current record will only measure requests to cdn.example.com that originate from the United States.

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.

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.edgecastcdn.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: NONE: Indicates that the request was served directly from the edge of our network and therefore it was not proxied to another server. MIDGRESS: Indicates that an edge server proxied the request to a different CDN server. Examples: The request was proxied to an Origin Shield or ADN Gateway server. The request was proxied to a peer edge server due to hotfilingRefers to the process of loading an asset cached on an edge server to multiple edge servers within the same POP. Hotfiling takes place when there is a sudden spike in traffic for a specific asset. It is designed to reduce the number of requests that are forwarded to an origin server.. ORIGIN: Indicates that the request was proxied to either of the following servers: An external web server associated with a customer origin configuration. A CDN storage server.
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.edgecastcdn.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: MRepresents a one or two digit month./DRepresents a one or two digit day./YYYYRepresents a four digit year. hRepresents a one or two digit hour.:mmRepresents minutes using two digits.:ssRepresents seconds using two digits. am\|pm
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: STANDARD: Indicates that an edge server served the request either from cache or by requesting it from the origin server. MIDGRESS: Indicates that a different CDN server served the response to an edge server. Examples: An Origin Shield or an ADN Gateway server served the request to an edge server either from cache or by requesting it from the origin server. The request was spawned from custom logic defined within a Lua script. Contact our Professional Services team for more information. A peer edge server served the request to an edge server due to hotfilingRefers to the process of loading an asset cached on an edge server to multiple edge servers within the same POP. Hotfiling takes place when there is a sudden spike in traffic for a specific asset. It is designed to reduce the number of requests that are forwarded to an origin server..
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.edgecastcdn.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.

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.edgecastcdn.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:

NONE: Indicates that the request was served directly from the edge of our network and therefore it was not proxied to another server.
MIDGRESS: Indicates that an edge server proxied the request to a different CDN server.

Examples:
- The request was proxied to an Origin Shield or ADN Gateway server.
- The request was proxied to a peer edge server due to hotfilingRefers to the process of loading an asset cached on an edge server to multiple edge servers within the same POP. Hotfiling takes place when there is a sudden spike in traffic for a specific asset. It is designed to reduce the number of requests that are forwarded to an origin server..
ORIGIN: Indicates that the request was proxied to either of the following servers:
- An external web server associated with a customer origin configuration.
- A CDN storage server.

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.edgecastcdn.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:

// :: am|pm

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:

STANDARD: Indicates that an edge server served the request either from cache or by requesting it from the origin server.
MIDGRESS: Indicates that a different CDN server served the response to an edge server.

Examples:
- An Origin Shield or an ADN Gateway server served the request to an edge server either from cache or by requesting it from the origin server.
- The request was spawned from custom logic defined within a Lua script.
  
  Contact our Professional Services team for more information.
- A peer edge server served the request to an edge server due to hotfilingRefers to the process of loading an asset cached on an edge server to multiple edge servers within the same POP. Hotfiling takes place when there is a sudden spike in traffic for a specific asset. It is designed to reduce the number of requests that are forwarded to an origin server..

URI Scheme

scheme

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

URL

path

Example:

Sample request:

https://wpc.0001.edgecastcdn.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.