Depuração do Weblate

Os bugs podem se comportar como falhas no aplicação ou como vários mau comportamentos. É 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.

Num ambiente de produção, use ADMINS para receber e-mails que conteem relatórios de erros ou configurar a coleta de erros a usar um serviço de terceiros.

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 também produz os próprios registos. 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 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:

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 a aplicação falhe, é útil recolher o máximo de informação possível sobre a falha. Isso pode ser feito 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 algum cenário, 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.

In case the slow performance is linked to the database, you can also enable logging of all database queries using following configuration after enabling DEBUG:

LOGGING["loggers"]["django.db.backends"] = {"handlers": ["console"], "level": "DEBUG"}