С чего начинать диагностику
Сводка типовых проблем: как их обнаружить и устранить. Основной инструмент диагностики — панель состояния (блоки «Самопроверка» и «Системные метрики»). При углублённой диагностике — журналы узла и задачи.
- Самопроверка — общий статус и состояние каждого компонента. См. Панель состояния.
- Системные метрики — суммы за час по сбору, приёму 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/(более структурированный, с уровнями и датами).
Включите подробные диагностические сообщения
Включайте подробный журнал по запросу технической поддержки или если обычного сообщения недостаточно для определения причины сбоя. Он содержит детали операций, ответы внешних систем и этапы приёма и импорта почты. Подробные сообщения есть не во всех подсистемах.
-
В
docker-compose.ymlнайдите блокenvironmentсервисаklvd-nodeи добавьте переменную, сохранив остальные параметры:environment: KLVD_VERBOSE_LOGS: "1" -
В каталоге установки примените изменение:
docker compose up -d klvd-node -
Повторите операцию, при которой возникала проблема, и найдите сообщения с тегом
#VERBOSE:docker logs klvd-node 2>&1 | rg '#VERBOSE'Если
rgне установлен, используйтеgrep '#VERBOSE'. Сообщения могут также находиться в файлах журнала, указанных выше. -
Сохраните журнал нужного узла за время воспроизведения ошибки. После диагностики удалите
KLVD_VERBOSE_LOGSиз окружения сервиса и снова выполнитеdocker compose up -d klvd-node.
Обычный перезапуск контейнера не передаёт ему изменённое окружение: используйте команду применения конфигурации выше. Для другого способа развёртывания задайте переменную в окружении нужного узла и примените изменение штатным способом.
Подробные сообщения увеличивают объём журнала и могут содержать фрагменты переписки: начало темы и до 200 символов текста письма. Пароли, ключи доступа и токены не записываются. Храните и передавайте такой журнал как конфиденциальные данные.
После выключения повторите проверку на новой операции: новые сообщения #VERBOSE появляться не должны. Ранее записанные сообщения остаются в журнале до его удаления или ротации.
Связанные материалы
Навигация по книге
- Следующая статья: Типовые симптомы и решения