Docs/ Segurança/ Telemetria e relatórios de erros

Telemetria e relatórios de erros

Estatísticas de uso e relatórios de erros: o que um servidor sh0 envia ao sh0.dev sobre si próprio, e quando.

Visão geral

As estatísticas de uso são opcionais e estão desativadas por predefinição, incluindo em servidores atualizados a partir de uma versão anterior. Até um administrador as ativar nas Definições, o servidor não envia nenhuma estatística.

O pacote de telemetria

Depois de ativadas, o servidor envia este pacote no momento da ativação e, depois, no máximo uma vez por dia. É o pacote inteiro, não um excerto:

POST https://sh0.dev/api/telemetry
{
  "schema": 1,
  "version": "1.10.3",
  "os": "linux",
  "arch": "x86_64",
  "app_count": 4
}
  • schema -- a versão do formato do pacote, hoje sempre 1.
  • version -- a versão do sh0 em execução no servidor.
  • os -- o sistema operativo (linux ou macos).
  • arch -- a arquitetura do processador (x86_64 ou aarch64).
  • app_count -- quantas aplicações o servidor executa, como número.

O endpoint do sh0.dev recusa qualquer pacote com outro campo, um campo em falta ou outra versão de formato, por isso esta lista não pode crescer sem esta página mudar.

O que nunca é enviado

O pacote não contém nenhum nome de aplicação, domínio, endereço IP, variável de ambiente, linha de registo, e-mail nem identificador de conta. O endpoint usa o endereço de envio apenas para limitar o ritmo de pedidos, em memória, e não o guarda.

Ativar e desativar

No painel, abra as Definições e procure «Estatísticas de uso anónimas». «Ver o pacote exato» mostra o pacote que o seu servidor enviaria, gerado pelo mesmo código que o envia; o botão para ativar fica desativado até o ter consultado. Desativar para imediatamente qualquer envio.

Note
As estatísticas estão desativadas por predefinição: nem uma instalação nova nem um servidor atualizado enviam um pacote de estatísticas até um administrador as ativar.

À parte do servidor, o script de instalação comunica uma vez ao sh0.dev, no momento da instalação, o sistema operativo, a arquitetura e a versão instalada. Execute-o com SH0_NO_TELEMETRY=1 para evitar essa comunicação.

Relatórios de erros

«Reportar um erro», na barra lateral do painel, envia um relatório à equipa do sh0. Escreve um título e uma descrição, e pode escolher a aplicação em causa. As últimas 200 linhas do registo só são anexadas se marcar a caixa. Antes de qualquer envio, o painel mostra o relatório exato, incluindo a versão do sh0, o sistema operativo e a arquitetura; o servidor envia depois esse relatório sem alterações.

Retenção

Os pacotes de estatísticas são armazenados em uma tabela dedicada, sem identificador de instância. Os relatórios enviados ao sh0.dev -- relatórios de bug dos servidores sh0 e relatórios do assistente de IA -- ficam em sua própria tabela. Ambos são mantidos por 12 meses e depois excluídos automaticamente todos os dias.