← Cloudflare Spectrum / spectrum / reference

Аналитика

Cloudflare измеряет следующие метрики для каждого соединения.

Метрика	Название	Пример	Единица
count	Count of total events	`1000`	Количество
bytesIngress	Сумма байт входящего трафика	`1000`	Сумма
bytesEgress	Сумма байт исходящего трафика	`1000`	Сумма
durationAvg	Средняя длительность соединения	`1.0`	Время в миллисекундах
durationMedian	Median connection duration	`1.0`	Время в миллисекундах
duration90th	90-й процентиль длительности соединения	`1.0`	Время в миллисекундах
duration99th	99-й процентиль длительности соединения	`1.0`	Время в миллисекундах

Дополнительные измерения

Вы можете дополнительно разделить аналитику по следующим параметрам.

Измерение	Название	Пример
событие	Connection Event	`connect`, `progress`, `disconnect`, `originError`, `clientFiltered`
appID	Application ID	`40d67c87c6cd4b889a4fd57805225e85`
coloName	Название дата-центра	`SFO`
ipVersion	Версия IP, используемая клиентом	`4`, `6`

Операторы для фильтрации

Используйте приведённые ниже операторы, чтобы отфильтровать данные.

Оператор	Название	URL Encoded
`==`	Equals	`%3D%3D`
`!=`	Не равно	`!%3D`
`>`	Больше чем	`%3E`
`<`	Less Than	`%3C`
`>=`	Больше или равно	`%3E%3D`
`<=`	Меньше или равно	`%3C%3D`

Комбинируйте фильтры с помощью OR и AND булева логика:

AND имеет приоритет над OR во всех выражениях.
OR оператор задаётся запятой , или OR ключевое слово, окружённое пробельными символами.
AND оператор задаётся точкой с запятой ; или AND ключевое слово, окружённое пробельными символами.

Примечание
Примечание
Учтите, что точка с запятой является зарезервированным символом в URL-адресах (RFC 1738 ↗) и должен быть представлен в percent-encoding как %3B.

Структура запроса аналитики

/api/v4/zones/{zone_id}/spectrum/analytics/events/summary?metrics=METRICS&dimensions=DIMENSIONS&filters=FILTERS&since=FROM_TS&sort=SORT&until=TO_TS&limit=LIMIT
/api/v4/zones/{zone_id}/spectrum/analytics/events/bytime?metrics=METRICS&dimensions=DIMENSIONS&filters=FILTERS&since=FROM_TS&sort=SORT&until=TO_TS&limit=LIMIT

METRICS обозначает один или несколько показателей (например, count), которые нужно вычислить
DIMENSIONS можно использовать для группировки данных по заданным атрибутам
FILTERS используется для фильтрации строк по одному или нескольким измерениям (см. раздел Filters ниже)
SORT задает порядок сортировки набора результатов; поля сортировки должны быть включены в METRICS или DIMENSIONS
TO_TS: конец запрашиваемого временного интервала, по умолчанию равен текущему времени
FROM_TS указывает на начало запрашиваемого временного интервала, по умолчанию используется значение TO_TS - 6 hours
STEP используется для выбора разрешения временного ряда при использовании endpoint:
auto или не указано - выбирает шаг времени, который лучше всего подходит для данного интервала
- year
- квартал
- month
- неделе
- day
- hour

Пример запроса аналитики

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:

Analytics Read

Получить сводку аналитики

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/spectrum/analytics/events/summary" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

См. Документация Spectrum API для дополнительных примеров запросов API.