Pular para o conteúdo

Logs para o suporte

Quando algo trava, os logs são o caminho mais rápido até a causa: o YouniqMail registra processos, avisos e erros continuamente em arquivos, que mostram exatamente o que deu errado e quando. Um pedido de suporte com logs quase sempre poupa a pergunta “você pode descrever isso com mais detalhes?”.

O caminho mais fácil é pelo aplicativo: em Configurações → Avançado, na seção Registro de logs, ao lado de Local dos arquivos de log: está o caminho como link. Um clique nele abre a pasta.

Se o aplicativo nem sequer inicia, você chega à pasta diretamente pelo sistema de arquivos: ela fica no diretório de dados, dentro de logs:

Sistema operacional:
~/Library/Application Support/YouniqMail/logs/

No Finder: Ir → Ir para a pasta… e cole o caminho.

%APPDATA%\YouniqMail\logs\

Cole essa linha assim na barra de endereço do Explorer; o Windows resolve %APPDATA% sozinho.

~/.config/YouniqMail/logs/

O arquivo atual se chama main.log. Quando ele chega a 5 MB, vira main.old.log e um novo começa; as versões mais antigas são sobrescritas nesse processo.

Para casos persistentes, existe o nível detalhado: o interruptor Ativar registro de depuração em Configurações → Avançado. Com isso o aplicativo registra de forma muito mais detalhada, inclusive a duração de muitos processos, e fica um pouco mais lento. A sequência recomendada é:

  1. Ativar o registro de depuração.
  2. Reproduzir o problema de forma direcionada, uma vez.
  3. Reunir os logs e desativar o nível de depuração novamente.

Os logs contêm processos técnicos: registros de data e hora, mensagens de erro, IDs de contas afetadas e nomes de servidores. Senhas, tokens de acesso e chaves o YouniqMail filtra antes de gravar, e nomes de pastas são encurtados em muitos lugares. Textos e linhas de assunto de e-mails não aparecem ali, mas endereços de e-mail podem aparecer. Dê uma olhada rápida antes de enviar, se isso for importante para você; os arquivos são texto comum.

Envie o main.log (se o problema foi reproduzido recentemente, ele já basta; senão, também o main.old.log) junto com três informações:

  • O que você fez? (“busquei a conta X”, “abri um e-mail com anexo grande”)
  • O que aconteceu, e o que você esperava?
  • Desde quando? (“depois da atualização”, “desde a troca de provedor”)

Também ajuda um relatório de diagnóstico: em Configurações → Importar / Exportar, na seção Relatar um problema, Exportar relatório de diagnóstico cria um arquivo com a versão do aplicativo, o sistema operacional, estatísticas do banco de dados (só contagens) e a estrutura anonimizada das suas regras. Conteúdos de e-mails, contatos e senhas não estão incluídos.

Com isso, a investigação costuma ser rápida na maioria dos casos.