Depuração do Weblate¶
Os bugs podem se comportar como falhas no aplicativo ou como vários mau comportamentos. Você é bem-vindo a coletar informações sobre qualquer problema desse tipo e enviá-las para o rastreador de problemas.
Modo de depuração¶
Ao ativar o modo de depuração, as exceções serão mostradas no navegador web. Isto é útil para problemas de depuração na interface web, mas não é adequado para o ambiente de produção porque tem consequências de desempenho e pode vazar dados particulares.
Em um ambiente de produção, use ADMINS para receber e-mails contendo relatórios de erros ou configurar a coleta de erros usando um serviço de terceiros.
Logs do Weblate¶
Weblate pode produzir registros (logs) detalhados do que está acontecendo em segundo fundo. Na configuração padrão, ele usa syslog e isso faz o log aparecer em /var/log/messages ou /var/log/syslog (dependendo da configuração do seu daemon syslog).
O processo de Celery (consulte Tarefas de fundo usando Celery) normalmente também produz seus próprios registros. O exemplo de configurações de todo o sistema registra em vários arquivos em /var/log/celery/.
Os contêineres Docker registram a sua saída (como é habitual no mundo Docker), por isso pode olhar para os logs utilizando docker compose logs. Você pode obter logs mais detalhados alterando WEBLATE_LOGLEVEL.
Ver também
Amostra de configuração contém uma configuração de LOGGING.
Não processando tarefas de segundo plano¶
Muitas coisas são feitas em segundo plano pelos workers do Celery. Se coisas como o envio de e-mails ou remoção de componentes não funcionarem, pode haver algum problema relacionado.
Coisas a verificar neste caso:
Certifique-se que o processo do Celery está em execução, consulte Tarefas de fundo usando Celery
Verifique o status da fila do Celery em Interface de gerenciamento ou usando
celery_queuesProcure erros nos registros do Celery (consulte Logs do Weblate)
Não recebendo e-mails do Weblate¶
Você pode verificar se o e-mail de saída está funcionando corretamente usando o comando de gerenciamento sendtestemail (consulte Invocando comandos de gerenciamento para instruções sobre como invocá-lo em diferentes ambientes) ou usando Interface de gerenciamento sob a aba Ferramentas.
Estes enviam e-mails diretamente, para que isto verifique se a sua configuração SMTP está correta (consulte Configuração de e-mail de saída). A maioria dos e-mails da Weblate são, no entanto, enviados em segundo plano e pode haver alguns problemas com o Celery envolvido também, consulte Não processando tarefas de segundo plano para depuração disso.
Analisando falhas de aplicativo¶
Caso o aplicativo falhe, é útil recolher o máximo de informação possível sobre a falha. Isso pode ser feito usando serviços de terceiros que podem coletar tais informações automaticamente. Você pode encontrar informações sobre como configurar isso em Coletando relatórios de erros e monitoramento do desempenho.
Falhas silenciosas¶
Muitas tarefas são descarregadas para o Celery para processamento em segundo plano. As falhas não são exibidas na interface do usuário, mas aparecem nos logs do Celery. A configuração em Coletando relatórios de erros e monitoramento do desempenho ajuda a perceber essas falhas mais facilmente.
Problemas de desempenho¶
Caso o Weblate tenha um mau desempenho em algum cenário, por favor, recolha os registos relevantes mostrando o problema, e qualquer coisa que possa ajudar a descobrir onde o código pode ser melhorado.
Consulte Coletando relatórios de erros e monitoramento do desempenho para obter informações sobre como configurar o Sentry, que pode fornecer informações úteis sobre operações com desempenho ruim.
Caso o desempenho lento esteja vinculado ao banco de dados, você também pode habilitar o log de todas as consultas do banco de dados usando a seguinte configuração após habilitar DEBUG:
LOGGING["loggers"]["django.db.backends"] = {"handlers": ["console"], "level": "DEBUG"}