# Логирование работы модуля #### Общее Для контроля работы модуля и своевременного выявления ошибок предусмотрена гибкая система логирования, фиксирующая все ключевые процессы. Доступ к журналу логов и настройки логирования находятся в разделе «Журнал обмена» в настройках модуля: [![log1.jpg](https://doc.aprix.ru/uploads/images/gallery/2026-05/scaled-1680-/yCpPdP6mOyTn20XH-log1.jpg)](https://doc.aprix.ru/uploads/images/gallery/2026-05/yCpPdP6mOyTn20XH-log1.jpg) С помощью настроек в данном разделе можно управлять объёмом сохраняемой информации и настраивать срок хранения логов. Логи работы модуля сохраняются в отдельные файлы и условно делятся на два типа: * Основные логи — содержат ключевую информацию, необходимую для общего контроля процесса синхронизации; * Детальные логи — включают расширенные данные, используемые для диагностики и отладки. Детальные логи рекомендуется включать только при необходимости, так как при длительной работе они могут занимать значительный объём дискового пространства. В логах также могут содержаться дополнительные ссылки на файлы с расширенной информацией по отдельным операциям. Эти файлы формируются автоматически в процессе работы модуля и позволяют более детально проанализировать выполнение конкретных процессов. Контролировать объём основных и детальных логов можно с помощью соответствующих настроек хранения. Для этого предусмотрены два параметра: 1. Сколько дней хранить основные логи: [![log2.jpg](https://doc.aprix.ru/uploads/images/gallery/2026-05/scaled-1680-/6O1TtxOOQhnFU6FP-log2.jpg)](https://doc.aprix.ru/uploads/images/gallery/2026-05/6O1TtxOOQhnFU6FP-log2.jpg) 2. Сколько дней хранить детальные логи: [![log4.jpg](https://doc.aprix.ru/uploads/images/gallery/2026-05/scaled-1680-/rNxniExWl6Q950XM-log4.jpg)](https://doc.aprix.ru/uploads/images/gallery/2026-05/rNxniExWl6Q950XM-log4.jpg) В этих полях указывается количество дней, в течение которых логи будут сохраняться. По истечении указанного срока устаревшие логи автоматически удаляются. Также в настройках модуля можно полностью отключить сбор детальных логов: [![log3.jpg](https://doc.aprix.ru/uploads/images/gallery/2026-05/scaled-1680-/TF4760sWJEiGqgVl-log3.jpg)](https://doc.aprix.ru/uploads/images/gallery/2026-05/TF4760sWJEiGqgVl-log3.jpg) Кроме этого, логи разделены на отдельные категории — всего доступно 10 типов, соответствующих различным процессам и сущностям. В каждой категории доступны как основные, так и детальные логи. Выбрать нужную категорию для просмотра можно с помощью выпадающего списка, в котором представлены все доступные типы логов: [![log10.jpg](https://doc.aprix.ru/uploads/images/gallery/2026-05/scaled-1680-/mOXm0ZxEg4lvI3eV-log10.jpg)](https://doc.aprix.ru/uploads/images/gallery/2026-05/mOXm0ZxEg4lvI3eV-log10.jpg) В блоке просмотра логов доступны инструменты для управления отображением: 1. Календарь — позволяет выбрать дату, за которую будут отображаться основные или детальные логи: [![log9.jpg](https://doc.aprix.ru/uploads/images/gallery/2026-05/scaled-1680-/OLDZx5kiiRNd5quI-log9.jpg)](https://doc.aprix.ru/uploads/images/gallery/2026-05/OLDZx5kiiRNd5quI-log9.jpg) 2. Кнопка «Скачать» — позволяет выгрузить лог-файл за выбранную дату: [![log8.jpg](https://doc.aprix.ru/uploads/images/gallery/2026-05/scaled-1680-/JdHTdosNZatvPt9y-log8.jpg)](https://doc.aprix.ru/uploads/images/gallery/2026-05/JdHTdosNZatvPt9y-log8.jpg) 3. Кнопка «Обновить» — используется для подгрузки актуальных данных логов без перезагрузки страницы. [![log7.jpg](https://doc.aprix.ru/uploads/images/gallery/2026-05/scaled-1680-/t6DoOdfCUjgEWpid-log7.jpg)](https://doc.aprix.ru/uploads/images/gallery/2026-05/t6DoOdfCUjgEWpid-log7.jpg) 4. Переключатель режима — позволяет выбрать тип отображаемых логов: основные или детальные. [![log6.jpg](https://doc.aprix.ru/uploads/images/gallery/2026-05/scaled-1680-/ZYoZEXckrCmfws1V-log6.jpg)](https://doc.aprix.ru/uploads/images/gallery/2026-05/ZYoZEXckrCmfws1V-log6.jpg) Также важно учитывать, что вся информация из основных логов полностью дублируется в детальных логах, при этом детальные логи дополнительно содержат расширенные данные для отладки. #### Сохранение отладочной информации о запросах к МойСклад Иногда для более точной настройки модуля и контроля обращений к МойСклад требуется дополнительная информация о выполненных запросах, а также об отправленных и полученных заголовках. Для этого в модуле предусмотрена отдельная настройка — «Сохранять в детальных логах полную статистику по запросам в МойСклад»: [![log5.jpg](https://doc.aprix.ru/uploads/images/gallery/2026-05/scaled-1680-/uZaj144cgIddRWvr-log5.jpg)](https://doc.aprix.ru/uploads/images/gallery/2026-05/uZaj144cgIddRWvr-log5.jpg) Если опция отключена, в детальных логах будет сохраняться только общая информация о количестве и типах запросов. Данные о заголовках запросов и ответов при этом фиксироваться не будут. #### Контроль размера и очистка логов Файлы логов для разных процессов могут занимать различный объём. При большом количестве сущностей и операций размер логов может существенно увеличиваться, что влияет на использование дискового пространства. Для контроля объёма логов предусмотрено несколько механизмов: - настройка срока хранения логов (количество дней), после которого старые записи автоматически удаляются; - дополнительные инструменты ручного управления логами. В разделе «Журнал обмена» доступна вкладка «Управление логами»: [![log13.jpg](https://doc.aprix.ru/uploads/images/gallery/2026-05/scaled-1680-/qLw2DzXx6r6Km3l4-log13.jpg)](https://doc.aprix.ru/uploads/images/gallery/2026-05/qLw2DzXx6r6Km3l4-log13.jpg) Используя эту вкладку можно: - удалять основные и детальные логи по отдельным процессам и сущностям; - вручную очищать неиспользуемые логи для освобождения места на диске; - использовать фильтр для просмотра объёма логов за определённый период и последующего удаления. [![log14.jpg](https://doc.aprix.ru/uploads/images/gallery/2026-05/scaled-1680-/lzF6FJadhSIaMiNK-log14.jpg)](https://doc.aprix.ru/uploads/images/gallery/2026-05/lzF6FJadhSIaMiNK-log14.jpg) Также важно учитывать, что помимо настроек хранения и ручного управления логами, в модуле реализован дополнительный механизм автоматической очистки. Если общий размер логов превышает 1 ГБ, запускается автоматическая очистка части файлов. Данный механизм работает через отдельный агент, который выполняется один раз в день и контролирует общий объём логов, при необходимости уменьшая его.