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

Вади можуть проявлятися як аварійні завершення роботи програми або помилкова поведінка програми. Ми будемо раді, якщо ви зберете будь-які дані щодо вади та надасте їх у нашій системі стеження за вадами.

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

Вмикання діагностичного режиму призведе до показу виключень у браузері. Це корисно для діагностування проблем у вебінтерфейсі, але є неприйнятним для промислового середовища, оскільки призводить до погіршення швидкодії та може призвести до витоку конфіденційних даних.

Журнали Weblate

Weblate може створювати докладні журнали із записами того, що відбувається за лаштунками. За типових налаштувань програма використовує журнал системи, і те, з чого складається журнал записується або до /var/log/messages, або до /var/log/syslog (залежно від налаштувань фонової служби системного журналу у вашій системі).

Процес Celery (див. Фонові завдання з використанням Celery) зазвичай створює власний журнал. У прикладі загальносистемного налаштовування журнал записується до декількох файлів у каталозі /var/log/celery/.

Контейнери Docker записують виведені дані (це є звичною практикою у царині Docker), отже ви можете ознайомитися із журналом за допомогою команди docker-compose logs.

Дивись також

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

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

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

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

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

Ви можете перевірити, чи працює вихідна пошта належним чином, за допомогою команди керування sendtestemail (див. Виклик команд керування, щоб ознайомитися із настановами щодо того, як викликати її у різних середовищах) або за допомогою інтерфейсу керування на вкладці Знаряддя.

Ці засоби надсилають повідомлення електронної пошти безпосередньо, тому це підтверджує, що ваші налаштування SMTP є правильними (див. Налаштовування вихідної електронної пошти). Втім, більшу частину повідомлень від Weblate надсилають у фоновому режимі, тому проблеми може бути пов’язано із Celery. Опис діагностики Celery наведено у розділі Фонові завдання не обробляються.

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

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

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

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

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

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

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