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

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

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

  • Самопроверка — общий статус и состояние каждого компонента. См. Панель состояния.
  • Системные метрики — суммы за час по сбору, приёму SMTP, доступу по IMAP, индексации, оповещениям, планировщику и безопасности.
  • Задачи — ошибки задач с описанием причины. См. Задачи и очередь.
  • Журналы — где искать и как ротируются (см. ниже).

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

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

Включите подробные диагностические сообщения

Включайте подробный журнал по запросу технической поддержки или если обычного сообщения недостаточно для определения причины сбоя. Он содержит детали операций, ответы внешних систем и этапы приёма и импорта почты. Подробные сообщения есть не во всех подсистемах.

  1. В docker-compose.yml найдите блок environment сервиса klvd-node и добавьте переменную, сохранив остальные параметры:

    environment:
      KLVD_VERBOSE_LOGS: "1"
    
  2. В каталоге установки примените изменение:

    docker compose up -d klvd-node
    
  3. Повторите операцию, при которой возникала проблема, и найдите сообщения с тегом #VERBOSE:

    docker logs klvd-node 2>&1 | rg '#VERBOSE'
    

    Если rg не установлен, используйте grep '#VERBOSE'. Сообщения могут также находиться в файлах журнала, указанных выше.

  4. Сохраните журнал нужного узла за время воспроизведения ошибки. После диагностики удалите KLVD_VERBOSE_LOGS из окружения сервиса и снова выполните docker compose up -d klvd-node.

Обычный перезапуск контейнера не передаёт ему изменённое окружение: используйте команду применения конфигурации выше. Для другого способа развёртывания задайте переменную в окружении нужного узла и примените изменение штатным способом.

Подробные сообщения увеличивают объём журнала и могут содержать фрагменты переписки: начало темы и до 200 символов текста письма. Пароли, ключи доступа и токены не записываются. Храните и передавайте такой журнал как конфиденциальные данные.

После выключения повторите проверку на новой операции: новые сообщения #VERBOSE появляться не должны. Ранее записанные сообщения остаются в журнале до его удаления или ротации.

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

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