Transparência

Esta página explica a contagem de visualizações publicada neste site. Os dados vêm do Cloudflare Analytics Engine.

Cada pessoa que visita o site conta como uma visualização. Essa contagem é obtida do Workers Analytics Engine.

O Workers Analytics Engine é o sistema da Cloudflare para armazenar contagens que podem crescer sem uma lista fixa de categorias. A Cloudflare o descreve como uma solução de análise em escala com cardinalidade ilimitada. Um Worker grava um ponto de dados por meio de uma API integrada. Depois, a mesma conta consulta esses pontos usando SQL, por uma API SQL via HTTP. Esse dialeto SQL é diferente do usado na outra API da Cloudflare, a Analytics SQL API.

Um dataset é a unidade de armazenamento. A Cloudflare compara um dataset a uma tabela SQL: cada linha e cada coluna devem manter um significado consistente. O nome do dataset é definido na configuração do Worker, ao qual ele é vinculado. A tabela surge quando o Worker começa a gravar dados. As colunas não são declaradas em uma etapa separada.

Um ponto de dados corresponde a um evento, ou seja, a uma linha. A Cloudflare adiciona um timestamp quando o Worker registra o evento. Todos os outros dados são fornecidos pelo Worker, sempre na mesma ordem. A Cloudflare chama cada uma dessas posições de campo.

Um campo é uma posição nessa sequência. O primeiro texto ocupa sempre o primeiro campo de texto. O segundo número ocupa sempre o segundo campo numérico. O banco de dados não armazena um nome ao lado do valor. Ele armazena a posição. Se a ordem mudar, o significado do campo também muda. Em uma consulta, as posições se tornam colunas. Os campos de texto vão de blob1 a blob20. Os campos numéricos vão de double1 a double20. A chave de amostragem é index1. Cada linha também contém timestamp, dataset e _sample_interval. Uma consulta pode dar outro nome a um campo para atender àquela consulta, por exemplo, blob1 AS cidade. O campo armazenado continua sendo blob1.

Existem três tipos de campo. Os blobs contêm texto. A Cloudflare os chama de dimensões usadas para agrupar e filtrar dados, o que outros sistemas chamam de rótulos. Um ponto pode conter vinte blobs, que, juntos, não podem ultrapassar 16 kilobytes. Os doubles contêm números: as medidas que serão somadas ou usadas para calcular médias. Um ponto pode conter vinte doubles. O índice é um único texto de até 96 bytes. A operação de gravação aceita uma lista, mas a Cloudflare só armazena o ponto quando essa lista contém um único índice. Se houver um segundo índice, o ponto não será registrado.

Quando o volume é muito alto, o Analytics Engine usa amostragem dos dados para manter as consultas rápidas. A amostragem pode ocorrer tanto na gravação quanto na leitura e é feita por índice. Um índice com muitos eventos pode passar por amostragem. Outro com menos eventos pode permanecer sem amostragem. Cada linha armazenada inclui _sample_interval, o número de eventos originais que ela representa. A contagem é a soma de _sample_interval. Para somar uma medida, primeiro é preciso multiplicar seu valor por _sample_interval. Para calcular a média, divide-se a soma ponderada pela soma dos intervalos.

Cada execução de um Worker pode gravar no máximo 250 pontos de dados. Os dados ficam armazenados por três meses.