Мониторинг — справка по компоненту
Назначение
Мониторинг — обязательное ядро системы Принтум. Отвечает за обнаружение устройств, сбор данных, управление пользователями, отчёты, интеграции и управление конфигурацией всех ПринтМенеджеров.
Основные функции
- Обнаружение принтеров и МФУ по SNMP
- Сбор счётчиков, состояния расходных материалов и запчастей
- Отслеживание статусов и ошибок устройств
- Управление пользователями, ролями, лицензиями
- Формирование отчётов и подписок
- Интеграция с доменами и почтовым сервером
- Master-сервер конфигурации для всех ПринтМенеджеров
Где настраивается
- Личный кабинет — основной интерфейс
- Панель администратора Мониторинга: 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 | Резервное копирование |
Что важно для диагностики
- Логи: cd /opt/printum && docker-compose logs -f --tail=100
- Сбор логов: bash /opt/printum/logs.sh
- Версия: cat /opt/printum/.version
Что проверить перед эскалацией
- Версию Мониторинга
- Статус контейнеров: docker-compose ps
- Свободное место на диске
- Сетевую доступность между компонентами
Связанные страницы
- Обзор системы Принтум
- Синхронизация Мониторинга и ПринтМенеджера
- Сетевой агент — справка по компоненту
Когда используется
Мониторинг является обязательным компонентом во всех поставках Printum. Он устанавливается первым и служит центральным узлом управления: управляет пользователями и устройствами, агрегирует статистику распределённых филиальных сетей, обеспечивает интеграцию с внешними системами.
- Единственный сервер — конфигурация «Сингл».
- Вместе с ПринтМенеджером на отдельных серверах — конфигурация «Сплит».
- С кластером ПринтМенеджеров и балансировщиком — конфигурация «Кластер Active-Active».
Связанные компоненты
- Сетевой агент — мониторинг сетевых устройств по SNMP; устанавливается автоматически вместе с Мониторингом.
- Локальный агент — мониторинг локально подключённых устройств (USB).
- ПринтМенеджер — подключается к Мониторингу, синхронизируется раз в час.
- PostgreSQL — основная БД Мониторинга (версия 4.0 и выше).
- ClickHouse — хранилище аналитических данных.
- Redis — кэш и очередь задач.
- Docker — среда выполнения всех контейнеров.
Типовые проблемы
| Проблема | Причина | Решение |
|---|---|---|
| Timeout error при установке | Неверно указана переменная MON_HOSTNAME | Проверить IP или доменное имя в переменной MON_HOSTNAME и запустить установку повторно |
| Конфликт адресов 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-принтеров, следует учитывать особенности точности данных:
- Драйверы иногда некорректно оценивают цветность: документ с чёрным текстом может быть помечен как цветной, если пользователь не изменил параметры перед отправкой.
- Принтум старается корректировать такие ошибки (например, исключает цветность для монохромных принтеров), но стопроцентной точности гарантировать невозможно.
- Инженеры могут регулярно сверять счётчики устройств и вносить корректировки в накопленную статистику.
Справочники запчастей и прогнозирование замены
Система поставляется с базой запчастей и материалов для распространённых моделей принтеров. Администратор может дополнять справочники вручную или попросить поддержку дополнить их при появлении новых устройств. Благодаря этому Мониторинг может прогнозировать замену деталей даже для устройств, которые сами не отслеживают расходники. Есть возможность отслеживать состояние всех ресурсных элементов, в том числе тех, что принтер сам не отслеживает, благодаря встроенным справочникам запчастей.
Интеграция с ПринтМенеджером
При настройке интеграции ПринтМенеджер автоматически «видит» все устройства, найденные Мониторингом, и не требует ручного ввода. Мониторинг также передаёт в ПринтМенеджер атрибуты пользователей для авторизации. В обратную сторону ПринтМенеджер возвращает статистику по заданиям, теневым копиям, квотам и событиям.