Справочник контейнеров — когда и что смотреть в логах

Контейнеры Мониторинга Команды выполняются из директории /opt/printum . Контейнер Описание Когда анализировать (симптомы) Цель анализа Команда printum_nginx HTTP-сервер и обратный прокси-сервер. Проксирует все HTTP-соединения от/до приложения, отдаёт статику. Ошибки при загрузке Личного кабинета или он не загружается. Ошибки при загрузке панели администратора Мониторинга или она не загружается. Принтеры не добавляются в Мониторинг или не обновляют данные. Не происходит синхронизация между Мониторингом и ПринтМенеджером. Выявить какие именно URL вызывают ошибки. Выявить коды ошибок. Выявить коды ошибок при запросах от сетевого агента. Выявить коды ошибок при запросах от ПринтМенеджера. cd /opt/printum docker-compose logs -f --tail=200 printum_nginx printum_dashboard Логи Личного кабинета. При загрузке Личного кабинета происходят ошибки. Пользователь не может открыть страницу ЛК в браузере. Выявить какие именно URL вызывают ошибки. Выявить коды ошибок. Выявить какой IP-адрес пытается получить данные. cd /opt/printum docker-compose logs -f --tail=200 printum_dashboard printum_worker-default printum_worker-high printum_worker-low Воркеры мониторинга. Три очереди Celery для выполнения фоновых задач: отправка писем, обработка данных от принтеров. Проблемы с отправкой писем. Проблемы с обработкой данных от принтеров. Не обновляется статус принтера. Не обновляется история замен. Проблемы с синхронизацией Мониторинга и ПринтМенеджера. Не обновляется информация по принтерам. Не загружаются справочники. Не приходят уведомления на почту. Данные в Мониторинге появляются с большой задержкой. Фоновые операции выполняются нестабильно или не завершаются. Выявить в какое время была запущена очередная задача. Выявить в какое время была завершена очередная задача. Выявить время выполнения задачи. Выявить наличие ошибок по периодическим задачам. cd /opt/printum docker-compose logs -f --tail=200 printum_worker-default docker-compose logs -f --tail=200 printum_worker-high docker-compose logs -f --tail=200 printum_worker-low printum_scheduler Планировщик задач для Celery. Выполняет задачи мониторинга по расписанию. Не выполняются задачи по расписанию (например, не запускается синхронизация с доменом). Не приходят уведомления на почту. Не обновляются данные, которые должны обновляться по расписанию. Выявить, запускается ли задача по расписанию. Выявить ошибки планировщика при постановке задач в очередь. cd /opt/printum docker-compose logs -f --tail=200 printum_scheduler printum_backend API мониторинга. Все не фоновые задачи. Не работает отправка писем. Проблемы с созданием локаций. Проверка обмена данными с Локальным агентом. Ошибки при работе Личного кабинета (действия не выполняются). Выявить ошибки обработки API-запросов. Определить причины возврата кодов 4xx/5xx. Выявить некорректные входные данные запросов. Определить, на каком этапе происходит ошибка (валидация / логика / БД). cd /opt/printum docker-compose logs -f --tail=200 printum_backend printum_clickhouse Столбцовая система управления базами данных. Обычно смотреть не нужно. Проверка запуска сервиса. Наличие ошибок запуска БД. Проверить наличие ошибок запуска БД. cd /opt/printum docker-compose logs -f --tail=200 printum_clickhouse printum_redis Брокер сообщений мониторинга. Проверка запуска сервиса. Наличие ошибок запуска сервиса. Проверить наличие ошибок запуска сервиса. cd /opt/printum docker-compose logs -f --tail=200 printum_redis printum_postgres База данных мониторинга. Проверка запуска сервиса. Наличие ошибок запуска БД. Проверить наличие ошибок запуска БД. cd /opt/printum docker-compose logs -f --tail=200 printum_postgres Контейнеры ПринтМенеджера Команды выполняются из директории /opt/printmanager . Контейнер Описание Когда анализировать (симптомы) Цель анализа Команда printmanager_web Админка ПринтМенеджер, nginx. Проксирует все HTTP-соединения для ПринтМенеджера. Не происходит синхронизация между Мониторингом и ПринтМенеджером. Выявить какие именно URL вызывают ошибки. Выявить коды ошибок. cd /opt/printmanager docker-compose logs -f --tail=200 printmanager_web printmanager-celery Все фоновые задачи ПринтМенеджер. Обрабатывает интеграцию с Мониторингом, задания печати, встроенные приложения. Не импортируются принтеры из Мониторинга. Не отправляется статистика печати в Мониторинг. Задания печатаются с большой задержкой или не печатаются вовсе. Печатается только часть задания. Ошибки установки или деинсталляции встроенного приложения. Выявить ошибки при интеграции с Мониторингом. Выявить ошибки при печати заданий. Выявить ошибки при установке встроенного приложения. Выявить ошибки при соединении с CUPS. cd /opt/printmanager docker-compose logs -f --tail=200 printmanager-celery printmanager-celery-print-queue Очередь бесклиентской печати. Проверяет CUPS на наличие новых заданий и отправляет их на обработку и печать. Задания не попадают в очередь печати или попадают с большой задержкой. Выявить ошибки соединения с CUPS. Выявить ошибки при обработке заданий из CUPS. Выявить ошибки соединения с принтерами. cd /opt/printmanager docker-compose logs -f --tail=200 printmanager-celery-print-queue printmanager-scheduler Планировщик задач для Celery ПринтМенеджер. Механизм отправки задач по расписанию. Задания перестали приходить в очередь печати. Задания гостевой печати перестали приходить в очередь. Задания печати через почту перестали приходить в очередь. У заданий образы документов не появляются. Выявить, запускается ли задача по расписанию. Выявить ошибки планировщика при постановке задач в очередь. cd /opt/printmanager docker-compose logs -f --tail=200 printmanager-scheduler printmanager-app Основной контейнер ПринтМенеджер. Django-приложение административной панели. Обрабатывает все HTTP-обращения, принтеры, клиентов. Проблемы с печатью / копированием / сканированием. Проблемы с авторизацией. Задания не приходят на устройство, хотя в ПринтМенеджере есть. Проверка обмена данными с Клиентом ПМ. Выявить ошибки обработки API-запросов. Определить причины возврата кодов 4xx/5xx. Выявить некорректные входные данные запросов. Определить, на каком этапе происходит ошибка (валидация / логика / БД). cd /opt/printmanager docker-compose logs -f --tail=200 printmanager-app printmanager-converter-server TCP-конвертер-сервер. Принимает запросы по TCP и передаёт их в app по HTTP. Проблемы с авторизацией по TCP. Выявить, приходит ли сообщение от конвертера. Выявить какой номер карты приходит от конвертера. cd /opt/printmanager docker-compose logs -f --tail=200 printmanager-converter-server printmanager-ftpd Временное хранилище для обмена файлами сканирования/копирования с принтерами. Проблема с заданием копирования (сканирование выполнялось, но документ не распечатался). Задание сканирования не появилось в ПринтМенеджер или нет его образа. Выявить ошибки при выполнении процесса обработки образа документа заданий сканирования и копирования. cd /opt/printmanager docker-compose logs -f --tail=200 printmanager-ftpd printmanager-db База данных ПринтМенеджера. Проверка запуска сервиса. Наличие ошибок запуска БД. Проверить наличие ошибок запуска БД. cd /opt/printmanager docker-compose logs -f --tail=200 printmanager-db printmanager-cups Контейнер сервера печати. Обрабатывает всю отложенную печать (клиентская, бесклиентская, через почту). Задания не распечатываются. Недоступна панель CUPS по порту 1631. Выявить ошибки работы сервиса. Выявить ошибки принтеров в CUPS. Примечание: Unable to encrypt connection: A TLS fatal alert has been received. — не является ошибкой системы. cd /opt/printmanager docker-compose logs -f --tail=200 printmanager-cups printmanager-redis Redis ПринтМенеджера. Брокер сообщений. Сингл: проверка запуска сервиса. Отказоустойчивая конфигурация: ноды ПринтМенеджера недоступны. Сингл: наличие ошибок запуска сервиса. Отказоустойчивая конфигурация: ошибки при переключении с master на slave. cd /opt/printmanager docker-compose logs -f --tail=200 printmanager-redis printmanager-redis-sentinel Redis Sentinel ПринтМенеджер. Существует только в схеме с балансировкой нагрузки. Ноды ПринтМенеджера недоступны. Выявить наличие ошибок при переключении с master на slave. cd /opt/printmanager docker-compose logs -f --tail=200 printmanager-redis-sentinel Агенты и Клиент ПМ Агенты и клиенты ПринтМенеджер не являются Docker-контейнерами. Логи доступны через системный журнал или файлы логов. Компонент Описание Когда анализировать (симптомы) Цель анализа Команда / расположение логов Сетевой агент Сканирование сети и сбор данных с сетевых устройств. Устройство не появляется в разделе «Инвентаризация — Устройства». Выявить ошибки запуска сервиса. Выявить ошибки опроса устройства. Выявить ошибки сканирования сети. cat /opt/printum-agent/agent.log Локальный агент Windows Мониторинг заданий печати на ОС Windows. Устройство не появляется в Личном кабинете. Не передаётся статистика по устройству. Выявить ошибки запуска сервиса. Выявить ошибки передачи данных. eventvwr → Журналы Windows → Приложение → источник ServicePrintum Локальный агент Linux Мониторинг заданий печати на ОС Linux. Устройство не появляется в Личном кабинете. Не передаётся статистика по устройству. Выявить ошибки запуска сервиса. Выявить ошибки передачи данных. sudo journalctl -u printum-jtm.service Клиент ПМ Windows Отправка заданий на печать на ОС Windows. Задание не появляется в очереди или не печатается на принтере для прямой печати. Принтеры не появляются на АРМ. Выявить ошибки запуска сервиса. Выявить ошибки передачи данных. eventvwr → Журналы Windows → Приложение → источник Print Manager Client Клиент ПМ Linux Отправка заданий на печать на ОС Linux. Задание не появляется в очереди или не печатается на принтере для прямой печати. Принтеры не появляются на АРМ. Выявить ошибки запуска сервиса. Выявить ошибки передачи данных. sudo journalctl -u printum-printmanager-client.service


Revision #2
Created 2026-05-11 15:47:03 UTC by DD
Updated 2026-05-18 18:59:55 UTC by DD