Системный журнал
Системный журнал — это текстовый файл debug.log, в который приложение
записывает информацию о своей работе. Журнал помогает администратору
диагностировать проблемы и отслеживать важные события.
Открытие системного журнала
Предварительные условия:
- У вас есть права администратора.
Инструкция:
- Откройте раздел
/ Обслуживание /. - Нажмите
Системный журнал.
Результат: Открывается страница со списком записей журнала. Если журнал пуст — отображается пустая страница без записей.
Что записывается в журнал
Системный журнал содержит записи о работе приложения. Объём и детализация записей зависят от настройки «Режим отладки» (см. раздел «Настройка отладки»).
Записи аутентификации
При включённом режиме отладки система записывает информацию о каждом попытании входа в систему:
Записи ошибок
Система фиксирует ошибки, возникающие при работе приложения:
- Ошибки подключения к базе данных.
- Ошибки импорта данных.
- Исключения при обработке запросов.
Примечание
Без включённого режима отладки в журнал попадают только ошибки и критические события. Для подробной диагностики включите режим отладки (см. «Настройка отладки»).
Настройка отладки
Для увеличения детализации записей в журнале используйте режим отладки.
Включение отладки
- Откройте раздел
/ Обслуживание / Настройки /. - Найдите блок «Отладка».
- Установите флажок
Включить режим отладки. - Дождитесь сообщения об успешном сохранении.
Результат: Система начинает записывать подробную информацию в журнал — информацию о каждом попытании входа, найденных пользователях и результатах проверки.
Отключение отладки
После устранения неполадок обязательно отключите режим отладки:
- Откройте раздел
/ Обслуживание / Настройки /. - Снимите флажок
Включить режим отладки. - Дождитесь сообщения об успешном сохранении.
Предупреждение
Режим отладки значительно увеличивает объём журнала. Используйте его только для диагностики и отключайте после устранения проблем.
Формат записей журнала
Каждая запись в журнале содержит:
УРОВЕНЬ ДАТА-ВРЕМЯ [ПУТЬ:СТРОКА] СООБЩЕНИЕ
Пример:
INFO 2026-07-20 10:15:32,451 [accounts/backends.py:32] UserAuthBackend: user "admin" found in DB.
| Элемент | Описание |
|---|---|
| Уровень | Важность события: INFO, WARNING, ERROR, DEBUG |
| Дата и время | Момент возникновения события |
| Путь и строка | Файл и номер строки, откуда была сделана запись |
| Сообщение | Описание события |
Уровни важности
| Уровень | Когда используется |
|---|---|
INFO |
Обычные события — успешный вход, поиск пользователя |
WARNING |
Предупреждения — неверный пароль, отсутствие LDAP-сервера |
ERROR |
Ошибки — сбои подключения, исключения |
DEBUG |
Подробная отладочная информация |
Очистка системного журнала
Для удаления всех записей из журнала:
Инструкция:
- Откройте системный журнал (см. «Открытие системного журнала»).
- Нажмите кнопку
Очистить системный журнал.
Результат:
Все записи журнала удалены. Файл debug.log очищен.
Опасно
Очистка журнала необратима. Перед очисткой убедитесь, что необходимые данные сохранены.
Журнал и файлы резервных копий
При заполнении файла debug.log система автоматически создаёт
резервные копии. Старые копии удаляются при превышении лимита.
| Параметр | Значение |
|---|---|
| Максимальный размер файла | 5 МБ |
| Количество резервных копий | 7 |
Файлы журнала хранятся в каталоге logs/:
debug.log— текущий файл журнала.debug.log.1,debug.log.2, ... — резервные копии.
Связь с событиями приложения
Системный журнал (debug.log) и журнал событий приложения — это
две разные системы:
| Характеристика | Системный журнал | Журнал событий |
|---|---|---|
| Назначение | Техническая отладка | Аудит действий пользователей |
| Расположение | Файл logs/debug.log |
База данных |
| Доступ | / Обслуживание / Системный журнал |
/ События / |
| Фильтрация | Отсутствует | Фильтр по дате |
| Экспорт | Вручную (копирование текста) | Экспорт в CSV |
Для просмотра действий пользователей (добавление, перемещение, редактирование объектов) используйте раздел «События».
Устранение неполадок
Проблема: Журнал заполняется слишком быстро.
Решение:
- Отключите режим отладки после устранения неполадок.
- Проверьте, нет ли повторяющихся ошибок, которые засоряют журнал.
Проблема: Кнопка «Очистить системный журнал» не отображается.
Решение:
- Кнопка видна только при наличии записей в журнале.
- Если журнал пуст, кнопка не отображается.
Проблема: Нет доступа к системному журналу.
Решение: Убедитесь, что у вашей учётной записи есть права администратора.