Trasparenza

Questa pagina spiega il conteggio delle visualizzazioni pubblicato su questo sito. I dati sulle visualizzazioni provengono da Cloudflare Analytics Engine.

Ogni persona che visita il sito viene conteggiata come una visualizzazione. Il conteggio viene letto da Workers Analytics Engine.

Workers Analytics Engine è il sistema di Cloudflare per archiviare conteggi che possono crescere senza un elenco prestabilito di categorie. Cloudflare lo descrive come un sistema di analisi su larga scala a cardinalità illimitata. Un Worker scrive un punto dati tramite un'API integrata. In seguito, lo stesso account legge quei punti dati con SQL, tramite un'API SQL su HTTP. Questo dialetto SQL è distinto da quello dell'altra API di Cloudflare, Analytics SQL API.

Un dataset è l'unità di archiviazione. Cloudflare paragona un dataset a una tabella SQL: ogni riga e ogni colonna devono mantenere un significato coerente. Il nome del dataset viene specificato nella configurazione del Worker, al quale il dataset viene collegato. La tabella compare quando il Worker inizia a scrivere. Non occorre dichiarare le colonne in un passaggio separato.

Un punto dati corrisponde a un evento, ossia a una riga. Cloudflare aggiunge un timestamp quando il Worker registra l'evento. Tutti gli altri dati vengono forniti dal Worker, sempre nello stesso ordine. Cloudflare chiama campo ciascuna di queste posizioni ordinate.

Un campo è una posizione in quell'ordine. La prima stringa occupa sempre il primo campo di tipo stringa. Il secondo numero occupa sempre il secondo campo numerico. Il database non memorizza un nome accanto al valore: ne memorizza la posizione. Se si cambia l'ordine, cambia anche il significato del campo. Nelle query, le posizioni diventano colonne. I campi di tipo stringa vanno da blob1 a blob20. I campi numerici vanno da double1 a double20. La chiave di campionamento è index1. Ogni riga contiene anche timestamp, dataset e _sample_interval. Una query può assegnare a un campo un nome adatto alla specifica interrogazione, per esempio blob1 AS city. Il campo memorizzato resta comunque blob1.

Esistono tre tipi di campo. I blob sono stringhe. Cloudflare li definisce dimensioni usate per raggruppare e filtrare i dati: ciò che altri sistemi chiamano etichette. Un punto dati può contenere venti blob, per un totale massimo di 16 kilobyte. I double sono numeri: le misure da sommare o di cui calcolare la media. Un punto dati può contenere venti double. L'indice è una singola stringa di massimo 96 byte. L'operazione di scrittura accetta un elenco, ma Cloudflare memorizza il punto dati solo se quell'elenco contiene un unico indice. Se è presente un secondo indice, il punto dati non viene registrato.

Quando il volume è molto elevato, Analytics Engine campiona i dati per mantenere veloci le query. Il campionamento può avvenire sia in scrittura sia in lettura e si basa sull'indice. I dati associati a un indice con molti eventi possono essere campionati. Quelli associati a un indice con meno eventi possono rimanere integri, senza campionamento. Ogni riga memorizzata include _sample_interval, il numero di eventi originali che quella riga rappresenta. Il conteggio si ottiene sommando i valori di _sample_interval. Per sommare una misura, prima si moltiplica il valore di ogni riga per _sample_interval. Per calcolare una media, si divide la somma ponderata per la somma degli intervalli.

Ogni esecuzione di un Worker può scrivere al massimo 250 punti dati. I dati vengono conservati per tre mesi.