Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
CDN Statistics

Get CDN metrics

post/cdn/advanced/v1/metrics

Request body

metricsstring[] required

Possible values:

  • edge_bandwidth - Bandwidth from client to CDN (bit/s.)
  • edge_requests - Number of requests per interval (requests/s.)
  • edge_requests_total - Total number of requests per interval.
  • edge_status_1xx - Number of 1xx status codes from edge.
  • edge_status_200 - Number of 200 status codes from edge.
  • edge_status_204 - Number of 204 status codes from edge.
  • edge_status_206 - Number of 206 status codes from edge.
  • edge_status_2xx - Number of 2xx status codes from edge.
  • edge_status_301 - Number of 301 status codes from edge.
  • edge_status_302 - Number of 302 status codes from edge.
  • edge_status_304 - Number of 304 status codes from edge.
  • edge_status_3xx - Number of 3xx status codes from edge.
  • edge_status_400 - Number of 400 status codes from edge.
  • edge_status_401 - Number of 401 status codes from edge.
  • edge_status_403 - Number of 403 status codes from edge.
  • edge_status_404 - Number of 404 status codes from edge.
  • edge_status_416 - Number of 416 status codes from edge.
  • edge_status_429 - Number of 429 status codes from edge.
  • edge_status_4xx - Number of 4xx status codes from edge.
  • edge_status_500 - Number of 500 status codes from edge.
  • edge_status_501 - Number of 501 status codes from edge.
  • edge_status_502 - Number of 502 status codes from edge.
  • edge_status_503 - Number of 503 status codes from edge.
  • edge_status_504 - Number of 504 status codes from edge.
  • edge_status_505 - Number of 505 status codes from edge.
  • edge_status_5xx - Number of 5xx status codes from edge.
  • edge_hit_ratio - Percent of cache hits (0.0 - 1.0).
  • edge_hit_bytes - Number of bytes sent back when cache hits.
  • origin_bandwidth - Bandwidth from CDN to Origin (bit/s.)
  • origin_requests - Number of requests per interval (requests/s.)
  • origin_status_1xx - Number of 1xx status from origin.
  • origin_status_200 - Number of 200 status from origin.
  • origin_status_204 - Number of 204 status from origin.
  • origin_status_206 - Number of 206 status from origin.
  • origin_status_2xx - Number of 2xx status from origin.
  • origin_status_301 - Number of 301 status from origin.
  • origin_status_302 - Number of 302 status from origin.
  • origin_status_304 - Number of 304 status from origin.
  • origin_status_3xx - Number of 3xx status from origin.
  • origin_status_400 - Number of 400 status from origin.
  • origin_status_401 - Number of 401 status from origin.
  • origin_status_403 - Number of 403 status from origin.
  • origin_status_404 - Number of 404 status from origin.
  • origin_status_416 - Number of 416 status from origin.
  • origin_status_429 - Number of 426 status from origin.
  • origin_status_4xx - Number of 4xx status from origin.
  • origin_status_500 - Number of 500 status from origin.
  • origin_status_501 - Number of 501 status from origin.
  • origin_status_502 - Number of 502 status from origin.
  • origin_status_503 - Number of 503 status from origin.
  • origin_status_504 - Number of 504 status from origin.
  • origin_status_505 - Number of 505 status from origin.
  • origin_status_5xx - Number of 5xx status from origin.
  • edge_download_speed - Download speed from edge in KB/s (includes only requests that status was in the range [200, 300].)
  • origin_download_speed - Download speed from origin in KB/s (includes only requests that status was in the range [200, 300].)
fromstring required

Beginning period to fetch metrics (ISO 8601/RFC 3339 format, UTC.)

Examples:

  • 2021-06-14T00:00:00Z
  • 2021-06-14T00:00:00.000Z

The total number of points, which is determined as the difference between "from" and "to" divided by "granularity", cannot exceed 1440. Exception: "speed" metrics are limited to 72 points.

tostring required

Specifies ending period to fetch metrics (ISO 8601/RFC 3339 format, UTC)

Examples:

  • 2021-06-15T00:00:00Z
  • 2021-06-15T00:00:00.000Z

The total number of points, which is determined as the difference between "from" and "to" divided by "granularity", cannot exceed 1440. Exception: "speed" metrics are limited to 72 points.

group_bystring[]

Output data grouping.

Possible values:

  • resource - Data is grouped by CDN resource.
  • cname - Data is grouped by common names.
  • region – Data is grouped by regions (continents.) Available for "speed" metrics only.
  • isp - Data is grouped by ISP names. Available for "speed" metrics only.
granularitystring P(n)Y(n)M(n)DT(n)H(n)M)

Duration of the time blocks into which the data is divided. The value must correspond to the ISO 8601 period format.

Examples:

  • P1D
  • PT5M

Notes:

  • The total number of points, which is determined as the difference between "from" and "to" divided by "granularity", cannot exceed 1440. Exception: "speed" metrics are limited to 72 points.
  • For "speed" metrics the value must be a multiple of 5.

Example request

{
  "metrics": [
    "edge_status_2xx",
    "edge_status_3xx",
    "edge_status_4xx",
    "edge_status_5xx"
  ],
  "from": "2021-06-14T00:00:00Z",
  "to": "2021-06-15T00:00:00Z",
  "group_by": [
    "cname"
  ],
  "granularity": "P1D",
  "filter_by": [
    {
      "field": "resource",
      "op": "eq",
      "values": [
        1234
      ]
    }
  ]
}

Response

Successful.

Example response

{
  "data": [
    {
      "edge_status_2xx": 21095299,
      "timestamp": 1623159320
    },
    {
      "edge_download_speed": {
        "0_250k": "0",
        "250k_500k": "0",
        "500k_750k": "0",
        "750k_1M": "0",
        "1M_2M": "0.09091",
        "2M_3M": "0.1818",
        "3M_4M": "0.1818",
        "4M+": "0.5455"
      },
      "timestamp": 1623159380
    }
  ]
}