Справочник контейнеров — где искать логи
title: Справочник контейнеров — где искать логи slug: spravochnik-konteinerov-gde-iskat-logi tags: [логи, контейнеры, docker, диагностика, справочник] domain: Troubleshooting type: Reference audience: partner-engineer product_versions: "4.x" status: Draft related_components: [Мониторинг, ПринтМенеджер, Клиент ПМ, Сетевой агент, Локальный агент] related_pages:
- kak-diagnostirovat-problemy-pechati-po-etapam-puti-zadaniia
- model-diagnostiki-printum
Справочник контейнеров — где искать логи
Когда использовать
При диагностике проблем в Принтум — чтобы быстро определить, логи какого контейнера смотреть в зависимости от симптома.
Мониторинг
Контейнеры расположены в /opt/printum/. Команда для просмотра логов:
cd /opt/printum && sudo docker-compose logs <контейнер> --tail=200
| Контейнер | Назначение | Когда смотреть | Что искать в логах |
|---|---|---|---|
printum_nginx |
HTTP/TCP-прокси; проксирует все соединения к приложению, отдаёт статику | Ошибки при загрузке Личного кабинета или панели администратора; МФУ не добавляются в Мониторинг; нет синхронизации с ПринтМенеджером | URL с ошибками; коды 4xx/5xx; ошибки запросов от Сетевого агента и ПринтМенеджера |
printum_dashboard |
Личный кабинет (фронтенд) | Ошибки при открытии Личного кабинета в браузере | URL с ошибками; коды ответов; IP-адреса, вызывающие ошибки |
printum_worker-defaultprintum_worker-highprintum_worker-low |
Celery-воркеры — фоновые задачи Мониторинга: отправка писем, обработка данных от МФУ | Не приходят письма; не обновляется статус МФУ или ресурс деталей; данные появляются с задержкой; нет синхронизации с ПринтМенеджером | Время запуска и завершения задач; ошибки периодических задач; задачи без завершения |
printum_scheduler |
Планировщик Celery — отправляет задачи в очереди по расписанию | Задачи по расписанию не выполняются (синхронизация с доменом, уведомления, обновление данных) | Факт запуска задачи по расписанию; ошибки постановки в очередь |
printum_backend |
API Мониторинга — все синхронные запросы | Ошибки в Личном кабинете (действия не выполняются); проблемы с локациями; обмен данными с Локальным агентом | Ошибки API-запросов; коды 4xx/5xx; проблемы валидации или логики |
printum_clickhouse |
ClickHouse — аналитическая БД | Нет статистики печати; проверка запуска сервиса | Ошибки запуска БД |
printum_redis |
Redis — брокер сообщений Мониторинга | Проверка работоспособности сервиса | Ошибки запуска сервиса |
printum_postgres |
PostgreSQL — основная БД Мониторинга | Проверка работоспособности сервиса | Ошибки запуска БД |
ПринтМенеджер
Контейнеры расположены в /opt/printmanager/. Команда для просмотра логов:
cd /opt/printmanager && sudo docker-compose logs <контейнер> --tail=200
| Контейнер | Назначение | Когда смотреть | Что искать в логах |
|---|---|---|---|
printmanager_web |
Nginx — панель администратора ПринтМенеджера | Нет синхронизации с Мониторингом | URL с ошибками; коды 4xx/5xx |
printmanager-celery |
Celery — фоновые задачи ПринтМенеджера: импорт МФУ, статистика, печать | МФУ не импортируются из Мониторинга; задания печатаются с задержкой или не печатаются; ошибки установки Встроенного приложения | Ошибки интеграции с Мониторингом; ошибки печати; ошибки соединения с CUPS |
printmanager-celery-print-queue |
Очередь бесклиентской печати — опрашивает CUPS на наличие новых заданий | Задания не попадают в очередь или попадают с задержкой | Ошибки соединения с CUPS; ошибки обработки заданий из CUPS |
printmanager-scheduler |
Планировщик Celery ПринтМенеджера | Задания перестали приходить в очередь; задания гостевой или почтовой печати не обрабатываются; образы документов не появляются | Факт запуска задачи; ошибки постановки в очередь |
printmanager-app |
Основной контейнер — Django-приложение; обрабатывает все HTTP-запросы, авторизацию, МФУ, Клиент ПМ | Проблемы с печатью, сканированием, копированием; проблемы с авторизацией; задания не доходят до МФУ; обмен с Клиентом ПМ | Ошибки API-запросов; коды 4xx/5xx; ошибки валидации/логики/БД |
printmanager-converter-server |
TCP-конвертер — принимает TCP-запросы и передаёт в printmanager-app по HTTP |
Проблемы с авторизацией по TCP (считыватели карт) | Приходит ли сообщение от конвертера; номер карты от конвертера |
printmanager-ftpd |
Временное FTP-хранилище файлов сканирования/копирования | Задание копирования выполнено, но не распечатано; образ задания сканирования не появился в ПринтМенеджере | Ошибки обработки образа документа |
printmanager-db |
PostgreSQL — БД ПринтМенеджера | Проверка работоспособности сервиса | Ошибки запуска БД |
printmanager-cups |
CUPS — сервер печати; обрабатывает всю отложенную печать | Задания не распечатываются; недоступна панель CUPS (порт 1631) | Ошибки работы сервиса; ошибки МФУ в CUPS. Примечание: Unable to encrypt connection: A TLS fatal alert — не ошибка системы, означает что клиент не является доверенным |
printmanager-redis |
Redis — брокер ПринтМенеджера | Single: проверка сервиса. HA: ноды ПринтМенеджера недоступны | Single: ошибки запуска. HA: ошибки переключения master→slave |
printmanager-redis-sentinel |
Redis Sentinel — только в схеме с балансировщиком | Ноды ПринтМенеджера недоступны | Ошибки переключения master→slave |
Агенты и Клиент ПМ
| Компонент | Назначение | Когда смотреть | Где логи |
|---|---|---|---|
| Сетевой агент | Сканирование сети и сбор данных с МФУ по SNMP | МФУ не появляется в разделе «Инвентаризация → Устройства» | journalctl -u printum-network-agent (Linux) |
| Локальный агент (Windows) | Мониторинг заданий печати на Windows | МФУ не появляется в Личном кабинете; нет статистики | Просмотр событий Windows → Приложение |
| Локальный агент (Linux) | Мониторинг заданий печати на Linux | МФУ не появляется в Личном кабинете; нет статистики | journalctl -u printum-local-agent |
| Клиент ПМ (Windows) | Отправка заданий на печать с Windows АРМ | Задание не появляется в очереди; МФУ не появляются на АРМ | C:\ProgramData\printum\logs\ |
| Клиент ПМ (Linux) | Отправка заданий на печать с Linux АРМ | Задание не появляется в очереди; МФУ не появляются на АРМ | /var/log/printum/printmanager_client.log |
Что приложить к заявке в ТП
Команды для сбора всех логов одной копипастой:
Мониторинг:
cd /opt/printum
bash logs.sh
# Или вручную:
sudo docker-compose logs --tail=500 > /tmp/monitoring_logs_$(date +%Y%m%d_%H%M).txt 2>&1
cat .version
ПринтМенеджер:
cd /opt/printmanager
bash logs.sh
# Или вручную:
sudo docker-compose logs --tail=500 > /tmp/pm_logs_$(date +%Y%m%d_%H%M).txt 2>&1
cat .version
Конкретный контейнер:
# Мониторинг
cd /opt/printum && sudo docker-compose logs <контейнер> --tail=500
# ПринтМенеджер
cd /opt/printmanager && sudo docker-compose logs <контейнер> --tail=500
Клиент ПМ (Linux):
cat /var/log/printum/printmanager_client.log
К заявке приложить:
- Вывод
logs.sh(или файлы логов) - Вывод
cat .version(версия компонента) - Описание симптома и шагов воспроизведения
- ОС сервера
- Модель МФУ (если проблема связана с конкретным устройством)