Отчёты и система
Состояние сервера и проверка системы
Встроенный монитор показывает нагрузку оборудования и базы данных, а самодиагностика по кнопке проверяет вход, выдачу талона, вызов, печать, озвучку, экраны, отчёты и служебные модули.
Мониторинг
Система → Состояние сервера обновляется автоматически. Цветовая индикация: зелёный — норма, жёлтый — внимание, красный — критично.
| Блок | Что показывает |
|---|---|
| Процессор | Загрузка по load average за 15 минут, число ядер, давление на CPU. |
| Память | Использование ОЗУ, доступный объём, потребление процессов. |
| Диски | Занятое место, свободное место, SMART-показатели (наработка, TBW), IOPS. |
| Сеть | Активность интерфейсов и доступность сервисов. |
| PostgreSQL | Пул соединений, кэш, транзакции, блокировки, долгие запросы, autovacuum, чекпоинты, размеры таблиц. |
| WebSocket | Количество подключённых экранов и панелей. |
| Очередь | Сколько ожидают, сколько просрочено, среднее время ожидания. |
| Сервис | Время запуска, OOM, перезапуски, версия приложения. |
Расширенный мониторинг
Кнопка на странице «Состояние сервера» открывает /admin/system2 — расширенный дашборд из 15 карточек. Он обновляется раз в 15 секунд, показывает те же базовые показатели, что и обычная страница, и добавляет детальную телеметрию. Отдельный пункт в меню не создаётся: доступ — по праву на раздел «Система».
| Группа карточек | Что показывает |
|---|---|
| Система | Процессор по режимам, частота и температура, троттлинг, память (swap, кэш, HugePages, ECC), давление PSI, охлаждение и питание, файловые системы и inodes, диски и SMART, IOPS и задержки, сеть и TCP, оборудование, ядро и лимиты, процессы. |
| Приложения | Node.js (event loop, heap, RSS, рестарты), Nginx (запросы и ошибки), HTTP API (запросы в секунду, p50/p95/p99), PostgreSQL (WAL, репликация, блокировки, ожидания). |
Сверху — вердикт, обзорные плитки и список «Требуют внимания» со ссылками на нужную карточку. Кнопка JSON копирует полный снимок метрик: его удобно сохранить и приложить к обращению в поддержку. Расширенная страница не запускает самодиагностику — проверка остаётся только на обычной странице и только по кнопке.
Публичная демонстрация мониторинга
Для показа метрик без входа в админку предусмотрена ссылка
/s/<токен> и API
/api/public/system/<токен>/metrics. Токен задаёт
администратор; страница не индексируется поисковиками, ответ кэшируется на
5 секунд.
Проверка системы
На той же странице есть блок «Проверить систему». Один запуск выполняет 19 групп и 116 проверок примерно за минуту (жёсткий предел — 3 минуты).
- Вход и сессии, роли и права.
- Выдача талона, вызов, обслуживание, статусы.
- Принтеры и печать, шаблоны чеков.
- Озвучка и звуковые файлы.
- Терминалы, табло, зоны, LED-табло.
- Отчёты и дашборд.
- Чат, доски задач, календарь.
- Резервные копии, обновления, лицензия.
- Служебные скрипты и база данных.
Результат формулируется простым языком: «всё работает» или понятное пояснение, что именно не так. Технические детали скрыты за кнопкой «Подробнее». Последний результат сохраняется и виден после перезапуска сервера.
Когда запускать проверку
- После первоначальной настройки — перед запуском в зал.
- После обновления системы.
- При жалобе «не печатает», «не слышно», «табло пустое».
- Перед важным днём или проверкой.
- Периодически — раз в неделю или месяц, в зависимости от нагрузки.
Что делать с результатом
| Результат | Действия |
|---|---|
| Всё зелёное | Ничего. Сохраните результат как точку отсчёта. |
| Предупреждение | Откройте «Подробнее», проверьте соответствующий раздел документации. |
| Ошибка печати | Печать талонов: принтер, режим, тест. |
| Ошибка озвучки | Озвучивание: файлы, громкость, настройки табло. |
| Ошибка терминалов или табло | Зоны, адреса устройств, доступность по сети. |
| Ошибка базы или сервера | Проверьте место на диске, память, журналы процесса; при необходимости обратитесь к администратору. |
| Повторяющаяся ошибка | Приложите время проверки и подробный лог при обращении в поддержку. |
Проверка готовности сервера
Для внешнего мониторинга и диагностики есть два адреса без авторизации:
| Адрес | Что возвращает |
|---|---|
GET /api/health | 200, пока процесс сервера жив; минимальная проверка для балансировщика. |
GET /api/ready | 200, когда система готова к работе, иначе 503 и поле phase: boot → database → migrations → license → services → ready. |
Если экран долго показывает «Система запускается», проверьте именно
/api/ready: поле phase подскажет, на каком этапе
старта остановился сервер.
Профилактика
- Свободное место на диске не меньше 10–15%.
- Резервные копии создаются и проверяются.
- Обновления устанавливаются после проверки.
- Журнал действий не разрастается без меры.
- Сервер автоматически перезапускает процессы после сбоя.