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.
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 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.
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 |
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. |
Cache Hit Ratio cache_hit_percentage |
Indicates the percentage of cacheable requests that were served directly from cache to the requester. |
Cache Misses cache_miss |
Indicates the total number of requests that were served from an origin server |
Cache Miss Ratio cache_miss_percentage |
Indicates the percentage of requests that were served from an origin server |
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:
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. |
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:
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. |
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. |
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. |
TCP_EXPIRED_MISS tcp_expired_miss |
Indicates the number of requests that result in a newer version of an expired cached asset being served. |
TCP_HIT tcp_hit |
Indicates the number of requests served directly from the POP to the client. |
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. |
TCP_PARTIAL_HIT tcp_partial_hit |
Indicates the number of requests that resulted in a partially cached asset. |
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. |
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. |
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:
|
Country Code country_code |
Identifies requests by country code. |
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, |
IP Version ip_version |
Indicates the client's IP version number. Valid values are:
|
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:
|
Platform platform |
Identifies requests by delivery platform. Valid values are:
|
POP pop |
Identifies the POP that handled the client's request by its three-letter abbreviation. |
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:
Syntax: |
TLS Version 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. |
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. |