Skip to main content

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

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-default
    printum_worker-high
    printum_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 (версия компонента)
    • Описание симптома и шагов воспроизведения
    • ОС сервера
    • Модель МФУ (если проблема связана с конкретным устройством)
    Back to top