marekmiklusek/telegram-logger

A Laravel package to send logs to Telegram.

v1.0.9 2025-06-07 03:11 UTC

Requires

• php: ^8.2
• laravel/framework: ^11.31

MIT

• Marek Miklusek

• package
• php
• logger
• laravel
• telegram
• laravel-telegram-logger

README

📢 Laravel Telegram Logger

🚀 Laravel Telegram Logger is a package that sends Laravel log messages and exceptions to Telegram for real-time monitoring.

📌 Features

✅ Real-time logging to Telegram
✅ Supports all log levels (debug, info, warning, error, etc.)
✅ Automatic exception handling (captures error file, line, and message)
✅ Configurable log level filtering
✅ Silent notifications support (to avoid sound/vibration in Telegram)
✅ Minimal setup, easy to integrate
✅ Can be enabled/disabled via configuration

🛠 Installation

Require the package via Composer:

composer require marekmiklusek/telegram-logger

🔧 Configuration

Publish the package configuration:

php artisan vendor:publish --tag=telegram-logger-config

This will create a config file at config/telegram-logger.php.

.env Configuration

Add your Telegram Bot API token and Chat ID to your .env file:

TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id

Config File (config/telegram-logger.php)

return [
    'bot_token' => env('TELEGRAM_BOT_TOKEN'),
    'chat_id' => env('TELEGRAM_CHAT_ID'),
    'level' => 'error',
    'silent_notification' => false,
    'is_enabled' => true,
];

🏗 Usage

Basic Logging

Use Laravel's Log facade as usual, and errors will be sent to Telegram automatically:

use Illuminate\Support\Facades\Log;

Log::debug('Debug message');
Log::info('Info message');
Log::warning('Warning message');
Log::error('Error message');

Logging with Context

You can pass additional context to logs:

Log::error('User not found', ['user_id' => 42, 'action' => 'login']);

Logging Exceptions

Exceptions are automatically detected and logged:

try {
    throw new \Exception('Database connection failed!');
} catch (\Exception $exception) {
    Log::error('Unhandled exception occurred', ['exception' => $exception]);
}

⚙ How It Works

The package listens to Laravel's logging events and sends structured messages to Telegram.

Example Telegram Log Output

🛠️ Application: MyLaravelApp
🌍 Environment: production

❌ Level: ERROR
📝 Message: "User not found"

📌 File:
/var/www/html/app/Http/Controllers/UserController.php
🎯 Line: 45

📂 Context:
{
  "user_id": 42,
  "action": "login"
}

⏳ Time: 2025-02-19 10:15:30

Example Telegram Log Output (Exception)

🛠️ Application: MyLaravelApp
🌍 Environment: production

❌ Level: ERROR
🔥 Exception Occurred !
💥 Message: "Database connection failed!"

📌 File:
/var/www/html/app/Services/DatabaseService.php
🎯 Line: 87

⏳ Time: 2025-02-19 10:18:45

🎯 Advanced Configuration

1️⃣ Logger Enablement

You can enable or disable the logger in config/telegram-logger.php:

return [
    'is_enabled' => false,
];

✅ If true, logs will be sent to Telegram as configured
✅ If false, the logger will be completely disabled (no logs sent)

2️⃣ Log Level Filtering

You can define the minimum log level in config/telegram-logger.php:

return [
    'level' => 'warning',
];

• debug: Logs everything
• info: Logs info, notice, warning, error, critical, alert, emergency
• error: Logs error, critical, alert, emergency
• critical: Logs only critical, alert, emergency

3️⃣ Silent Notifications

Enable silent notifications (no sound/vibration) in config/telegram-logger.php

return [
    'silent_notification' => true,
];

✅ If true, messages will be sent silently.
✅ If false, Telegram will send notifications normally.

💡 Troubleshooting

❓ Logs not appearing in Telegram?

1. Check that your .env values are correctly set:

php artisan config:clear
php artisan config:cache

1. Ensure your bot has permission to send messages to your chat.

❓ Getting "Chat not found" error?

• Make sure you have sent a message to your bot first.
• Use this tool to get your Chat ID.

📜 License

This package is open-source and licensed under the MIT License.