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

---
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/`. Команда для просмотра логов:

```bash
cd /opt/printum && sudo docker-compose logs <контейнер> --tail=200
```

| Контейнер | Назначение | Когда смотреть | Что искать в логах |
|---|---|---|---|
| `printum_nginx` | HTTP/TCP-прокси; проксирует все соединения к приложению, отдаёт статику | Ошибки при загрузке Личного кабинета или панели администратора; МФУ не добавляются в Мониторинг; нет синхронизации с ПринтМенеджером | URL с ошибками; коды 4xx/5xx; ошибки запросов от Сетевого агента и ПринтМенеджера |
| `printum_dashboard` | Личный кабинет (фронтенд) | Ошибки при открытии Личного кабинета в браузере | URL с ошибками; коды ответов; IP-адреса, вызывающие ошибки |
| `printum_worker-default`<br>`printum_worker-high`<br>`printum_worker-low` | Celery-воркеры — фоновые задачи Мониторинга: отправка писем, обработка данных от МФУ | Не приходят письма; не обновляется статус МФУ или ресурс деталей; данные появляются с задержкой; нет синхронизации с ПринтМенеджером | Время запуска и завершения задач; ошибки периодических задач; задачи без завершения |
| `printum_scheduler` | Планировщик Celery — отправляет задачи в очереди по расписанию | Задачи по расписанию не выполняются (синхронизация с доменом, уведомления, обновление данных) | Факт запуска задачи по расписанию; ошибки постановки в очередь |
| `printum_backend` | API Мониторинга — все синхронные запросы | Ошибки в Личном кабинете (действия не выполняются); проблемы с локациями; обмен данными с Локальным агентом | Ошибки API-запросов; коды 4xx/5xx; проблемы валидации или логики |
| `printum_clickhouse` | ClickHouse — аналитическая БД | Нет статистики печати; проверка запуска сервиса | Ошибки запуска БД |
| `printum_redis` | Redis — брокер сообщений Мониторинга | Проверка работоспособности сервиса | Ошибки запуска сервиса |
| `printum_postgres` | PostgreSQL — основная БД Мониторинга | Проверка работоспособности сервиса | Ошибки запуска БД |

---

## ПринтМенеджер

Контейнеры расположены в `/opt/printmanager/`. Команда для просмотра логов:

```bash
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` |

---

## Что приложить к заявке в ТП

Команды для сбора всех логов одной копипастой:

**Мониторинг:**

```bash
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
```

**ПринтМенеджер:**

```bash
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
```

**Конкретный контейнер:**

```bash
# Мониторинг
cd /opt/printum && sudo docker-compose logs <контейнер> --tail=500

# ПринтМенеджер
cd /opt/printmanager && sudo docker-compose logs <контейнер> --tail=500
```

**Клиент ПМ (Linux):**

```bash
cat /var/log/printum/printmanager_client.log
```

К заявке приложить:
- Вывод `logs.sh` (или файлы логов)
- Вывод `cat .version` (версия компонента)
- Описание симптома и шагов воспроизведения
- ОС сервера
- Модель МФУ (если проблема связана с конкретным устройством)