iHead: Logs — Monolog 3 in the Bitrix admin panel

What this solution does

The iHead: Logs module integrates Monolog 3 functionality into the Bitrix administration panel. It provides color-coded log entries, marking errors in red and successful operations in green. Built-in filters and search functionality allow for rapid identification of issues. Automatic log rotation prevents files from growing excessively large. The module is ready to use immediately after installation without requiring additional configuration.

To use the module in code, include it via the \Bitrix\Main\Loader class. Instantiate the \IHead\Logs\FileLogger class by specifying a category name, such as 'user'. Then call methods like info or error to write messages, passing the text and an array of context data.

The iHead: Logs module replaces the standard Bitrix Event Log with a user-friendly interface featuring color-coded prefixes and flexible filtering by level, prefix, or text. Unlike the built-in solution where data is mixed, this module provides separate logs for different tasks. Installation via the marketplace requires no modifications to the core system.

Data is stored by default in the /local/.logs directory. Automatic file rotation triggers based on size and age, archiving or deleting old records without manual intervention. Leveraging the Monolog 3 library, the module supports standard handlers for external systems, including integration with Slack, Telegram, and Graylog, as well as HTTP and file handlers.

The system operates independently from the core, avoiding locks and ensuring minimal performance impact. The file mode can process tens of thousands of records per minute on a standard SSD. The module is compatible with Bitrix editions ranging from 'First Site' to 'Business', as well as boxed versions of Bitrix24, and supports PHP versions 8.2 through 8.3. Upon module removal, log files remain intact without leaving broken dependencies.

The iHead: Logs module provides viewing and management of Monolog 3 logs directly within the Bitrix administration panel. The solution is compatible with projects using Monolog and supports any log formats and channels. You can write logs using your own code or third-party services, then filter and analyze them through a convenient interface without modifying the core system or relying on console utilities like grep and tail.

The module functionality includes fine-tuning of parameters, management of the log list with the ability to set names, descriptions, and file rotation. Viewing options include advanced filters, search, and data visualization. Special attention is given to improving the user experience: the implementation of prefixes reduces cognitive load for developers. A helper tool is also provided, allowing logs to be written in just a few lines of code.

General iT can install “iHead: Logs — Monolog 3 in the Bitrix admin panel”, configure its settings and verify its operation in the existing project.