README

Send Laravel logs to a Telegram chat via Telegram Bot.

Installation

To install the package you can use Composer.

composer require redrum0x/laravel-telegram-logging

Publish the package configuration file using the following artisan command:

php artisan vendor:publish --provider "redrum0x\TelegramLogger\TelegramLoggerServiceProvider"

To send messages to your Telegram Chat, you first need a Telegram Bot. If you don't have one, see in this Telegram Instructions how to create one.

Set your Bot Token and chat_id (user, channel or group that will receive log messages) and set as environment variable.

Add in your .env, the follows variables:

TELEGRAM_LOGGING_BOT_TOKEN=bot_token
TELEGRAM_LOGGING_CHAT_ID=chat_id

Usage

Add the new Log Channel in config/logging.php:

'telegram' => [
    'driver' => 'custom',
    'via'    => redrum0x\TelegramLogger\TelegramLogger::class,
    'level'  => 'debug',
]

If you use the stack channel as default logger, you can just the telegram channel to your stack:

'stack' => [
    'driver' => 'stack',
    'channels' => ['single', 'telegram'],
]

Or you can simply change the default logging channel in the .env file.

LOG_CHANNEL=telegram

Great! Your Laravel project can now send logs to your Telegram chat.

You can use Laravel Log Facade to send logs to your chat:

// Use the Laravel Log Facade
use Illuminate\Support\Facades\Log;
...

// All Laravel log leves are avaiable
Log::channel('telegram')->emergency($message);
Log::channel('telegram')->alert($message);
Log::channel('telegram')->critical($message);
Log::channel('telegram')->error($message);
Log::channel('telegram')->warning($message);
Log::channel('telegram')->notice($message);
Log::channel('telegram')->info($message);
Log::channel('telegram')->debug($message);

Telegram Instructions

To use this package, you need to create a Telegram bot to send messages to your chat.

If you need help, check out these Telegram Instructions that I created for you.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT