GET
/
cdn
/
statistics
/
series
CDN resource statistics
curl --request GET \
  --url https://api.gcore.com/cdn/statistics/series \
  --header 'Authorization: <api-key>'
{
  "resource": {
    "1": {
      "region": {
        "asia": {
          "metrics": {
            "sent_bytes": [
              [
                1543622400,
                17329220573
              ]
            ],
            "total_bytes": [
              [
                1543622400,
                17384617989
              ]
            ],
            "backblaze_bytes": [
              [
                1543622400,
                17384617989
              ]
            ],
            "upstream_bytes": [
              [
                1543622400,
                55397416
              ]
            ]
          }
        },
        "cis": {
          "metrics": {
            "sent_bytes": [
              [
                1543622400,
                234582406061
              ]
            ],
            "total_bytes": [
              [
                1543622400,
                234677982848
              ]
            ],
            "backblaze_bytes": [
              [
                1543622400,
                234677982848
              ]
            ],
            "upstream_bytes": [
              [
                1543622400,
                95576787
              ]
            ]
          }
        },
        "eu": {
          "metrics": {
            "sent_bytes": [
              [
                1543622400,
                243212514764
              ]
            ],
            "total_bytes": [
              [
                1543622400,
                243297296511
              ]
            ],
            "backblaze_bytes": [
              [
                1543622400,
                243297296511
              ]
            ],
            "upstream_bytes": [
              [
                1543622400,
                84781747
              ]
            ]
          }
        },
        "latam": {
          "metrics": {
            "sent_bytes": [
              [
                1543622400,
                59819837564
              ]
            ],
            "total_bytes": [
              [
                1543622400,
                59927133387
              ]
            ],
            "backblaze_bytes": [
              [
                1543622400,
                59927133387
              ]
            ],
            "upstream_bytes": [
              [
                1543622400,
                107295823
              ]
            ]
          }
        },
        "me": {
          "metrics": {
            "sent_bytes": [
              [
                1543622400,
                13643432427
              ]
            ],
            "total_bytes": [
              [
                1543622400,
                13644762375
              ]
            ],
            "backblaze_bytes": [
              [
                1543622400,
                13644762375
              ]
            ],
            "upstream_bytes": [
              [
                1543622400,
                1329948
              ]
            ]
          }
        },
        "na": {
          "metrics": {
            "sent_bytes": [
              [
                1543622400,
                234004049506
              ]
            ],
            "total_bytes": [
              [
                1543622400,
                234655863540
              ]
            ],
            "backblaze_bytes": [
              [
                1543622400,
                234655863540
              ]
            ],
            "upstream_bytes": [
              [
                1543622400,
                651814034
              ]
            ]
          }
        }
      }
    },
    "4777": {
      "region": {
        "au": {
          "metrics": {
            "sent_bytes": [
              [
                1543622400,
                490800672
              ]
            ]
          }
        }
      }
    }
  }
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Query Parameters

​
service
string
required

Service name. Possible value:

  • CDN
​
from
string
required

Beginning of the requested time period (ISO 8601/RFC 3339 format, UTC.)

​
to
string
required

End of the requested time period (ISO 8601/RFC 3339 format, UTC.)

​
granularity
string
required

Duration of the time blocks into which the data will be divided. Possible values:

  • 1m - available only for up to 1 month in the past.
  • 5m
  • 15m
  • 1h
  • 1d
​
metrics
string
required

Types of statistics data. Possible values:

  • upstream_bytes – Traffic in bytes from an origin server to CDN servers or to origin shielding when used.
  • sent_bytes – Traffic in bytes from CDN servers to clients.
  • shield_bytes – Traffic in bytes from origin shielding to CDN servers.
  • backblaze_bytes - Traffic in bytes from Backblaze origin.
  • total_bytes – shield_bytes, upstream_bytes and sent_bytes combined.
  • cdn_bytes – sent_bytes and shield_bytes combined.
  • requests – Number of requests to edge servers.
  • responses_2xx – Number of 2xx response codes.
  • responses_3xx – Number of 3xx response codes.
  • responses_4xx – Number of 4xx response codes.
  • responses_5xx – Number of 5xx response codes.
  • responses_hit – Number of responses with the header Cache: HIT.
  • responses_miss – Number of responses with the header Cache: MISS.
  • response_types – Statistics by content type. It returns a number of responses for content with different MIME types.
  • cache_hit_traffic_ratio – Formula: 1 - upstream_bytes / sent_bytes. We deduct the non-cached traffic from the total traffic amount.
  • cache_hit_requests_ratio – Formula: responses_hit / requests. The share of sending cached content.
  • shield_traffic_ratio – Formula: (shield_bytes - upstream_bytes) / shield_bytes. The efficiency of the Origin Shielding: how much more traffic is sent from the Origin Shielding than from the origin.
  • image_processed - Number of images transformed on the Image optimization service.
  • request_time - Time elapsed between the first bytes of a request were processed and logging after the last bytes were sent to a user.
  • upstream_response_time - Number of milliseconds it took to receive a response from an origin. If upstream response_time_ contains several indications for one request (in case of more than 1 origin), we summarize them. In case of aggregating several queries, the average of this amount is calculated. Metrics upstream_response_time and request_time should be requested separately from other metrics
​
group_by
string

Output data grouping. Possible values:

  • resource – Data is grouped by CDN resources IDs.
  • region – Data is grouped by regions of CDN edge servers.
  • country – Data is grouped by countries of CDN edge servers.
  • vhost – Data is grouped by resources CNAMEs. To request multiple values, use: * &group_by=region&group_by=resource
​
countries
string

Names of countries for which data should be displayed. English short name from [ISO 3166 standard][1] without the definite article ("the") should be used. [1]: https://www.iso.org/obp/ui/#search/code/ To request multiple values, use: * &countries=france&countries=denmark

​
regions
string

Regions for which data is displayed. Possible values:

  • na – North America
  • eu – Europe
  • cis – Commonwealth of Independent States
  • asia – Asia
  • au – Australia
  • latam – Latin America
  • me – Middle East
  • africa - Africa
  • sa - South America
​
resource
integer

CDN resource IDs. To request multiple values, use: * &resource=1&resource=2

Response

200
application/json

Successful.

The response is of type object.