Логи — что происходило при обмене
Логи записывают, что модуль делал на самом деле: какая задача обмена запускалась, что ушло в МойСклад и что он ответил. Это главное место, когда нужно понять почему документ не доехал. Страница — Диагностика → Логи.
Как читать запись
Каждая строка списка — одна запись лога:
- значок слева — тип: зелёная галочка — успех, жёлтый восклицательный знак — предупреждение, красный крестик — ошибка;
- заголовок — что происходило, например «Обмен: выгрузка в МойСклад [deal]» (в скобках — тип: deal — сделка, contact — контакт, payment — оплата) или «Автоматический обмен (агент)» — проход агента очереди;
- справа — дата и время.
Нажмите на строку или на стрелку слева, чтобы раскрыть запись. Внутри — пошаговый рассказ: какая задача взята в работу, что проверено, что отправлено и чем закончилось. Ошибки внутри выделены красным, с полным текстом ответа МойСклад.
Номер задачи в логе («Задача 11473 (export:deal:3830)») — тот же, что в окне подробностей на странице Очередь обмена. По нему удобно связать задачу из очереди с её историей в логе.
Модуль регулярно проверяет лицензию и пишет об этом в лог. Такие строки нормальны и обычно занимают верх списка. Чтобы их не листать, включите фильтр Ошибка или найдите нужное поиском.
Частые записи и что с ними делать
| Что видно в логе | Что это значит | Где исправить |
|---|---|---|
| «Обмен пропущен фильтром» | Сделка не прошла условия вкладки Фильтры документа — модуль намеренно её не выгрузил. Задача при этом «Выполнена». | Заказ покупателя (или заказ поставщику) → Фильтры |
| Ошибка МойСклад вида «поле 'agent' не может быть пустым» | В заказе нет контрагента: покупатель сделки не выгрузился или не найден. | Контрагенты и типы контрагентов |
| Ошибка МойСклад вида «поле 'name' не может быть пустым» | У контакта или компании не заполнено поле, которое идёт в название контрагента. | Сопоставление полей типа контрагента — Физическое лицо, ИП, Юридическое лицо |
Верхняя панель — поиск и фильтры
| Элемент | Что делает |
|---|---|
| Кнопка с круговыми стрелками | Перечитывает лог (то же, что Обновить внизу). |
| Поиск | Оставляет записи, в которых встречается текст, — в заголовке или внутри. Поиск начинается с двух символов; найденные записи раскрываются сами, совпадение подсвечено. Ищите по номеру сделки, номеру задачи или слову из ошибки. |
| Ошибка | Показать записи с ошибками. |
| Предупреждение | Показать предупреждения. |
| Успех | Показать успешные записи. |
Кнопки типов включаются и выключаются нажатием, можно включить несколько сразу. Если не включена ни одна — показываются все записи.
Нижняя панель — файл лога
| Элемент | Что делает |
|---|---|
| Обновить | Перечитывает список файлов и показывает текущий лог. |
| Раскрыть все / Свернуть все | Раскрывает или сворачивает все записи разом. |
| Выбор файла (Текущий лог) и стрелки по бокам | Переключение между текущим логом и архивными. Архивные подписаны датой. Стрелки листают файлы по одному. |
| Очистить | Начинает новый текущий лог. Прежний не удаляется, а уходит в архив и остаётся доступен в списке файлов. Кнопка работает только на текущем логе. |
Когда текущий лог разрастается, модуль сам переносит его в архив и начинает новый, поэтому в списке со временем копятся архивные файлы. Старые архивы модуль удаляет сам.
Найдите запись с ошибкой, раскройте её и сделайте снимок экрана или скопируйте текст — вместе с номером задачи из очереди этого почти всегда достаточно, чтобы поддержка поняла причину. Кнопку Очистить перед этим не нажимайте: нужные записи окажутся в архиве и их придётся искать.
Чем логи отличаются от журнала
- Логи — что делал обмен: задачи, запросы в МойСклад, ошибки.
- Журнал действий — что делали с модулем: изменения настроек, ручные действия с очередью и агентом.
Если «не уехал документ» — смотрите логи. Если «кто и когда поменял настройку» — журнал.