Мониторинг — справка по компоненту

Назначение

Мониторинг — обязательное ядро системы Принтум. Отвечает за обнаружение устройств, сбор данных, управление пользователями, отчёты, интеграции и управление конфигурацией всех ПринтМенеджеров.

Основные функции

Обнаружение принтеров и МФУ по SNMP
Сбор счётчиков, состояния расходных материалов и запчастей
Отслеживание статусов и ошибок устройств
Управление пользователями, ролями, лицензиями
Формирование отчётов и подписок
Интеграция с доменами и почтовым сервером
Единый интерфейс в виде Личного кабинета для конфигурации всех ПринтМенеджеров

Где настраивается

Личный кабинет — основной интерфейс
Панель администратора Мониторинга:

https://<адрес>:8001/config/

Учётные данные по умолчанию

Логин: printum / Пароль: printum

Путь установки и ключевые файлы

Файл	Назначение
/opt/printum/.env	Переменные окружения
/opt/printum/.version	Версия Мониторинга
/opt/printum/docker-compose.yml	Docker-стек
/opt/printum/logs.sh	Скрипт сбора логов
/opt/printum/backup.sh	Скрипт создания бэкапа

Что важно для диагностики

Сбор логов: bash /opt/printum/logs.sh
Версия: cat /opt/printum/.version

Что проверить перед эскалацией

Версию Мониторинга
Статус контейнеров (активны, неактивны, перезапускаются): docker-compose ps
Свободное место на диске: df -h /
Сетевую доступность между компонентами

Когда используется

Мониторинг является обязательным компонентом во всех поставках Printum. Он устанавливается первым и служит центральным узлом управления: управляет пользователями и устройствами, агрегирует статистику распределённых филиальных сетей, обеспечивает интеграцию с внешними системами.

Единственный сервер — конфигурация «Сингл».
Вместе с ПринтМенеджером на отдельных серверах — конфигурация «Сплит».
С кластером ПринтМенеджеров и балансировщиком — конфигурация «Кластер Active-Active».

Связанные компоненты

Сетевой агент — мониторинг сетевых устройств по SNMP; устанавливается автоматически вместе с Мониторингом.
Локальный агент — мониторинг локально подключённых устройств (USB).
ПринтМенеджер — подключается к Мониторингу, синхронизируется раз в час.
PostgreSQL — основная БД Мониторинга.
ClickHouse — хранилище сырых snmp-данных устройств.
Redis — кэш и очередь задач.
Docker — среда выполнения всех контейнеров.

Типовые проблемы

Проблема	Причина	Решение
Timeout error при установке	Неверно указана переменная MON_HOSTNAME или нет разрешения доменного имени с DNS	1. Проверить корректность записи доменного имени в переменной MON_HOSTNAME. 2. Проверить разрешение имени сервера в DNS. 3. Запустить установку повторно.
Конфликт адресов Docker после установки	Диапазон 10.28.32.0/26 пересекается с локальной сетью	Указать другой пул адресов Docker в /etc/docker/daemon.json и перезапустить Docker
Обнаружены не все устройства	Неверный IP в локации, SNMP отключён, агент не опрашивает локацию	Проверить IP локации, статус SNMP командой snmpwalk, настройки агента в Настройки → Модули
Ошибка обновления: network has active endpoints	Контейнер занимает сеть во время обновления	Перезагрузить сервер и запустить обновление повторно

Расширенные возможности Мониторинга

Произвольные OID и гибкий SNMP-опрос

Система поддерживает произвольный набор OID — она может собирать любые параметры, которые устройства отдают по SNMP. Это счётчики, уровень расходных материалов, ошибки, температура, скорость печати и т.д. Стандартный набор OID покрывает большинство задач, но администратор может расширить его для специфических моделей или требований.

Точность данных при работе с Локальным агентом

Когда используется Локальный агент для мониторинга USB-принтеров, следует учитывать особенности точности данных:

Драйверы иногда некорректно оценивают цветность: документ с чёрным текстом может быть помечен как цветной, если пользователь не изменил параметры перед отправкой.
Принтум старается корректировать такие ошибки (например, исключает цветность для монохромных принтеров), но стопроцентной точности гарантировать невозможно.
Инженеры могут регулярно сверять счётчики устройств и вносить корректировки в накопленную статистику.

Справочники запчастей и прогнозирование замены

Система поставляется с базой запчастей и материалов для распространённых моделей принтеров. Администратор может дополнять справочники вручную или попросить поддержку дополнить их при появлении новых устройств. Благодаря этому Мониторинг может прогнозировать замену деталей даже для устройств, которые сами не отслеживают расходники.

Интеграция с ПринтМенеджером

При настройке интеграции ПринтМенеджер автоматически получает от Мониторинга данные по целевым устройствам и пользователя без ручного ввода. В обратную сторону ПринтМенеджер возвращает статистику по заданиям, теневым копиям, квотам и событиям.