Діагностика у Weblate

Bugs can behave as application crashes or as various misbehavior. You are welcome to collect info on any such issue and submit it to the issue tracker.

Режим зневадження

Turning on debug mode will make the exceptions show in the web browser. This is useful to debug issues in the web interface, but not suitable for a production environment because it has performance consequences and might leak private data.

In a production environment, use ADMINS to receive e-mails containing error reports, or configure error collection using a third-party service.

Дивись також

Вимкнути режим діагностики, Належне налаштовування записів адміністраторів, Збирання звітів щодо помилок

Журнали Weblate

Weblate can produce detailed logs of what is going on 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 Фонові завдання з використанням Celery) usually produces its own logs as well. The example system-wide setups logs to several files under /var/log/celery/.

Docker containers log to their output (as per usual in the Docker world), so you can look at the logs using docker-compose logs.

Дивись також

Зразок налаштувань містить налаштування LOGGING.

Фонові завдання не обробляються

A lot of things are done in the background by Celery workers. If things like sending out e-mails or component removal does not work, there might a related issue.

Речі, які слід перевірити у цьому випадку:

• Check that the Celery process is running, see Фонові завдання з використанням Celery

• Check the Celery queue status, either in Інтерфейс керування, or using celery_queues

• Look in the Celery logs for errors (see Журнали Weblate)

Не надходять повідомлення електронної пошти від Weblate

You can verify whether outgoing e-mail is working correctly by using the sendtestemail management command (see Виклик команд керування for instructions on how to invoke it in different environments) or by using Інтерфейс керування under the Tools tab.

These send e-mails directly, so this verifies that your SMTP configuration is correct (see Налаштовування вихідної електронної пошти). 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 Фонові завдання не обробляються for debugging that.

Аналіз аварійних завершень програми

In case the application crashes, it is useful to collect as much info about the crash as possible. This can be achieved by using third-party services which can collect such info automatically. You can find info on how to set this up in Збирання звітів щодо помилок.

Помилки без повідомлень

Багато завдань покладаються на Celery для забезпечення фонової обробки. Дані аварійних завершень роботи таких завдань не буде показано в інтерфейсі користувача, а буде записано до журналу Celery. Налаштовування збирання помилок спростить діагностику таких помилок.

Проблеми із швидкодією

In case Weblate performs badly in some scenario, please collect the relevant logs showing the issue, and anything that might help figuring out where the code might be improved.

Якщо певні запити виконуються надто довго без додаткової індикації, вам варто встановити dogslow і Збирання звітів щодо помилок і отримати точні та докладні трасування за допомогою засобу збирання даних помилок.