Avoimuus

Tällä sivulla kerrotaan, miten sivustolla julkaistu katselukertojen määrä lasketaan. Katselutiedot saadaan Cloudflare Analytics Engine -palvelusta.

Jokainen sivustolla käynyt henkilö lasketaan yhdeksi katselukerraksi. Määrä luetaan Workers Analytics Engine -palvelusta.

Workers Analytics Engine on Cloudflaren tallennuspalvelu laskentatiedoille, joiden luokkia ei tarvitse määritellä etukäteen. Cloudflare kuvaa sitä laajamittaiseksi analytiikaksi, jossa erillisten arvojen määrää ei ole rajoitettu. Worker kirjoittaa tietopisteen sisäänrakennetun rajapinnan kautta. Myöhemmin tietopisteet luetaan saman tilin kautta SQL-kyselyillä HTTP SQL -rajapinnan välityksellä. Sen käyttämä SQL-murre on erillinen Cloudflaren toisen Analytics SQL API -rajapinnan käyttämästä murteesta.

Tallennusyksikkö on dataset. Cloudflare vertaa sitä SQL-tauluun: kunkin rivin ja sarakkeen merkityksen tulee pysyä johdonmukaisena. Worker-määrityksissä dataset saa nimen ja kytketään Workeriin. Taulu syntyy, kun Worker alkaa kirjoittaa tietoja. Sarakkeita ei määritellä erikseen.

Tietopiste vastaa yhtä tapahtumaa eli yhtä riviä. Cloudflare lisää aikaleiman, kun Worker kirjaa tapahtuman. Worker toimittaa kaikki muut tiedot, ja niiden on oltava joka kerta samassa järjestyksessä. Cloudflare kutsuu kutakin paikkaa tässä järjestyksessä kentäksi.

Kenttä on yksi paikka tässä järjestyksessä. Ensimmäinen merkkijono on aina ensimmäinen merkkijonokenttä. Toinen luku on aina toinen lukukenttä. Tietokanta ei tallenna arvon yhteyteen nimeä, vaan sen paikan. Jos järjestys muuttuu, myös kentän merkitys muuttuu. Kyselyssä paikat näkyvät sarakkeina. Merkkijonokentät ovat blob1–blob20. Lukukentät ovat double1–double20. Otanta-avain on index1. Jokaisella rivillä ovat myös timestamp, dataset ja _sample_interval. Kyselyssä kentälle voi antaa kyseiseen kyselyyn sopivan nimen, esimerkiksi blob1 AS city. Tallennettu kenttä on silti blob1.

Kenttiä on kolmenlaisia. Blob-kentät sisältävät merkkijonoja. Cloudflare kutsuu niitä ryhmittelyyn ja suodatukseen käytettäviksi ulottuvuuksiksi eli dimensioiksi. Muissa järjestelmissä vastaavista käytetään nimitystä tunnisteet. Tietopisteessä voi olla kaksikymmentä blob-kenttää, joiden yhteenlaskettu koko saa olla enintään 16 kilotavua. Double-kentät sisältävät lukuja: mittausarvoja, joista voidaan laskea summia tai keskiarvoja. Tietopisteessä voi olla kaksikymmentä double-kenttää. Indeksi on yksi enintään 96 tavun pituinen merkkijono. Kirjoitusrajapinta hyväksyy luettelon, mutta Cloudflare tallentaa tietopisteen vain, jos luettelossa on tasan yksi indeksi. Jos indeksejä on kaksi, tietopistettä ei tallenneta.

Kun tietomäärät ovat hyvin suuria, Analytics Engine käyttää otantaa, jotta kyselyt pysyvät nopeina. Otanta voi tapahtua sekä kirjoitettaessa että luettaessa, ja se perustuu indeksiin. Jos samaan indeksiin liittyy paljon tapahtumia, niistä voidaan ottaa otos. Vähäisemmän tapahtumamäärän indeksin kaikki tapahtumat voidaan säilyttää mukana. Jokaisella tallennetulla rivillä on _sample_interval, joka kertoo, kuinka montaa alkuperäistä tapahtumaa rivi edustaa. Tapahtumien määrä saadaan laskemalla _sample_interval-arvot yhteen. Mittausarvojen summaa laskettaessa kukin mittausarvo kerrotaan ensin _sample_interval-arvolla. Keskiarvo saadaan jakamalla painotettu summa _sample_interval-arvojen summalla.

Yksi Workerin suoritus voi kirjoittaa enintään 250 tietopistettä. Tiedot säilytetään kolme kuukautta.