Коды ошибок

Полный справочник кодов ошибок, которые узел Клавдия записывает в журнал. Код ошибки — это тег вида #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}}CORE
• {{ССЫЛКА:reference.errors-db| Коды ошибок: COMMON_DB}}COMMON_DB
• {{ССЫЛКА:reference.errors-import| Коды ошибок: IMPORT}}IMPORT
• {{ССЫЛКА:reference.errors-import-ext| Коды ошибок: IMPORT_EXT}}IMPORT_EXT
• {{ССЫЛКА:reference.errors-storage| Коды ошибок: STORAGE(!)}}
• {{ССЫЛКА:reference.errors-smtp| Коды ошибок: SMTP}}SMTP
• {{ССЫЛКА:reference.errors-imap| Коды ошибок: IMAP}}IMAP
• {{ССЫЛКА:reference.errors-scheduler| Коды ошибок: SCHEDULER}}SCHEDULER
• {{ССЫЛКА:reference.errors-notif| Коды ошибок: NOTIF}}NOTIF
• {{ССЫЛКА:reference.errors-ldap| Коды ошибок: LDAP}}LDAP
• {{ССЫЛКА:reference.errors-rbac| Коды ошибок: RBAC}}RBAC
• {{ССЫЛКА:reference.errors-metrics| Коды ошибок: METRICS}}METRICS
• {{ССЫЛКА:reference.errors-search| Коды ошибок: SEARCH}}SEARCH
• {{ССЫЛКА:reference.errors-solr-cluster| Коды ошибок: SOLR_CLUSTER}}SOLR_CLUSTER
• {{ССЫЛКА:reference.errors-ocr| Коды ошибок: OCR}}OCR
• {{ССЫЛКА:reference.errors-wui| Коды ошибок: WUI}}WUI
• {{ССЫЛКА:reference.errors-framework| Коды ошибок: AFIMON}}AFIMON

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

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

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

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