3.06.01 Контроль состояния и диагностика
Проверьте конфигурацию и состояние
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env config --quiet
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env ps -a
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env config --services
Сопоставьте перечень сервисов и запущенные контейнеры. Для остановленного или циклически перезапускаемого сервиса сначала просмотрите журнал.
Просмотрите журнал сервиса
Пример для apimanager; для другого сервиса подставьте имя из config --services:
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env logs --since 15m --tail 200 apimanager
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env logs -f --tail 100 apimanager
Ctrl+C завершает только просмотр -f, а не сервис.
Настройте ротацию журналов
В исходном комплекте ограничения json-file не заданы: журналы контейнеров могут расти без ограничений. Для каждого сервиса добавьте в docker-compose.yml блок и выберите ёмкость с учётом свободного места:
logging:
driver: json-file
options:
max-size: "100m"
max-file: "5"
Проверьте конфигурацию и пересоздайте изменённые сервисы:
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env config --quiet
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env up -d
Ограничение применяется только при пересоздании контейнера. Фактическую политику проверьте командой:
sudo docker inspect --format '{{json .HostConfig.LogConfig}}' '<CONTAINER_ID>'
Пять файлов по 100 МБ означают до 500 МБ журнала на каждый сервис. Ротация не является архивированием: для длительного хранения передавайте журналы в систему логирования организации.
Проверьте ресурсы
df -h /opt/itam /var/lib/docker
free -h
sudo docker system df
sudo docker stats --no-stream
Установите наблюдение за разделами /, /var, /var/lib/docker, каталогом резервных копий и внешними хранилищами. Пример эксплуатационных порогов: предупреждение при заполнении 75 %, аварийное реагирование при 85 %; конкретные значения утверждаются по ёмкости и скорости роста данных. Не очищайте /var/lib/docker вручную.
Типовые проблемы
| Проблема | Что проверить |
|---|---|
| Портал не открывается | DNS, сертификат, TCP 443, nginx -t, маршруты /, /api, /ws, /kc |
| Ошибка входа | Realm itam, клиент itam-front, redirect URI, Web origins, GET /api/v1/auth/bootstrap, время |
| Ошибка CORS | Внешний origin без /kc или /api в Web origins, согласованность config.js и Nginx |
| WebSocket не подключается | proxy_http_version 1.1, Upgrade, Connection, маршрут /ws |
| Сервис в restart loop | Журнал, доступность PostgreSQL, RabbitMQ и Keycloak, compose config --quiet |
| Файлы не загружаются | FILESTORAGE_HOST, доступ к S3, бакет, ключи, доверие TLS, свободное место |
| Нет событий входа | Цепочка Keycloak → RabbitMQ → dictionaryservice по 3.03.03 |
Проверьте Nginx
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env exec -T nginx nginx -t
Команда проверяет синтаксис и доступность файлов без перезапуска.
Отличите конфигурацию от работающего контейнера
Изменение .env не меняет уже созданный контейнер. Сравните ожидаемые и фактические образы:
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env config --images
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env images
sudo docker inspect --format '{{.Config.Image}} {{.Image}} {{.State.Status}} {{if .State.Health}}{{.State.Health.Status}}{{else}}healthcheck-not-defined{{end}}' '<CONTAINER_ID>'
Статус running не равен готовности приложения: healthcheck задан не для всех сервисов, а depends_on с простым списком не ждёт готовности зависимости. Отдельно проверяйте портал, API, вход, файлы, отчёты и фоновые операции.
Не передавайте полный docker inspect или compose config: они могут содержать секреты.
Проверьте опубликованные порты
Просмотрите столбец PORTS в docker compose ps -a. В исходном комплекте часть внутренних портов опубликована на хост. Для продуктивной установки снаружи оставьте только TCP 443 и при необходимости TCP 22 из подсети администраторов; закройте остальные порты по 3.02.01.
Dozzle получает /var/run/docker.sock: доступ к нему фактически позволяет управлять Docker-хостом. В продуктивной среде отключите Dozzle и Kafka UI либо ограничьте доступ подсетью администраторов и смените пароли.
Подготовьте сведения для поддержки
- Опишите действие и ожидаемый результат.
- Укажите время события и часовой пояс.
- Укажите сервис, image ID/digest и код ответа.
- Приложите относящийся к событию фрагмент журнала.
- Удалите пароли, токены, cookies, keytab и персональные данные.
Результат: получены состояние сервисов, журналы, ресурсы и безопасный диагностический комплект.