Перейти к основному контенту

С чего начинать диагностику

Сводка типовых проблем: как их обнаружить и устранить. Основной инструмент диагностики — {{ССЫЛКА:maintenance.dashboard|панель состояния}} (блоки «Самопроверка» и «Системные метрики»). При углублённой диагностике — журналы узла и задачи.

Где искать журналы

Развёртывание Расположение
Docker Compose папка logs/ в папке установки (монтируется из KLVD_LOGS_HOST), либо docker logs klvd-node
Kubernetes kubectl logs -n <ns> statefulset/klvd-node
Бинарный файл стандартный вывод или файл (зависит от запуска)

Журнал узла ведётся по уровням: INFO, WARNING, ERROR, CRITICAL. Файлы называются {LEVEL}_YYYY_MM_DD.txt (например, ERROR_2026_08_15.txt).

Ротация

  • Фоновая задача удаляет файлы журнала старше 48 часов. Ротация автоматическая, настройка не требуется.
  • Журнал обновления (update.log) — в папке установки, не ротируется автоматически. При больших размерах очищайте вручную.

Что искать в журналах

  • Строки с #ERROR_KLVD_ — ошибки с кодом (см. {{ССЫЛКА:reference.errors-index|Коды ошибок}}).
  • Строки с #WARN_KLVD_ — предупреждения.
  • Строки с #INFO_KLVD_ — информационные сообщения (например, запуск служб, применение сертификата).

Журналы контейнеров

# docker-compose
docker logs klvd-node --tail 100 -f
docker logs klvd-solr --tail 100
docker logs klvd_postgres --tail 100

# Kubernetes
kubectl logs -n klvd statefulset/klvd-node --tail 100 -f

В Docker Compose журналы PostgreSQL и Solr также доступны через docker logs. Журнал приложения Клавдия — в папке logs/ (более структурированный, с уровнями и датами).

Связанные материалы

Навигация по книге