Прозрачность

На этой странице объясняется, как формируется счётчик просмотров на сайте. Данные о просмотрах поступают из Cloudflare Analytics Engine.

Каждый человек, посетивший сайт, учитывается как один просмотр. Общее число просмотров считывается из Workers Analytics Engine.

Workers Analytics Engine — хранилище Cloudflare для подсчёта событий, позволяющее добавлять новые категории без заранее заданного списка. Cloudflare описывает его как систему масштабной аналитики с неограниченным числом уникальных значений. Worker записывает точку данных через встроенный API. Позже эти точки можно прочитать в той же учётной записи с помощью SQL через HTTP SQL API. Этот диалект SQL отличается от того, который используется в другом интерфейсе Cloudflare — Analytics SQL API.

Единица хранения — dataset, то есть набор данных. Cloudflare сравнивает dataset с таблицей SQL: смысл каждой строки и каждого столбца должен оставаться неизменным. Имя dataset указывается в конфигурации Worker, где он также привязывается к Worker. Таблица появляется, когда Worker начинает записывать данные. Отдельно объявлять столбцы не требуется.

Точка данных — это одно событие, одна строка. Cloudflare добавляет timestamp, когда Worker записывает событие. Все остальные данные передаёт Worker, причём каждый раз в одном и том же порядке. Каждую позицию в этой последовательности Cloudflare называет полем.

Поле — это одна позиция в этой последовательности. Первая строка всегда занимает первое строковое поле. Второе число всегда занимает второе числовое поле. База данных не хранит имя рядом со значением — она хранит его позицию. Если изменить порядок, изменится и смысл поля. В запросе позиции становятся столбцами. Строковые поля называются от blob1 до blob20. Числовые — от double1 до double20. Ключ выборки — index1. В каждой строке также есть timestamp, dataset и _sample_interval. В запросе полю можно дать имя, подходящее для конкретной задачи, например blob1 AS city. В хранилище поле по-прежнему называется blob1.

Есть три типа полей. Blobs — строковые поля. Cloudflare называет их измерениями для группировки и фильтрации; в других системах их называют метками. Одна точка может содержать двадцать таких полей общим объёмом не более 16 килобайт. Doubles — числовые поля со значениями, которые можно суммировать или усреднять. Одна точка может содержать двадцать таких полей. Индекс — одна строка размером не более 96 байт. При записи можно передать список, но Cloudflare сохраняет точку, только если в списке ровно один индекс. Если добавить второй индекс, точка не будет записана.

При очень большом объёме данных Analytics Engine использует выборку, чтобы запросы выполнялись быстро. Выборка возможна как при записи, так и при чтении и зависит от индекса. Для индекса с большим числом событий может применяться выборка. Для индекса с меньшим числом событий могут сохраняться и считываться все данные. Каждая сохранённая строка содержит _sample_interval — число исходных событий, которые она представляет. Чтобы подсчитать события, суммируют значения _sample_interval. Чтобы получить сумму значений показателя, каждое значение сначала умножают на соответствующий _sample_interval. Чтобы получить среднее, взвешенную сумму делят на сумму интервалов.

За один вызов Worker можно записать не более 250 точек данных. Данные хранятся три месяца.