Przejrzystość

Ta strona wyjaśnia, skąd bierze się publikowana w serwisie liczba wyświetleń. Dane o wyświetleniach pochodzą z Cloudflare Analytics Engine.

Każda osoba, która odwiedziła witrynę, jest liczona jako jedno wyświetlenie. Tę liczbę odczytujemy z Workers Analytics Engine.

Workers Analytics Engine to usługa Cloudflare do przechowywania danych liczbowych, które mogą przyrastać bez z góry ustalonej listy kategorii. Cloudflare opisuje ją jako analitykę na dużą skalę, bez ograniczeń liczby unikalnych wartości. Worker zapisuje punkt danych za pomocą wbudowanego API. Później z tego samego konta można odczytać te punkty za pomocą SQL, korzystając z interfejsu HTTP SQL API. Używany tu dialekt SQL jest odrębny od tego, z którego korzysta inny interfejs Cloudflare — Analytics SQL API.

Jednostką przechowywania danych jest dataset. Cloudflare porównuje dataset do tabeli w SQL: każdy wiersz i każda kolumna powinny mieć stałe znaczenie. Nazwę dataset podaje się w konfiguracji Workera i wiąże się go z Workerem. Tabela pojawia się, gdy Worker zaczyna zapisywać dane. Kolumn nie deklaruje się osobno.

Punkt danych to jedno zdarzenie, czyli jeden wiersz. Cloudflare dodaje timestamp w chwili, gdy Worker rejestruje zdarzenie. Wszystkie pozostałe dane dostarcza Worker, za każdym razem w tej samej kolejności. Każdą z tych uporządkowanych pozycji Cloudflare nazywa polem.

Pole to jedna pozycja w tej kolejności. Pierwszy ciąg znaków zawsze trafia do pierwszego pola tekstowego. Druga liczba zawsze trafia do drugiego pola liczbowego. Baza danych nie zapisuje nazwy obok wartości. Zapisuje jej pozycję. Zmiana kolejności zmienia więc znaczenie pola. W zapytaniu pozycje stają się kolumnami. Pola tekstowe mają nazwy od blob1 do blob20. Pola liczbowe — od double1 do double20. Kluczem próbkowania jest index1. Każdy wiersz zawiera też timestamp, dataset i _sample_interval. Na potrzeby konkretnego zapytania można nadać polu inną nazwę, na przykład blob1 AS city. Zapisane pole nadal nosi nazwę blob1.

Są trzy rodzaje pól. Pola typu blob zawierają ciągi znaków. Cloudflare nazywa je wymiarami służącymi do grupowania i filtrowania; w innych systemach nazywa się je etykietami. Punkt danych może zawierać dwadzieścia pól typu blob, które łącznie nie mogą przekroczyć 16 kilobajtów. Pola typu double zawierają liczby — wartości pomiarów, które można sumować lub uśredniać. Punkt danych może zawierać dwadzieścia pól typu double. Indeks to jeden ciąg znaków o długości najwyżej 96 bajtów. Operacja zapisu przyjmuje listę, ale Cloudflare zapisuje punkt danych tylko wtedy, gdy lista zawiera dokładnie jeden indeks. Drugi indeks sprawia, że punkt danych nie zostanie zapisany.

Przy bardzo dużej ilości danych Analytics Engine stosuje próbkowanie, aby zapytania nadal działały szybko. Próbkowanie może odbywać się zarówno podczas zapisu, jak i odczytu, a jego przebieg zależy od indeksu. Dane dla indeksu z dużą liczbą zdarzeń mogą podlegać próbkowaniu. Dane dla indeksu z mniejszą liczbą zdarzeń mogą pozostać kompletne. Każdy zapisany wiersz zawiera _sample_interval, czyli liczbę pierwotnych zdarzeń, które reprezentuje. Liczbę zdarzeń oblicza się jako sumę wartości _sample_interval. Aby zsumować wartości pomiaru, najpierw mnoży się każdą z nich przez _sample_interval. Średnią oblicza się, dzieląc tak uzyskaną sumę ważoną przez sumę wartości _sample_interval.

Jedno wywołanie Workera może zapisać najwyżej 250 punktów danych. Dane są przechowywane przez trzy miesiące.