dozo
Menu
← Dozokit Analytics

Configure o Dozokit Analytics em cinco minutos

Você precisa de uma conta na Cloudflare e uma no GitHub, as duas grátis. A Cloudflare vai rodar o seu site de estatísticas, e o GitHub guarda uma cópia dele no seu nome para você atualizar depois. Leva uns cinco minutos e nada é instalado no seu computador. No fim, você terá seu próprio site de estatísticas, protegido pela sua senha, contando as visitas ao seu site.

Deploy to Cloudflare

Os passos

  1. Clique no botão Deploy to Cloudflare acima.
  2. Entre na Cloudflare ou crie sua conta grátis.
  3. Quando a Cloudflare pedir, conecte sua conta do GitHub.
  4. Deixe os nomes sugeridos (dozokit-analytics) como estão.
  5. No campo PASSWORD, digite a senha que vai proteger suas estatísticas: 12 caracteres ou mais. Anote.
  6. Clique em Create and deploy e espere um ou dois minutos.
  7. Abra o endereço que a Cloudflare mostra no fim (algo como dozokit-analytics.seu-nome.workers.dev) e digite sua senha. Este é o seu site de estatísticas, então salve nos favoritos.
  8. Em Settings, digite o endereço do seu site (por exemplo meusite.com.br) e clique em Add website.
  9. Clique em Copy para copiar a linha de código que aparece.
  10. Cole-a nas configurações do seu site, onde ele aceita “código personalizado” ou código para o cabeçalho (head), e publique.
  11. Abra seu site uma vez. Settings mostra a primeira visita assim que ela chega.

Atualizar

Quando sai uma versão nova, aparece um aviso no alto do seu site de estatísticas. Você atualiza no GitHub, em quatro cliques:

Só na primeira vez: o botão Deploy da Cloudflare copia tudo menos o botão de atualização, então adicione-o uma vez. No seu site de estatísticas, abra Settings, depois Updates, cole o endereço da sua cópia no GitHub e clique em Add the update button. O GitHub abre o arquivo pronto para salvar: clique em Commit changes e confirme. Instalou antes da 1.2.1, sem a seção Updates ainda? Na sua cópia no GitHub, clique em Add file, depois Create new file, dê o nome .github/workflows/update.yml, cole o texto abaixo e clique em Commit changes. Adicionou o botão de atualização antes da 1.2.2? Abra Settings, depois Updates, e clique em Replace it: o GitHub abre o arquivo com a versão nova na sua área de transferência, então selecione tudo nele, cole e clique em Commit changes. A partir da 1.2.2, o botão só instala uma versão depois de conferir que ela foi assinada pelo Dozokit, então uma atualização só pode vir do Dozokit. O texto para colar

  1. No github.com, abra dozokit-analytics, a cópia que a Cloudflare fez no seu nome (ela está na lista à esquerda).
  2. Clique na aba Actions.
  3. Clique em Update Dozokit Analytics na lista à esquerda.
  4. Clique em Run workflow e depois no botão verde Run workflow.

Uns dois minutos depois, a Cloudflare já colocou a versão nova no ar sozinha. Suas visitas continuam onde estão, e o aviso some. Para saber que saiu uma versão nova, seu painel pergunta à Dozokit uma vez por dia, enviando só o número da versão e um número aleatório criado para a sua cópia, nunca nada sobre seus sites ou visitantes. Você pode desligar isso em Settings, depois Updates (caixa Check for new versions): aí nada é enviado, e você não fica sabendo das versões novas. O que há de novo em cada versão

Para desenvolvedores

O botão cria um Worker chamado dozokit-analytics, um banco de dados D1 e um secret PASSWORD, além de uma cópia do repositório na sua conta do GitHub, que o Workers Builds publica a cada push na main (as migrations rodam no deploy). Para atualizar por um terminal, rode isto num clone da sua cópia: ele pega a última versão, mas mantém o seu wrangler.jsonc, que guarda o id do seu banco de dados. Um git pull simples não funciona, porque a sua cópia tem um histórico próprio.

tag=$(curl -s https://api.github.com/repos/dozokit/analytics/releases/latest | grep -o '"tag_name": *"[^"]*"' | cut -d'"' -f4) && git fetch https://github.com/dozokit/analytics tag $tag && git checkout $tag -- . ':!wrangler.jsonc' ':!.github' && git commit -m "Update Dozokit Analytics to $tag" && git push

Mais tarde, se precisar

Usar seu próprio endereço, como stats.meusite.com.br

Dá, se o seu domínio for gerenciado pela Cloudflare. Na Cloudflare, abra Workers & Pages, depois dozokit-analytics, depois Settings → Domains & Routes → Add → Custom domain. Depois use esse endereço na linha de código no lugar do workers.dev.

Trocar a senha

No seu site de estatísticas, abra Settings, depois Change password. Esqueceu? Na Cloudflare, abra Workers & Pages, depois dozokit-analytics, depois Settings → Variables and Secrets, e edite PASSWORD: a senha que você digitar ali funciona na hora.

Não contar suas próprias visitas

Abra seu site uma vez com ?dozokit_ignore=1 no fim do endereço, por exemplo meusite.com.br/?dozokit_ignore=1. Esse navegador deixa de ser contado.

Eu instalo para você

Prefere não configurar nada? Me mande um e-mail e eu instalo na sua conta da Cloudflare, pelo preço de um café.

contact@dozokit.com

Mandar e-mail