Átláthatóság

Ez az oldal a webhelyen közzétett megtekintésszám számítását ismerteti. A megtekintési adatok a Cloudflare Analytics Engine szolgáltatásból származnak.

Mindenki, aki felkeresi a webhelyet, egy megtekintésnek számít. Ezt a számot a Workers Analytics Engine szolgáltatásból olvassuk ki.

A Workers Analytics Engine a Cloudflare olyan adattárolója, amelyben a számlálási adatok az előre rögzített kategóriák korlátai nélkül gyarapodhatnak. A Cloudflare ezt nagy léptékben is működő, korlátlan számú egyedi értéket kezelő analitikaként írja le. Egy Worker egy beépített API-n keresztül ír be egy adatpontot. Később ugyanabból a fiókból SQL-lekérdezésekkel, egy HTTP-alapú SQL API-n keresztül olvashatók ki ezek az adatpontok. Ez az SQL-nyelvjárás eltér attól, amelyet a Cloudflare másik, Analytics SQL API nevű felülete használ.

A tárolás egysége a dataset. A Cloudflare a dataset fogalmát egy SQL-táblához hasonlítja: minden sornak és minden oszlopnak következetesen ugyanazt kell jelentenie. A dataset nevét a Worker konfigurációjában adjuk meg, és ott kapcsoljuk hozzá a Workerhez. A tábla akkor jön létre, amikor a Worker elkezd adatokat írni. Az oszlopokat nem kell külön lépésben deklarálni.

Egy adatpont egy eseménynek, vagyis egy sornak felel meg. Amikor a Worker rögzíti az eseményt, a Cloudflare hozzáad egy időbélyeget. Minden más adatot a Worker ad meg, és ezeket minden alkalommal ugyanabban a sorrendben kell megadnia. A Cloudflare az így meghatározott helyek mindegyikét mezőnek nevezi.

Egy mező a sorrendben elfoglalt helyet jelenti. Az első szöveges érték mindig az első szöveges mezőbe kerül. A második szám mindig a második számmezőbe kerül. Az adatbázis nem tárol nevet az érték mellett, csak annak helyét tárolja. Ha megváltozik a sorrend, a mező jelentése is megváltozik. A lekérdezésekben ezek a helyek oszlopokként jelennek meg. A szöveges mezők neve blob1 és blob20 között, a számmezőké double1 és double20 között fut. A mintavételezési kulcs neve index1. Minden sorhoz tartozik timestamp, dataset és _sample_interval is. Egy lekérdezés az adott kérdéshez illő nevet adhat egy mezőnek, például így: blob1 AS city. A tárolt mező neve ettől még blob1 marad.

Háromféle mező létezik. A blob típusú mezők szöveges értékeket tárolnak. A Cloudflare ezeket a csoportosításhoz és szűréshez használt dimenzióknak nevezi; más rendszerekben címkéknek hívják őket. Egy adatpont legfeljebb húsz ilyen mezőt tartalmazhat, összméretük pedig nem haladhatja meg a 16 kilobájtot. A double típusú mezők számokat tárolnak: olyan mérési értékeket, amelyeket összegezni vagy átlagolni lehet. Egy adatpont legfeljebb húsz ilyen mezőt tartalmazhat. Az index egyetlen, legfeljebb 96 bájtos szöveges érték. Az írási művelet listát fogad, a Cloudflare azonban csak akkor tárolja az adatpontot, ha a lista pontosan egy indexet tartalmaz. Ha második index is szerepel benne, az adatpont nem kerül rögzítésre.

Nagyon nagy adatmennyiségnél az Analytics Engine mintavételezéssel biztosítja, hogy a lekérdezések gyorsak maradjanak. Mintavételezés íráskor és olvasáskor is történhet, indexenként. Egy sok eseményt tartalmazó index adataiból készülhet minta, míg egy kisebb forgalmú index minden eseménye megmaradhat. Minden tárolt sor tartalmaz egy _sample_interval értéket, amely megadja, hány eredeti eseményt képvisel az adott sor. Az események számát az _sample_interval értékek összege adja. Egy mérési érték összegzéséhez először minden sorban meg kell szorozni az értéket az _sample_interval értékével. Az átlaghoz ezt a súlyozott összeget el kell osztani az _sample_interval értékek összegével.

A Worker egyetlen meghívása legfeljebb 250 adatpontot írhat be. Az adatokat három hónapig tárolják.