McArt Логгер

Централизованный сбор всех событий приложения

Разработчикам, работающим с Bitrix, часто приходится собирать логи из разных источников: файлы ошибок, системные журналы, сообщения от сторонних сервисов. Модуль mcart.logger решает эту проблему, предоставляя единую точку для агрегации всех событий. Вам больше не нужно тратить время на поиск нужной записи в разрозненных хранилищах — вся информация о работе приложения стекается в одно место.

Инструмент работает со всеми уровнями логирования, от отладочных сообщений до критических сбоев, строго следуя стандарту PSR-3. Это значит, что вы можете гибко настраивать, какие именно события записывать, и не пропустите действительно важные ошибки. Кроме того, модуль умеет автоматически перехватывать ошибки самого ядра Bitrix, так что ни одно исключение не останется незамеченным.

Несколько форматов хранения на ваш выбор

Одно из главных преимуществ модуля — гибкость в выборе способа записи логов. Вы можете одновременно использовать несколько форматов, настроив каждый под свои задачи. Например, для ежедневной отладки удобно файловое логирование в стиле Laravel: записи форматируются так, чтобы в IDE вроде PhpStorm важные ошибки были сразу заметны.

Для долгосрочного хранения предусмотрена автоматическая ротация файлов. Когда размер лога превышает заданный лимит, старый файл автоматически переименовывается с пометкой .log.old, а новые данные пишутся в чистый файл. При этом система сама удаляет архивы, которые старше указанного вами количества дней. Если же вам нужно временное решение, можно задействовать стандартный журнал событий Bitrix — правда, учтите, что эта таблица может быстро разрастись.

Интеграция с Sentry для профессионального мониторинга

Для тех, кто привык следить за ошибками в реальном времени, модуль предлагает встроенную интеграцию с сервисом Sentry. Все исключения и критические сбои автоматически отправляются в вашу панель Sentry, где вы получаете не просто сухую запись, а подробный отчет с полным stack trace, пользовательскими данными и контекстом возникновения ошибки.

Это серьезно упрощает отладку: вместо того чтобы воспроизводить проблему на локальной машине, вы видите точную картину произошедшего на продакшене. Метки и теги помогают быстро фильтровать ошибки по проектам, версиям или модулям, а уведомления не дадут пропустить критический сбой даже ночью.

Управление настройками без правки кода

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

Такой подход особенно удобен при работе в команде или при передаче проекта заказчику. Любой администратор с доступом к панели Bitrix сможет самостоятельно перенастроить логирование под новые требования, не привлекая разработчика. Это экономит время и снижает риск случайно сломать работающий код.

Надёжность и простота внедрения в любой проект

Модуль спроектирован так, чтобы его установка не создавала рисков для работающего сайта. Даже если вы решите отключить или удалить mcart.logger, все точки логирования в вашем коде просто перестанут работать — они не вызовут ошибок или фатальных сбоев. Это гарантирует стабильность системы в любой ситуации.

Архитектура модуля построена на паттерне Dependency Injection через ServiceLocator. На практике это означает, что вы можете добавить логирование в любой класс приложения одной строкой, не привязываясь к конкретной реализации. Модуль легко внедряется как в новый проект, так и в существующий код, не требуя глобального рефакторинга. Подробные инструкции по установке и настройке вы найдёте в прилагаемом файле README.md.