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

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

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

  • Самопроверка — общий статус и состояние каждого компонента. См. {{ССЫЛКА:maintenance.dashboard|Панель состояния}}.
  • Системные метрики — суммы за час по сбору, приёму SMTP, доступу по IMAP, индексации, оповещениям, планировщику и безопасности.
  • Задачи — ошибки задач с описанием причины. См. {{ССЫЛКА:maintenance.tasks|Задачи и очередь}}.
  • Журналы — где искать и как ротируются (см. ниже).

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

Развёртывание Расположение
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/ (более структурированный, с уровнями и датами).

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

  • {{ССЫЛКА:reference.errors-index|Коды ошибок}}

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

  • Следующая статья: {{ССЫЛКА:maintenance.symptoms|Типовые симптомы и решения}}
Наверх