PHPackages itrukhin/bxmonolog - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. itrukhin/bxmonolog ActiveLibrary[Logging & Monitoring](/categories/logging) itrukhin/bxmonolog ================== Monolog logger for 1C-Bitrix v1.2(1y ago)72.3k4[1 issues](https://github.com/itrukhin/bxmonolog/issues)MITPHP Since Feb 8Pushed 1y ago1 watchersCompare [ Source](https://github.com/itrukhin/bxmonolog)[ Packagist](https://packagist.org/packages/itrukhin/bxmonolog)[ Docs](https://github.com/itrukhin/bxmonolog.git)[ RSS](/packages/itrukhin-bxmonolog/feed)WikiDiscussions master Synced 3w ago READMEChangelog (3)Dependencies (1)Versions (4)Used By (0) Адаптер [Monolog](https://github.com/Seldaek/monolog) для 1С-Битрикс ==================================================================== [](#адаптер-monolog-для-1с-битрикс) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/bfdc7211f3cc420a955c3b0345d13a433f21fbee41a4c6448ca1bcf95ab843f7/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f697472756b68696e2f62786d6f6e6f6c6f672f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/itrukhin/bxmonolog/?branch=master)[![Build Status](https://camo.githubusercontent.com/bbf69bc822348800e356fbbd5c3779e0ff29056626cbf3017cb186b65785d7cc/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f697472756b68696e2f62786d6f6e6f6c6f672f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/itrukhin/bxmonolog/build-status/master)[![Code Intelligence Status](https://camo.githubusercontent.com/b198321ce188e248ee63b5aa2850e1acb5a1e901604d2b496e2c7a4137621d9e/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f697472756b68696e2f62786d6f6e6f6c6f672f6261646765732f636f64652d696e74656c6c6967656e63652e7376673f623d6d6173746572)](https://scrutinizer-ci.com/code-intelligence) Адаптер позволяет организовать запись и хранение файлов логов в Битриксе. Основные возможности: - Хранение всех логов в выделенной специальной папке на сервере - Автоматическое создание вложенных папок для группировки файлов логов - Ошибки ядра 1С-Битрикс пишутся во вложенную папку bitrix, которую можно переназначить - Каждый день логи пишутся в отдельный файл вида YYYY-MM-DD.log - Автоматическое удаление файлов логов старше N дней - Конфигурирование через глобальные переменные $\_ENV, например с помощью [Dotenv](https://dev.1c-bitrix.ru/community/webdev/user/42376/blog/39344/) - Аварийный лог inner\_error.log для ошибок самого логгера Установка --------- [](#установка) ``` composer require itrukhin/bxmonolog:dev-master ``` Предполагается, что у вас Битрикс уже умеет работать с автозагрузкой composer Настройка .settings.php ----------------------- [](#настройка-settingsphp) ``` 'exception_handling' => array ( 'value' => array ( 'debug' => ((bool) $_ENV['APP_DEBUG']), 'handled_errors_types' => E_ALL & ~E_WARNING & ~E_NOTICE & ~E_STRICT & ~E_USER_NOTICE & ~E_DEPRECATED, 'exception_errors_types' => E_ALL & ~E_NOTICE & ~E_WARNING & ~E_STRICT & ~E_USER_WARNING & ~E_USER_NOTICE & ~E_COMPILE_WARNING & ~E_DEPRECATED, 'ignore_silence' => false, 'assertion_throws_exception' => true, 'assertion_error_type' => 256, 'log' => array ( 'class_name' => '\App\Monolog\ExceptionHandlerLog', ), ), 'readonly' => false, ), ``` Настройки окружения ------------------- [](#настройки-окружения) - **APP\_DEBUG** - включить/выключить отладку, используется только в `.settings.php` - **APP\_DEBUG\_LEVEL** - минимальный уровень, для которого будет выполняться запись в лог. По умолчанию `DEBUG`, это значит, что будут выводиться все ошибки. Можно на проде, например, ограничить уровнем `ERROR` - **APP\_LOG\_FOLDER** - папка логов, относительно `DOCUMENT_ROOT`. По умолчанию `/log/` - **APP\_LOG\_BITRIX\_CHANNEL** - подпапка логов по умолчанию. Если не задано, будет создана папка `bitrix`, относительно `APP_LOG_FOLDER`. Для записи своих логов рекомендуется явно указывать папку, так как в папку `bitrix` будут записываться ошибки ядра. Примеры использования ===================== [](#примеры-использования) Код примеров есть в папке [examples](examples/) При настроенном `.settings.php` (см. выше) все ошибки битрикса будут записываться в файл ``` DOCUMENT_ROOT/APP_LOG_FOLDER/APP_LOG_BITRIX_CHANNEL/YYYY-MM-DD.log ``` что, по умолчанию, соответствует пути `/log/bitrix/` от корня сервера. Ошибки ядра имеют уровень `CRITICAL` Для записи произвольных логов необходимо вначале создать экземпляр объекта лога ``` $log = new \App\Log('test'); ``` где test - имя папки, относительно `APP_LOG_FOLDER`, в которую будут писаться логи. Подапка, при ее отсутствии, будет создана автоматически. По возможности, будут установлены аттрибуты `BX_DIR_PERMISSIONS` Далее для каждого уровня лога может быть вызван одноименный метод, например: ``` $log->info('log info message'); $log->debug($_SERVER); $log->alert([1, 2]); $log->notice(\Bitrix\Main\Application::getConnection()); ``` В результате мы получаем файлы логов с отформатированным содержимым, пример: ``` CRITICAL 12.11.2020 11:02:01 Bitrix\Main\DB\SqlQueryException: Mysql query error: [] in /var/www/html/bitrix/modules/main/classes/mysql/database.php:183 Stack trace: #0 /var/www/html/bitrix/modules/statistic/classes/mysql/stoplist.php(223): CDatabaseMysql->Query() #1 /var/www/html/bitrix/modules/main/classes/general/module.php(480): CStoplist::Check() #2 /var/www/html/bitrix/modules/main/include.php(303): ExecuteModuleEventEx() #3 /var/www/html/bitrix/modules/main/include/prolog_before.php(14): require_once('/var/www/html/b...') #4 /var/www/html/local/scripts/1c_parser.php(14): require('/var/www/html/b...') #5 {main} ------------------------------------------------------------------------ CRITICAL 12.11.2020 11:02:01 Bitrix\Main\DB\SqlQueryException: Mysql query error: [] in /var/www/html/bitrix/modules/main/classes/mysql/database.php:183 Stack trace: #0 /var/www/html/bitrix/modules/statistic/classes/mysql/stoplist.php(223): CDatabaseMysql->Query() #1 /var/www/html/bitrix/modules/main/classes/general/module.php(480): CStoplist::Check() #2 /var/www/html/bitrix/modules/main/include.php(303): ExecuteModuleEventEx() #3 /var/www/html/bitrix/modules/main/include/prolog_before.php(14): require_once('/var/www/html/b...') #4 /var/www/html/local/scripts/yml_cli.php(17): require('/var/www/html/b...') #5 {main} ------------------------------------------------------------------------ ``` Отправка ошибок в Telegram ========================== [](#отправка-ошибок-в-telegram) Для оперативной реакции на ошибки, необходимо узнавать о них сразу, как только они возникли. Одним из удобных способов является отправка ошибок в чат Telegram. О возникновении ошибки на сайте немедленно будут проинформированы все участники чата. Настройка Telegram ------------------ [](#настройка-telegram) Необходимо создать бота в телеграм с помощью [@BotFather](https://core.telegram.org/bots#3-how-do-i-create-a-bot). Для бота мы получим API Token вида `000000000:XXXXXXXXXXXXXXXXXXXX`. Далее нужно создать чат, в который бот будет писать сообщения, и добавить бота администратором в этот чат. Второй параметр, который нам необходимо получить - это ChatID. Получить его можно выполнив запрос вида `https://api.telegram.org/botXXX:YYYYY/getUpdates`, где `XXX:YYYYY` - это API Token бота. В ответ будет json, из которого нужно получить ChatID. **Пример ответа** ``` {"ok":true,"result":[{"update_id":81329501, "message":{"message_id":975,"from":{"id":962548471,"is_bot":false,"first_name":"Trajano","last_name":"Roberto","username":"TrajanoRoberto","language_code":"en"},"chat":{"id":-1001202656383,"title":"R\u00e1dioRN - A voz da na\u00e7\u00e3o!","type":"supergroup"},"date":1587454914,"left_chat_participant":{"id":1215098445,"is_bot":true,"first_name":"MediaFlamengoRawBot","username":"MediaFlamengoRawBot"},"left_chat_member":{"id":1215098445,"is_bot":true,"first_name":"MediaFlamengoRawBot","username":"MediaFlamengoRawBot"}}},{"update_id":81329502, "message":{"message_id":976,"from":{"id":962548471,"is_bot":false,"first_name":"Trajano","last_name":"Roberto","username":"TrajanoRoberto","language_code":"en"},"chat":{"id":-1001202656383,"title":"R\u00e1dioRN - A voz da na\u00e7\u00e3o!","type":"supergroup"},"date":1587454932,"new_chat_participant":{"id":1215098445,"is_bot":true,"first_name":"MediaFlamengoRawBot","username":"MediaFlamengoRawBot"},"new_chat_member":{"id":1215098445,"is_bot":true,"first_name":"MediaFlamengoRawBot","username":"MediaFlamengoRawBot"},"new_chat_members":[{"id":1215098445,"is_bot":true,"first_name":"MediaFlamengoRawBot","username":"MediaFlamengoRawBot"}]}}]} ``` нас интересует **"chat":{"id":-1001202656383,"title"...** ChatID это `-1001202656383` Настройка BxMonolog ------------------- [](#настройка-bxmonolog) За настройку параметров отправки сообщений в Telegram отвечают следующие параметры $\_ENV - **APP\_LOG\_TELEGRAM** - включить/выключить отправку в Telegram. Должно быть установлено в **1**, или **true**, или **on** - **APP\_LOG\_TELEGRAM\_KEY** - API Token бота - **APP\_LOG\_TELEGRAM\_CHATID** - ChatID Отправка в Telegram ------------------- [](#отправка-в-telegram) Для отправки сообщение в телеграм, реализован метод telegram, аналогичный методу log в PSR-3 ``` $log = new \App\Log('test'); try { // my code } catch(Exception $e) { $log->telegram(\Psr\Log\LogLevel::ERROR, $e, ['source' => 'my code error']) } ``` Результатом будет запись ошибки в лог и сообщение в Telegram, начинающееся с *my code error* и содержащее текст ошибки, имя файла. Также можно писать любой текст. По умолчанию включен формат отправки HTML, включены уведомления, отключена ссылка на просмотр сообщения в вебе. Указывать source не обязательно. ### Настройки, которые можно передавать через массив context [](#настройки-которые-можно-передавать-через-массив-context) - source - начало сообщения в Telegram - parse\_mode - по умолчанию HTML, но может быть null, Markdown, MarkdownV2 - disable\_notification - boolean, по умолчанию false - disable\_preview - boolean, по умолчанию true Также можно получить экземпляр логгера, с настройками по умолчанию, только для отправки сообщений в Telegram ``` $log = new \App\Log('telegram-messenger'); ``` Очистка логов ============= [](#очистка-логов) Для периодической очистки логов можно использовать метод ``` \App\Log::cleanLogs(15); ``` Который будет удалять файлы логов старше 15 дней. Метод возвращает строку вызова самого себя, поэтому может быть добавлен в агенты Битрикса. ### Health Score 31 — LowBetter than 66% of packages Maintenance30 Infrequent updates — may be unmaintained Popularity26 Limited adoption so far Community9 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~284 days Total 3 Last Release 674d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/804db35242f2ee50b9736bbf59f4b22cd5202a656e8a729235595fe8346b1ffb?d=identicon)[itrukhin](/maintainers/itrukhin) --- Top Contributors [![itrukhin](https://avatars.githubusercontent.com/u/5526173?v=4)](https://github.com/itrukhin "itrukhin (60 commits)") --- Tags 1c-bitrixbitrixbitrix-cmsloggingmonologtelegramtelegram-botloggingbitrixmonolog1C-Bitrixbitrix-cms ### Embed Badge ![Health badge](/badges/itrukhin-bxmonolog/health.svg) ``` [![Health](https://phpackages.com/badges/itrukhin-bxmonolog/health.svg)](https://phpackages.com/packages/itrukhin-bxmonolog) ``` ### Alternatives [naoray/laravel-github-monolog Log driver to store logs as github issues 10823.1k](/packages/naoray-laravel-github-monolog)[honeybadger-io/honeybadger-laravel Honeybadger Laravel integration 431.3M](/packages/honeybadger-io-honeybadger-laravel)[logtail/monolog-logtail Logtail handler for Monolog 243.6M3](/packages/logtail-monolog-logtail)[inpsyde/logzio-monolog Logz.io integration for Monolog 191.2M1](/packages/inpsyde-logzio-monolog)[jacklul/monolog-telegram Monolog handler that sends logs through Telegram bot to any chat in HTML format 2471.4k2](/packages/jacklul-monolog-telegram)[alexandre-daubois/monolog-processor-collection A collection of Monolog processors 1317.1k](/packages/alexandre-daubois-monolog-processor-collection) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)