Прозорість

На цій сторінці пояснюємо, як формується кількість переглядів, яку показує цей сайт. Дані про перегляди надходять із 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 починає записувати дані. Окремо оголошувати стовпці не потрібно.

Точка даних — це одна подія, один рядок. Коли Worker записує подію, Cloudflare додає часову позначку timestamp. Усі інші дані передає Worker, щоразу в тому самому порядку. Кожну позицію в цій послідовності Cloudflare називає полем.

Поле — це одна позиція в цій послідовності. Перший рядок тексту завжди потрапляє в перше текстове поле. Друге число — завжди в друге числове поле. База даних зберігає не назву поруч зі значенням, а його позицію. Якщо змінити порядок, зміниться й зміст поля. У запиті ці позиції стають стовпцями. Текстові поля мають назви від blob1 до blob20. Числові поля — від double1 до double20. Ключ вибірки — index1. Кожен рядок також містить timestamp, dataset і _sample_interval. Для потреб конкретного запиту полю можна дати іншу назву, наприклад blob1 AS city. У сховищі це поле й далі називається blob1.

Є три типи полів. Поля blob містять текстові рядки. Cloudflare називає їх вимірами для групування та фільтрування — в інших системах це мітки. Одна точка даних може містити до двадцяти полів blob, загальний обсяг яких не має перевищувати 16 кілобайтів. Поля double містять числа — числові показники, які можна підсумовувати або для яких можна обчислювати середнє. Одна точка даних може містити до двадцяти полів double. Індекс — це один текстовий рядок завдовжки не більш ніж 96 байтів. Під час запису можна передати список, але Cloudflare зберігає точку даних лише тоді, коли цей список містить рівно один індекс. Якщо додати другий індекс, точку даних не буде записано.

За дуже великих обсягів Analytics Engine використовує вибірку даних, щоб запити залишалися швидкими. Вибірка може відбуватися як під час запису, так і під час зчитування, і залежить від індексу. Для індексу з великою кількістю подій може застосовуватися вибірка. Для індексу з меншою кількістю подій можуть зберігатися й зчитуватися всі події. Кожен збережений рядок містить _sample_interval — кількість початкових подій, які він представляє. Загальну кількість подій отримують, підсумовуючи _sample_interval. Щоб отримати суму числового показника, спочатку множать його значення на _sample_interval. Щоб обчислити середнє, зважену суму ділять на суму значень _sample_interval.

За один виклик Worker можна записати щонайбільше 250 точок даних. Дані зберігаються протягом трьох місяців.