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

Коды ошибок

Полный справочник кодов ошибок, которые узел Клавдия записывает в журнал. Код ошибки — это тег вида #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_*.

См. {{ССЫЛКА:maintenance.troubleshooting|Диагностика проблем}}, раздел [Журналы]. Журналы узла лежат в папке 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_'

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

  • {{ССЫЛКА:reference.errors-core|Коды ошибок: CORE}}
  • {{ССЫЛКА:reference.errors-db|Коды ошибок: COMMON_DB}}
  • {{ССЫЛКА:reference.errors-import|Коды ошибок: IMPORT}}
  • {{ССЫЛКА:reference.errors-import-ext|Коды ошибок: IMPORT_EXT}}
  • {{ССЫЛКА:reference.errors-storage|Коды ошибок: STORAGE(!)}}
  • {{ССЫЛКА:reference.errors-smtp|Коды ошибок: SMTP}}
  • {{ССЫЛКА:reference.errors-imap|Коды ошибок: IMAP}}
  • {{ССЫЛКА:reference.errors-scheduler|Коды ошибок: SCHEDULER}}
  • {{ССЫЛКА:reference.errors-notif|Коды ошибок: NOTIF}}
  • {{ССЫЛКА:reference.errors-ldap|Коды ошибок: LDAP}}
  • {{ССЫЛКА:reference.errors-rbac|Коды ошибок: RBAC}}
  • {{ССЫЛКА:reference.errors-metrics|Коды ошибок: METRICS}}
  • {{ССЫЛКА:reference.errors-search|Коды ошибок: SEARCH}}
  • {{ССЫЛКА:reference.errors-solr-cluster|Коды ошибок: SOLR_CLUSTER}}
  • {{ССЫЛКА:reference.errors-ocr|Коды ошибок: OCR}}
  • {{ССЫЛКА:reference.errors-wui|Коды ошибок: WUI}}
  • {{ССЫЛКА:reference.errors-framework|Коды ошибок: AFIMON}}

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

  • {{ССЫЛКА:maintenance.troubleshooting|С чего начинать диагностику}}

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

  • Следующая статья: {{ССЫЛКА:reference.errors-core|Коды ошибок: CORE}}
Наверх