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

Коды ошибок

Полный справочник кодов ошибок, которые узел Клавдия записывает в журнал. Код ошибки — это тег вида #ERROR_*, #WARN_* или #CRITICAL_*, включаемый в текст сообщения. По коду администратор может однозначно найти причину события, оценить его серьёзность и принять меры без обращения в техническую поддержку.

  1. Найдите в журнале строку с кодом ошибки (тег вида #ERROR_*).
  2. Сверьтесь в справочнике ниже с этим кодом.
  3. По каждому коду указаны поля:
  • Код — тег из журнала (например, #ERROR_KLVD_CORE_INIT_001).
  • Уровень — серьёзность: CRITICAL (узел не может продолжать работу, аварийная остановка), ERROR (операция не выполнена, требуется внимание), WARNING (некритичное отклонение, работа продолжается).
  • Что случилось — краткое описание условия.
  • На что влияет — воздействие на систему: обратимость, серьёзность с точки зрения потери доступа, потери данных, появления ошибочных данных и стабильности.
  • Как исправить — действия администратора для восстановления последствий и устранения причины.
  • Обратить внимание — нюансы диагностики.

Тег #ERROR_* в тексте не всегда означает уровень ERROR: несколько предупреждений (WARNING) несут тег с префиксом #ERROR_. Уровень определяется макросом журнала, а не префиксом тега. В таблице уровень указан по факту.

В подсистемах SMTP теги с одинаковыми номерами могут обозначать разные ошибки в разных модулях (например, #ERROR_KLVD_SMTP_019…030). При поиске причины сверяйтесь с текстом сообщения, а не только с номером тега.

#ERROR_KLVD_<КОМПОНЕНТ>_<НОМЕР> (ошибка), #WARN_KLVD_<КОМПОНЕНТ>_<НОМЕР> (предупреждение), #INFO_KLVD_<КОМПОНЕНТ>_<НОМЕР> (информационное сообщение), #CRITICAL_KLVD_<КОМПОНЕНТ>_<НОМЕР> (аварийное сообщение). Коды базового фреймворка имеют префикс #ERROR_AFIMON_*.

См. Диагностика проблем, раздел [Журналы]. Журналы узла лежат в папке logs/ в папке установки (файлы вида ERROR_2026_08_15.txt, WARNING_…), либо доступны через docker logs klvd-node. Ротация — 48 часов.

# Найти все ошибки за сегодня
grep '#ERROR_KLVD_' logs/ERROR_$(date +%Y_%m_%d).txt

# Поток ошибок контейнера
docker logs klvd-node 2>&1 | grep -E '#(ERROR|WARN|CRITICAL)_KLVD_'

Разделы справочника

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

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

Наверх