Системные журналы
Назначение
Модуль «Системные журналы» показывает работу системы в реальном времени: какие запросы обрабатываются, какие модули загружены, какие ошибки возникают, как взаимодействуют компоненты. Это основной инструмент диагностики для инженеров и администраторов.
Журналы полезны в трёх ситуациях: 1. Что-то не работает — найти причину ошибки 2. Что-то работает медленно — понять, где задержка 3. Нужно убедиться, что система работает штатно — проконтролировать активность
Возможности
► Просмотр журналов работы системы в реальном времени
► Настраиваемый интервал обновления (частота опроса)
► Фильтрация по уровню серьёзности: информация, предупреждение, ошибка
► Фильтрация по ключевым словам
► Автоматическая прокрутка к новым записям
► Цветовая индикация уровней серьёзности
► Ограничение количества отображаемых записей для экономии ресурсов
Как пользоваться
Сценарий 1: Проверить, что система работает штатно
- Откройте модуль «Системные журналы» из боковой панели.
- Вы увидите ленту записей, которая обновляется автоматически.
- Нормальная работа системы выглядит так:
- Периодические записи уровня «Информация» (серый цвет): загрузка данных, обработка запросов, обновление статусов
- Отсутствие записей уровня «Ошибка» (красный цвет)
- Редкие записи уровня «Предупреждение» (жёлтый цвет) — допустимы, если они не повторяются массово
- Если лента обновляется и нет ошибок — система работает штатно.
Сценарий 2: Найти причину ошибки
- Пользователь сообщает о проблеме: «Не открывается аналитика» или «Чат не отвечает».
- Откройте «Системные журналы».
- Нажмите кнопку «Фильтр» и выберите уровень «Ошибка».
- В ленте останутся только записи с ошибками.
- Найдите запись, соответствующую времени, когда возникла проблема.
- Прочитайте текст ошибки:
- Если ошибка связана с базой данных — проверьте подключение в конфигураторе
- Если ошибка связана с языковой моделью — проверьте доступность интернета и ключи
- Если ошибка связана с модулем — проверьте, включён ли модуль в конфигураторе
- Если ошибка повторяется регулярно — это признак системной проблемы, требующей вмешательства.
Сценарий 3: Настроить частоту обновления
- В верхней части модуля найдите настройку «Интервал обновления».
- Выберите частоту:
- 1 секунда — для детальной диагностики (высокая нагрузка)
- 2 секунды — оптимально для большинства случаев
- 5 секунд — для экономии ресурсов при длительном мониторинге
- Изменения применяются немедленно.
Сценарий 4: Найти конкретную запись по ключевому слову
- В верхней части модуля найдите поле «Поиск».
- Введите ключевое слово: например,
database,timeout,error,loading. - В ленте останутся только записи, содержащие указанное слово.
- Это помогает быстро найти нужную запись среди сотен других.
Сценарий 5: Отследить загрузку модулей при старте системы
- Перезапустите систему:
stop.bat→start.bat. - Сразу откройте «Системные журналы».
- В ленте вы увидите последовательность записей:
- Инициализация ядра системы
- Загрузка модулей (по одному)
- Подключение к базе данных
- Запуск веб-сервера
- Сообщение о готовности системы
- Если какой-то модуль не загрузился или загрузка заняла слишком много времени — вы это увидите.
Что вы видите на экране
Структура экрана «Системные журналы»:
Верхний блок управления - Кнопка «Пауза» / «Возобновить»: остановить или возобновить автоматическую прокрутку - Выбор уровня фильтрации: Все / Информация / Предупреждение / Ошибка - Поле поиска по ключевым словам - Настройка интервала обновления: 1с / 2с / 5с - Настройка максимального количества записей: 100 / 500 / 1000
Лента записей - Каждая запись содержит: - Время: часы, минуты, секунды, миллисекунды - Уровень: Информация / Предупреждение / Ошибка (с цветной меткой) - Источник: модуль или компонент системы, сгенерировавший запись - Текст: описание события
Цветовая индикация уровней
| Уровень | Цвет | Что означает | Пример |
|---|---|---|---|
| Информация | Серый | Штатная работа | «Загрузка модуля аналитики завершена» |
| Предупреждение | Жёлтый | Нештатная ситуация, не критичная | «Время ответа базы данных превысило 2 секунды» |
| Ошибка | Красный | Сбой, требующий внимания | «Не удалось подключиться к базе данных: неверный пароль» |
Индикатор состояния - В верхней части: «Обновление активно» или «Пауза» - Счётчик записей: сколько записей в текущей ленте
Практические советы
Проверяйте журналы после перезапуска системы. Первые 30 секунд после запуска показывают, все ли модули загрузились корректно. Если есть ошибки загрузки — они будут видны сразу.
Используйте фильтр по уровню «Ошибка» для быстрой диагностики. Если пользователь сообщает о проблеме, первым делом откройте журналы с фильтром «Ошибка» — это сэкономит время.
Не оставляйте интервал 1 секунда надолго. Высокая частота обновления нагружает браузер и может замедлить работу интерфейса. Для длительного мониторинга используйте 5 секунд.
Обращайте внимание на повторяющиеся предупреждения. Единичное предупреждение — это нормально. Если одно и то же предупреждение повторяется каждые несколько минут — это признак проблемы, которую нужно решить.
Используйте поиск для точечной диагностики. Если вы знаете, что проблема связана с базой данных, введите в поиск database или postgres и увидите все связанные записи.
Журналы не сохраняются между перезапусками. При перезапуске системы лента журналов очищается. Если нужно сохранить информацию об ошибке, сделайте снимок экрана или скопируйте текст записи до перезапуска.
Частые вопросы и ответы
Вопрос: В журналах много записей, я не могу найти нужную. Что делать? Используйте фильтры: 1. Выберите уровень «Ошибка» или «Предупреждение» 2. Введите ключевое слово в поле поиска 3. Уменьшите интервал обновления до 5 секунд, чтобы лента не «убегала» Если нужно найти запись за конкретное время, обратите внимание на временные метки слева.
Вопрос: В журналах появилась ошибка, но система продолжает работать. Это нормально? Да, не все ошибки критичны. Например, ошибка «не удалось получить данные за прошлый месяц» может означать, что данных просто нет в базе, но система продолжает работать с текущими данными. Критичны ошибки, которые повторяются регулярно или связаны с базой данных и модулями.
Вопрос: Можно ли очистить журналы? Журналы очищаются автоматически при перезапуске системы. Ручная очистка ленты не предусмотрена, но вы можете уменьшить количество отображаемых записей (до 100), чтобы снизить нагрузку.
Вопрос: Кто может просматривать журналы? Просмотр журналов доступен пользователям с правами администратора и инженера. Пользователи с правами оператора и руководителя не имеют доступа к журналам.
Вопрос: Журналы показывают работу всех модулей? Да. В ленте отображаются записи от всех активных модулей: ядро системы, база данных, языковая модель, модули аналитики, здоровья, энергоучёта. Каждая запись содержит метку источника, по которой можно определить, какой модуль её сгенерировал.
Вопрос: Можно ли экспортировать журналы в файл? В текущей версии экспорт журналов в файл не поддерживается. Для сохранения информации используйте снимок экрана или копирование текста записей.