iHead: Логи — Monolog 3 в админке Битрикс

Что умеет решение

Модуль iHead: Логи интегрирует функциональность библиотеки Monolog 3 в административную панель Битрикс. Решение обеспечивает цветовую маркировку записей: сообщения об ошибках отображаются красным, успешные операции — зелёным. Встроенные фильтры и поиск позволяют быстро находить проблемы в логах. Автоматическая ротация файлов предотвращает их чрезмерное разрастание. Модуль готов к работе сразу после установки без дополнительных настроек.

Для использования в коде подключите модуль через класс \Bitrix\Main\Loader. Создайте экземпляр класса \IHead\Logs\FileLogger, указав имя категории, например 'user'. Затем вызовите методы для записи сообщений, такие как info или error, передавая текст и массив контекстных данных.

Модуль iHead: Логи заменяет стандартный Журнал событий Битрикс, предлагая удобный интерфейс с цветовыми префиксами и гибкими фильтрами по уровню, префиксу или тексту. В отличие от встроенного решения, где данные перемешаны, здесь реализовано разделение логов по задачам. Установка через маркетплейс не требует изменений в ядре системы.

Хранение данных происходит по умолчанию в директории /local/.logs. Автоматическая ротация файлов срабатывает по размеру и сроку: старые записи архивируются или удаляются без участия администратора. Благодаря использованию библиотеки Monolog 3 поддерживаются стандартные обработчики для внешних систем, включая отправку в Slack, Telegram, Graylog, а также работу через HTTP и файловые хендлеры.

Система работает изолированно от ядра, не создавая блокировок, что обеспечивает минимальное влияние на производительность. Файловый режим способен обрабатывать десятки тысяч записей в минуту на обычном SSD. Модуль совместим с редакциями Битрикс от «Первый сайт» до «Бизнес», а также с коробочными версиями Битрикс24, и поддерживает PHP в диапазоне версий 8.2–8.3. При удалении модуля файлы логов сохраняются, не оставляя сломанных зависимостей.

Модуль iHead: Логи обеспечивает просмотр и управление логами Monolog 3 непосредственно в административной панели Битрикс. Решение совместимо с проектами, использующими Monolog, и поддерживает любые форматы и каналы логирования. Вы можете писать логи собственным кодом или сторонними сервисами, а затем фильтровать и анализировать их через удобный интерфейс без необходимости модификации ядра системы или использования консольных утилит grep и tail.

Функционал модуля включает тонкую настройку параметров, управление списком логов с возможностью задания названий, описаний и ротации файлов. Для просмотра доступны расширенные фильтры, поиск и визуализация данных. Особое внимание уделено улучшению пользовательского опыта: внедрение префиксов снижает когнитивную нагрузку разработчика. Также предоставляется вспомогательный инструмент, позволяющий записывать логи в несколько строк кода.

General iT может установить «iHead: Логи — Monolog 3 в админке Битрикс», настроить параметры модуля и проверить его работу в существующем проекте.