Debugowanie Weblate¶
Bugs can behave as application crashes or as misbehavior. You are welcome to collect info on any such issue and submit it to the issue tracker.
Tryb diagnozowania błędów¶
Turning on debug mode will make the exceptions show in the browser. This is useful to debug issues in the web interface, but not suitable for production environment as it has performance consequences and might leak private data.
Zobacz także
Dzienniki logówweblate¶
Weblate can produce detailed logs of what is going in the background. In
the default configuration it uses syslog and that makes the log appear either in
/var/log/messages
or /var/log/syslog
(depending on your syslog
daemon configuration).
The Celery process (see Zadania w tle korzystające z Celery) usually produces own logs as well. The
example system-wide setups log to several files under /var/log/celery/
.
Docker containers log to their output (as usual in the Docker world), so
you can look at the logs using docker-compose logs
.
Zobacz także
Przykładowa konfiguracja zawiera LOGGING
konfiguracja.
Not processing background tasks¶
Lot of things happen in background Celery workers. In case things like sending out e-mails or component removal does not work, there might be some issue with it.
Rzeczy do sprawdzenia w tym przypadku:
Sprawdź, czy proces Celery jest uruchomiony, zobacz Zadania w tle korzystające z Celery
Check Celery queue status either in Interfejs zarządzania or using
celery_queues
Look into Celery logs for errors (see Dzienniki logówweblate)
Nie otrzymuję e-maili od Weblate¶
You can verify whether outgoing e-mail is working correctly by using the
sendtestemail
management command (see Wywoływanie poleceń zarządzania
for instructions on how to invoke it in different environments) or using
Interfejs zarządzania under the Tools tab.
These send e-mail directly, so this verifies that your SMTP configuration is correct (see Konfigurowanie poczty wychodzącej). Most of the e-mails from Weblate are however sent in the background and there might be some issues with Celery involved as well, please see Not processing background tasks for debugging that.
Analiza awarii aplikacji¶
In case the application crashes, it is useful to collect as much info about the crash as possible. The easiest way to achieve this is by using third-party services which can collect such info automatically. You can find info on how to set this up in Zbieranie raportów o błędach.
Ciche błędy¶
Lots of tasks are offloaded to Celery for background processing. Failures are not shown in the user interface, but appear in the Celery logs. Configuring Zbieranie raportów o błędach helps you to notice such failures easier.
Problemy z wydajnością¶
In case Weblate performs badly in some situation, please collect the relevant logs showing the issue, and anything that might help figuring out where the code might be improved.
In case some requests take too long without any indication, you might want to install dogslow along with Zbieranie raportów o błędach and get pinpointed and detailed tracebacks in the error collection tool.