Просмотр логов. Посмотреть и скачать логи CDN-ресурсов

Параметр

Описание

Пример заполнения

from

Условие: это обязательный параметр, без него запрос не сработает.

Что настраивает: начало временного интервала, за который будут выгружены логи.

Как заполнить: введите время в формате ISO 8086 или RFC 3339. Время указывается в UTC.

&from=2022-04-27T06:00:00Z

to

Условие: это обязательный параметр, без него запрос не сработает.

Что настраивает: конец временного интервала, за который будут выгружены логи.

Как заполнить: введите время в том же формате, что и в параметре from. Разница между значениями from и to не должна превышать 6 часов для просмотра и 24 часа для экспорта.

&to=2022-04-27T12:00:00Z

offset

Что настраивает: пропуск определённого количества записей с начала ответа.

Значение по умолчанию: offset=0.

Как заполнить: укажите количество записей, которое хотите пропустить.

Пример: ответ содержит 100 записей, а вы хотите увидеть только записи с 11 по 100. Задайте значение offset=10: первые десять записей будут пропущены, и вы увидите только записи № 11–100.

&offset=10

limit

Что настраивает: количество записей в ответе.

Значение по умолчанию: 100 для просмотра логов и 1 000 для экспорта.

Максимальные значения: 1 000 для просмотра и 10 000 для экспорта.

Как заполнить: укажите количество записей, которое хотите видеть в ответе.

Пример: установив limit=200, вы увидите первые 200 записей с начала ответа.

Особый кейс использования: вместе с параметром offset, чтобы разделить записи ответа на сегменты по n записей. Например, есть 100 записей, нужно посмотреть их не единым списком, а разбить на 10 списков по 10 записей в каждом. Для этого используем комбинацию параметров limit и offset. Отправьте 10 запросов с такими комбинациями параметров:

&limit=10&offset=0
&limit=20&offset=10
&limit=30&offset=20
...
&limit=100&offset=90

&limit=100

fields

Что настраивает: какие поля будут отображаться в ответе.

Значение по умолчанию: если не указать параметр fields, вы увидите в ответе все доступные поля — timestamp, path, method, referer, user_agent, client_ip, status, size, cname, resource_id, cache_status, datacenter, sent_http_content_type, tcpinfo_rtt.

Как заполнить: укажите через запятую поля, которые хотите видеть в ответе.

&fields=method,status,size,path

field__op

Что настраивает: фильтрацию записей в ответе — выводит только записи с определённым значением параметров.

Для каких полей можно задать фильтр: method, client_ip, status, size, cname, resource_id, cache_status, datacenter.

Как заполнить: замените field на нужное поле. Рядом с названием поля через двойное нижнее подчёркивание укажите оператор фильтрации: eq, gt, gte, lt, ne, in, not_in, contains (доступные операторы для конкретных полей указаны в API-документации). Поставьте знак «=» после оператора и укажите нужное значение. Если вы хотите указать несколько правил фильтрации, добавьте выражения в одну строку через знак «&».

Пример: установив method__eq=GET, вы увидите в ответе только записи с HTTP-методом GET.

&status__gte=300&status__lt=400&method__in=GET,PUT

ordering

Условие: этот параметр можно указать только для просмотра логов.

Что настраивает: в каком порядке будут отображаться записи в ответе.

Значение по умолчанию: если не указывать параметр ordering, записи будут отсортированы по времени — от ранних к поздним.

По каким полям можно сортировать порядок записей: method, client_ip, status, size, cname, resource_id, cache_status, datacenter, temestamp.

Как настроить: укажите поле, чтобы отсортировать записи по нему. Записи будут отсортированы от меньшего значения к большему. Например, если указать поле status, то первыми вы увидите записи с кодами ответа 2хх и последними — с 5хх.

Если нужно, чтобы порядок был обратным, от большего к меньшему, поставьте перед полем знак «-»: -status.

Также вы можете указать несколько полей через запятую. Тогда сортировка будет вложенной: сначала записи будут отсортированы по первому полю, а если у каких-то записей значение первого поля одинаковое, то между собой они будут отсортированы по второму полю.

Пример: если указать ordering=status,size, то сначала все записи будут отсортированы по коду ответа: 200, 201, 202, 203... А если у нескольких записей одинаковый код ответа, в дело вступит сортировка по второму полю — размеру ответа в байтах. То есть среди нескольких записей с кодом, скажем, 200 первой будет стоять запись, ответ которой весит меньше других.

&ordering=size,-status

sort

Условие: этот параметр можно указать только для экспорта логов.

Что настраивает: в каком порядке будут отображаться записи в ответе.

Значение по умолчанию: если не указывать параметр sort, записи будут отсортированы по времени — от ранних к поздним.

По каким полям можно сортировать порядок записей: method, client_ip, status, size, cname, resource_id, cache_status, datacenter, temestamp.

Как настроить: укажите поле, чтобы отсортировать записи по нему. Записи будут отсортированы от меньшего значения к большему. Например, если указать поле status, то первыми вы увидите записи с кодами ответа 2хх и последними — с 5хх.

Если нужно, чтобы порядок был обратным, от большего к меньшему, поставьте перед полем знак «-»: -status.

Также вы можете указать несколько полей через запятую. Тогда сортировка будет вложенной: сначала записи будут отсортированы по первому полю, а если у каких-то записей значение первого поля одинаковое, то между собой они будут отсортированы по второму полю.

Пример: если указать sort=status,size, то сначала все записи будут отсортированы по коду ответа: 200, 201, 202, 203... А если у нескольких записей одинаковый код ответа, в дело вступит сортировка по второму полю — размеру ответа в байтах. То есть среди нескольких записей с кодом, скажем, 200 первой будет стоять запись, ответ которой весит меньше других.

&sort=size,-status

format

Условие: этот параметр можно указать только для скачивания логов.

Что настраивает: формат, в котором будет экспортирован файл с логами. Доступны форматы CSV и TSV.

Как заполнить: введите csv или tsv.

&format=csv