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?”.
Abrir a pasta de logs
Seção intitulada “Abrir a pasta de logs”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:
~/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.
Registro de depuração
Seção intitulada “Registro de depuração”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 é:
- Ativar o registro de depuração.
- Reproduzir o problema de forma direcionada, uma vez.
- Reunir os logs e desativar o nível de depuração novamente.
O que está nos logs, e o que não está
Seção intitulada “O que está nos logs, e o que não está”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.
Enviar ao suporte
Seção intitulada “Enviar ao suporte”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.