Analytics e telemetria
O que coletamos, como desativar e onde ver insights agregados
O que é coletado
Na criação bem-sucedida de um projeto, a CLI envia um único evento (project_created) com:
- Opções selecionadas (escolhas da stack), incluindo:
frontend,backend,runtime,database,orm,api,auth,payments,addons,examples,dbSetup,webDeploy,serverDeploy,packageManager,git,install - Dados de ambiente:
cli_version,node_version,platform
Não é coletado:
- Nome do projeto, caminho ou conteúdo de arquivos (explicitamente omitidos)
- Segredos ou variáveis de ambiente da sua máquina
Desativar telemetria
A telemetria fica habilitada por padrão. Para desativar:
BTS_TELEMETRY_DISABLED=1 npx kubojs@latestNota
O comando acima desativa apenas para uma execução.
Adicione export BTS_TELEMETRY_DISABLED=1 ao perfil do shell para tornar permanente.
Onde ver analytics
- Gráficos:
/analytics - Analytics compartilhados do site: dashboard Umami (self-hosted em uma VPS Hostinger)
- Snapshot JSON bruto:
https://r2.kubojs.dev/analytics-data.json - Export CSV:
https://r2.kubojs.dev/export.csv
Observações:
- Agregados são regenerados periodicamente a partir dos eventos recebidos
- Dados brutos não são expostos publicamente; a página
/analyticsapresenta apenas estatísticas resumidas
Transparência total
Um único evento por scaffold; sem IP nem identificadores de projeto. Veja o código-fonte abaixo.
Em caso de dúvida, defina BTS_TELEMETRY_DISABLED=1 e siga em frente. Você continua podendo usar todos os recursos da CLI.
Código-fonte
- Envio de eventos da CLI:
apps/cli/src/utils/analytics.ts - Lógica de toggle de telemetria:
apps/cli/src/utils/telemetry.ts - Endpoint de ingestão:
packages/backend/convex/http.ts - Backend de analytics (ingestão + agregação):
packages/backend/convex/analytics.ts