PHPackages optim1zer/monolog-telegram - 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. optim1zer/monolog-telegram ActiveLibrary[Logging & Monitoring](/categories/logging) optim1zer/monolog-telegram ========================== Handler for Monolog to send logs by Telegram v1.0.0(7y ago)091MITPHPPHP >=5.6.0 Since Sep 23Pushed 7y ago1 watchersCompare [ Source](https://github.com/optim1zer/monolog-telegram)[ Packagist](https://packagist.org/packages/optim1zer/monolog-telegram)[ RSS](/packages/optim1zer-monolog-telegram/feed)WikiDiscussions master Synced today READMEChangelogDependencies (3)Versions (2)Used By (0) monolog-telegram ================ [](#monolog-telegram) Handler for Monolog to send logs by Telegram in HTML format Requirements ------------ [](#requirements) - PHP 5.6 or above - Guzzle 6+ Instalation with composer ------------------------- [](#instalation-with-composer) ``` composer require optim1zer/monolog-telegram ``` Declaring handler object ------------------------ [](#declaring-handler-object) To declare this handler, you need to know the bot token and the chat identifier(chat\_id) to which the log will be sent. ``` // ... $handler = new \optim1zer\Monolog\TelegramHandler('', , ); // ... ``` **Example:** ``` $log = new \Monolog\Logger('telegram_channel'); $handler = new \optim1zer\Monolog\TelegramHandler( '000000000:XXXXX-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 123456789, \Monolog\Logger::DEBUG ); $handler->setFormatter(new \Monolog\Formatter\LineFormatter("%message%", null, true)); $log->pushHandler($handler); $log->debug('Test message'); ``` The above example is using standard LineFormatter from Monolog package. You can write and use your own message formatter for better logs format. **Example with proxy (for russian servers):** ``` $handler = new \optim1zer\Monolog\TelegramHandler('', , ); $handler->setProxy('http://username:password@192.168.16.1:80'); // or simply 'http://192.168.16.1:80' $handler->setFormatter(new \Monolog\Formatter\LineFormatter("%message%", null, true)); ``` Creating a bot -------------- [](#creating-a-bot) To use this handler, you need to create your bot on telegram and receive the Bot API access token. To do this, start a conversation with **@BotFather**. **Conversation example:** In the example below, I'm talking to **@BotFather**. to create a bot named "Logger Bot" with user "@logger\_bot". ``` Me: /newbot --- @BotFather: Alright, a new bot. How are we going to call it? Please choose a name for your bot. --- Me: Logger Bot --- @BotFather: Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot. --- Me: logger_bot --- @BotFather: Done! Congratulations on your new bot. You will find it at telegram.me/cronus_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. By the way, when you've finished creating your cool bot, ping our Bot Support if you want a better username for it. Just make sure the bot is fully operational before you do this. Use this token to access the HTTP API: 000000000:XXXXX-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx For a description of the Bot API, see this page: https://core.telegram.org/bots/api ``` Get a chat identifier --------------------- [](#get-a-chat-identifier) To retrieve the chat\_id in which the logs will be sent, the recipient user will first need a conversation with the bot. After the conversation has started, make the request below to know the chat\_id of that conversation. **URL:** [https://api.telegram.org/bot\_token\_/getUpdates](https://api.telegram.org/bot_token_/getUpdates) **Example:** ``` Request ------- GET https://api.telegram.org/bot000000000:XXXXX-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx/getUpdates Response -------- { "ok": true, "result": [ { "update_id": 121227832, "message": { "message_id": 1, "from": { "id": 1583498345345, "first_name": "*****", "last_name": "*****", "username": "Optim1zer" }, "chat": { "id": 123456789, "first_name": "*****", "last_name": "*****", "username": "Optim1zer", "type": "private" }, "date": 1510701612, "text": "test message" } } ] } ``` In the above request, the chat\_id is represented by the number "123456789" (result.message.chat.id). ### Health Score 26 — LowBetter than 43% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community7 Small or concentrated contributor base Maturity56 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 Unknown Total 1 Last Release 2786d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/c8786601fcd30f2bcc91d3ea141b2c64b5698b6c42aac32344dd73c47e763d99?d=identicon)[optim1zer](/maintainers/optim1zer) --- Top Contributors [![optim1zer](https://avatars.githubusercontent.com/u/7982476?v=4)](https://github.com/optim1zer "optim1zer (3 commits)") --- Tags logloggingtelegrammonolog ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/optim1zer-monolog-telegram/health.svg) ``` [![Health](https://phpackages.com/badges/optim1zer-monolog-telegram/health.svg)](https://phpackages.com/packages/optim1zer-monolog-telegram) ``` ### Alternatives [rahimi/monolog-telegram A handler for Monolog that sends messages to Telegram Channels 6980.2k1](/packages/rahimi-monolog-telegram)[inpsyde/wonolog Monolog-based logging package for WordPress. 183617.9k6](/packages/inpsyde-wonolog)[mero/telegram-handler Monolog handler to send log by Telegram 36113.3k](/packages/mero-telegram-handler)[jacklul/monolog-telegram Monolog handler that sends logs through Telegram bot to any chat in HTML format 2364.7k1](/packages/jacklul-monolog-telegram)[thecoder/laravel-monolog-telegram Telegram Handler for Monolog 2939.5k](/packages/thecoder-laravel-monolog-telegram)[logtail/monolog-logtail Logtail handler for Monolog 233.2M3](/packages/logtail-monolog-logtail) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)