Transparence

Cette page explique le nombre de vues affiché sur ce site. Les vues proviennent de Cloudflare Analytics Engine.

Chaque personne qui visite le site compte pour une vue. Ce nombre est lu dans Workers Analytics Engine.

Workers Analytics Engine est le service de Cloudflare qui stocke des données de comptage sans imposer de liste fixe de catégories. Cloudflare le présente comme un outil d’analyse à grande échelle et à cardinalité illimitée. Un Worker écrit un point de données au moyen d’une API intégrée. Le même compte peut ensuite lire ces points en SQL, via une API SQL accessible en HTTP. Ce dialecte SQL est distinct de celui de l’autre API Analytics SQL de Cloudflare.

Un dataset est l’unité de stockage. Cloudflare compare un dataset à une table SQL : chaque ligne et chaque colonne doivent conserver un sens cohérent. Le dataset est nommé dans la configuration du Worker et associé à celui-ci. La table apparaît dès que le Worker commence à y écrire. Aucune étape distincte n’est nécessaire pour déclarer les colonnes.

Un point de données correspond à un événement et à une ligne. Cloudflare ajoute un timestamp lorsque le Worker enregistre l’événement. Toutes les autres données sont fournies par le Worker, toujours dans le même ordre. Cloudflare appelle chacune de ces positions un champ.

Un champ correspond à une position dans cet ordre. La première chaîne de caractères occupe toujours le premier champ de type chaîne. Le deuxième nombre occupe toujours le deuxième champ numérique. La base de données ne stocke pas de nom à côté de la valeur : elle enregistre sa position. Si l’ordre change, le sens du champ change aussi. Dans une requête, ces positions deviennent des colonnes. Les champs de type chaîne vont de blob1 à blob20. Les champs numériques vont de double1 à double20. La clé d’échantillonnage est index1. Chaque ligne comporte aussi timestamp, dataset et _sample_interval. Une requête peut renommer un champ selon le besoin, par exemple blob1 AS city. Le champ stocké reste blob1.

Il existe trois types de champs. Les blobs sont des chaînes de caractères. Cloudflare les appelle des dimensions, utilisées pour regrouper et filtrer les données ; d’autres systèmes parlent d’étiquettes. Un point peut contenir vingt blobs, dont la taille totale ne doit pas dépasser 16 kilooctets. Les doubles sont des nombres : les mesures à additionner ou dont on souhaite calculer la moyenne. Un point peut contenir vingt doubles. L’index est une seule chaîne de caractères de 96 octets au maximum. L’opération d’écriture accepte une liste, mais Cloudflare ne stocke le point que si cette liste contient un seul index. Avec un deuxième index, le point n’est pas enregistré.

Lorsque le volume est très élevé, Analytics Engine procède à un échantillonnage des données pour que les requêtes restent rapides. Cet échantillonnage peut avoir lieu à l’écriture comme à la lecture et dépend de l’index. Les données d’un index comptant de nombreux événements peuvent être échantillonnées, tandis que celles d’un index moins actif peuvent rester complètes. Chaque ligne stockée comporte _sample_interval, qui indique le nombre d’événements d’origine représentés par cette ligne. Pour compter les événements, on additionne les valeurs de _sample_interval. Pour additionner une mesure, on multiplie d’abord chaque valeur par _sample_interval. Pour calculer une moyenne, on divise la somme pondérée par la somme des intervalles.

Une invocation de Worker peut écrire au maximum 250 points de données. Les données sont conservées pendant trois mois.