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 privados.
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 (veja 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
.
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, veja Tarefas de fundo usando Celery
Verifique o status da fila do Celery em Interface de gerenciamento ou usando
celery_queues
Procure erros nos registros do Celery (veja 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
(veja 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 (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 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.
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 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.
Caso alguns pedidos demorem muito tempo sem nenhuma indicação, você pode querer instalar dogslow juntamente com Coletando relatórios de erros e obter tracebacks detalhados na ferramenta de coleta de erros.
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"}