Depuração do Weblate¶
Os bugs podem se comportar como falhas na aplicação ou como um mau comportamento. É bem-vindo a coletar informações sobre qualquer problema desse tipo e enviá-las para o rasteador de problemas.
Modo de depuração¶
Ao ligar o modo de depuração, as exceções serão mostradas no navegador. Isto é útil para problemas de depuração na interface web, mas não é adequado para o ambiente de produção, pois tem consequências de desempenho e pode vazar dados privados.
Veja também
Logs do Weblate¶
Weblate pode produzir registos (logs) detalhados do que está a acontecer 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
(a depender da configuração do seu daemon syslog).
O processo de Celery (veja Tarefas de fundo a usar o Celery) normalmente produz também registos próprios. O exemplo de configurações de todo o sistema regista em vários ficheiros em /var/log/celery/
.
Os contentores Docker registam a sua saída (como é habitual no mundo Docker), por isso pode olhar para os logs a utilizar docker-compose logs
.
Veja também
Amostra de configuração contém uma configuração de LOGGING
.
Não a processar tarefas de segundo plano¶
Muitas coisas acontecem em segundo plano, workers do Celery. Caso coisas como o envio de e-mails ou remoção de componentes não funcionem, pode haver algum problema com isso.
Coisas a verificar neste caso:
Verifique se o processo do Celery está em execução, veja Tarefas de fundo a usar o Celery
Verifique o estado da fila do Celery em Interface de gestão ou use
celery_queues
Procure erros nos registos do Celery (veja Logs do Weblate)
Não a receber e-mails do Weblate¶
Pode verificar se o e-mail de saída está a funcionar corretamente a usar o comando de gestão sendtestemail
(veja Invocando comandos de gestão para instruções sobre como invocá-lo em diferentes ambientes) ou a usar Interface de gestão sob a guia Ferramentas.
Estes enviam e-mails diretamente, para que isto verifique se a sua configuração SMTP está correta (veja 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, veja Não a processar tarefas de segundo plano para depuração disso.
Análise de falhas de aplicação¶
Caso o aplicação falhar, é útil recolher o máximo de informação possível sobre a falha. A maneira mais fácil de conseguir isso é a usar serviços de terceiros que podem coletar tais informações automaticamente. Pode encontrar informações sobre como configurar isso em Coletando relatórios de erros.
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 utilizador, mas aparecem nos logs do Celery. A configuração em Coletando relatórios de erros ajuda a perceber essas falhas mais facilmente.
Problemas de desempenho¶
Caso o Weblate tenha um mau desempenho em alguma situação, por favor recolha os registos relevantes a mostrar o problema e qualquer coisa que possa ajudar a descobrir onde o código pode ser melhorado.
Caso alguns pedidos demorem muito tempo sem nenhuma indicação, pode querer instalar dogslow juntamente com Coletando relatórios de erros e obter tracebacks detalhados na ferramenta de coleta de erros.