v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Log viewer

Get CDN logs

Get CDN logs for up to 3 days starting today.

You can filter logs using query parameters by client IP, CDN resource, date, path and etc.

To filter the CDN logs by 2xx status codes, use:

  • &status__gte=200&status__lt=300
get/cdn/advanced/v1/logs

Query parameters

fromstring required

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

Difference between "from" and "to" cannot exceed 6 hours.

Examples:

  • &from=2021-06-14T00:00:00Z
  • &from=2021-06-14T00:00:00.000Z
tostring required

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

Difference between "from" and "to" cannot exceed 6 hours.

Examples:

  • &to=2021-06-15T00:00:00Z
  • &to=2021-06-15T00:00:00.000Z
offsetinteger

Number of log records to skip starting from the beginning of the requested period.

limitinteger

Maximum number of log records in the response.

orderingstring

Sorting rules.

Possible values:

  • method - Request HTTP method.
  • client_ip - IP address of the client who sent the request.
  • status - Status code in the response.
  • size - Response size in bytes.
  • cname - Custom domain of the requested resource.
  • resource_id - ID of the requested CDN resource.
  • cache_status - Caching status.
  • datacenter - Data center where request was processed.
  • timestamp - Date and time when the request was made.

Parameter may have multiple values separated by a comma.

By default, ascending sorting is applied. To sort in descending order, add '-' prefix.

Example:

  • &ordering=-timestamp,status
fieldsstring

A comma-separated list of returned fields.

Supported fields are presented in the responses section.

Example:

  • &fields=timestamp,path,status
method__eqstring

Request HTTP method. Possible values: 'CONNECT', 'DELETE', 'GET', 'HEAD', 'OPTIONS', 'PATCH', 'POST', 'PUT', 'TRACE'.

method__nestring

Request HTTP method. Possible values: 'CONNECT', 'DELETE', 'GET', 'HEAD', 'OPTIONS', 'PATCH', 'POST', 'PUT', 'TRACE'.

method__instring

Request HTTP method. Possible values: 'CONNECT', 'DELETE', 'GET', 'HEAD', 'OPTIONS', 'PATCH', 'POST', 'PUT', 'TRACE'. Values should be separated by a comma.

method__not_instring

Request HTTP method. Possible values: 'CONNECT', 'DELETE', 'GET', 'HEAD', 'OPTIONS', 'PATCH', 'POST', 'PUT', 'TRACE'. Values should be separated by a comma.

client_ip__eqstring

IP address of the client who sent the request.

client_ip__nestring

IP address of the client who did not send the request.

client_ip__instring

List of IP addresses of the clients who sent the request.

client_ip__not_instring

List of IP addresses of the clients who did not send the request.

status__gtinteger

Status code in the response greater than the specified value.

status__gteinteger

Status code in the response greater than or equal to the specified value.

status__ltinteger

Status code in the response less than the specified value.

status__lteinteger

Status code in the response less than or equal to the specified value.

status__eqinteger

Status code in the response equal to the specified value.

status__neinteger

Status code in the response not equal to the specified value.

status__instring

List of status codes in the response. Values should be separated by a comma.

status__not_instring

List of status codes not in the response. Values should be separated by a comma.

size__gtinteger

Response size in bytes greater than the specified value.

size__gteinteger

Response size in bytes greater than or equal to the specified value.

size__ltinteger

Response size in bytes less than the specified value.

size__lteinteger

Response size in bytes less than or equal to the specified value.

size__eqinteger

Response size in bytes equal to the specified value.

size__neinteger

Response size in bytes not equal to the specified value.

size__instring

List of response sizes in bytes. Values should be separated by a comma.

size__not_instring

List of response sizes in bytes not equal to the specified values. Values should be separated by

cname__eqstring

Custom domain of the requested CDN resource.

cname__nestring

Custom domain of the requested CDN resource not equal to the specified value.

cname__instring

List of custom domains of the requested CDN resource. Values should be separated by a comma.

cname__not_instring

List of custom domains of the requested CDN resource not equal to the specified values. Values should be separated by a comma.

cname__containsstring

Part of the custom domain of the requested CDN resource. Minimum length is 3 characters.

resource_id__gtinteger

ID of the requested CDN resource greater than the specified value.

resource_id__gteinteger

ID of the requested CDN resource greater than or equal to the specified value.

resource_id__ltinteger

ID of the requested CDN resource less than the specified value.

resource_id__lteinteger

ID of the requested CDN resource less than or equal to the specified value.

resource_id__eqinteger

ID of the requested CDN resource equal to the specified value.

resource_id__neinteger

ID of the requested CDN resource not equal to the specified value.

resource_id__instring

List of IDs of the requested CDN resource. Values should be separated by a comma.

resource_id__not_instring

List of IDs of the requested CDN resource not equal to the specified values. Values should be separated by a comma.

cache_status__eqstring

Caching status. Possible values: 'MISS', 'BYPASS', 'EXPIRED', 'STALE', 'PENDING', 'UPDATING', 'REVALIDATED', 'HIT', '-'.

cache_status__nestring

Caching status not equal to the specified value. Possible values: 'MISS', 'BYPASS', 'EXPIRED', 'STALE', 'PENDING', 'UPDATING', 'REVALIDATED', 'HIT', '-'.

cache_status__instring

List of caching statuses. Possible values: 'MISS', 'BYPASS', 'EXPIRED', 'STALE', 'PENDING', 'UPDATING', 'REVALIDATED', 'HIT', '-'. Values should be separated by a comma.

cache_status__not_instring

List of caching statuses not equal to the specified values. Possible values: 'MISS', 'BYPASS', 'EXPIRED', 'STALE', 'PENDING', 'UPDATING', 'REVALIDATED', 'HIT', '-'. Values should be separated by a comma.

datacenter__eqstring

Data center where request was processed.

datacenter__nestring

Data center where request was not processed.

datacenter__instring

List of data centers where request was processed. Values should be separated by a comma.

datacenter__not_instring

List of data centers where request was not processed. Values should be separated by a comma.

Response

Successful.

Example response

{
  "data": [
    {
      "timestamp": 1633914371,
      "client_ip": "1.1.1.1",
      "cname": "test.domain.com",
      "resource_id": 100,
      "path": "/awesome-site",
      "method": "GET",
      "user_agent": "Mozilla/5.0 (compatible; MSIE 6.0; Windows 95; Trident/3.1)",
      "status": 200,
      "size": 17340162,
      "cache_status": "HIT",
      "datacenter": "m9",
      "referer": "https://www.test.com/",
      "sent_http_content_type": "image/jpeg",
      "tcpinfo_rtt": 70
    }
  ],
  "meta": {
    "count": 129874732
  }
}