Диагностика¶

Где искать информацию об ошибках и что означает каждый источник.

Источники информации¶

Текст ошибки в записи регистра¶

Откройте запись РС «Исходящие сообщения» или «Входящие сообщения» со статусом «Ошибка». Поле «Текст журнала» содержит трассировку исключения.

Что смотреть:

имя сработавшего обработчика и номер строки (если исключение в прикладном коде);
текст последнего исключения librdkafka (если проблема в сетевом или SASL/SSL-уровне);
Свойства.Ключ, Свойства.Смещение, Свойства.Топик — чтобы найти сообщение в Kafka.

Журнал регистрации 1С¶

Ошибки фоновых заданий и необработанные исключения в обработчиках фиксируются там.

Полезные фильтры:

Автор = пользователь обмена;
События = Адаптер Kafka. Регистрация при записи — подробности в разделе Событие «Адаптер Kafka. Регистрация при записи».

Событие «Адаптер Kafka. Регистрация при записи»¶

Ошибки, возникшие при автоматической регистрации объекта через подписку на запись, перехватываются — чтобы не блокировать пользователя — и фиксируются в этом событии.

Зачем это нужно

Если пользователь записал документ, но в очереди исходящих его нет — причина может быть в том, что подписка адаптера сработала с ошибкой. Именно этот журнал расскажет, почему.

Логи внешней компоненты¶

Файловые логи в каталоге, заданном в Kafka / Администрирование / Логирование, поле Каталог. Содержат низкоуровневые события librdkafka (подключение, отправка, ошибки брокера).

Когда полезны:

диагностика сетевых проблем;
TLS-рукопожатие (проверка сертификатов);
SASL-аутентификация (неверный пароль / неверный механизм);
тайм-ауты при отправке или чтении.

Внешний сервис логирования¶

Если настроена выгрузка в ELK / Loki — журнал обмена доступен там с возможностью поиска и аналитики.

Возможности:

поиск по ключу сообщения, ID транзакции, любому полю тела;
построение дашбордов в Kibana / Grafana;
корреляция с событиями других систем.

Пошаговый алгоритм разбора ошибки¶

Откройте запись в РС со статусом «Ошибка».
Прочитайте «Текст журнала» — часто этого уже достаточно.
Если текст ссылается на исключение — найдите в журнале регистрации 1С полный стек.
Если ошибка связана с Kafka (сеть, брокер) — посмотрите логи внешней компоненты.
Если настроен внешний логгер — поищите сообщение по ключу, возможно, там больше контекста.