README

Send Monolog logs directly to a Discord webhook using rich embeds, automatic formatting, and safe value normalization.

Installation

composer require ipagdevs/monolog-discord-handler

Usage (Plain Monolog)

use Monolog\Logger;
use Monolog\Level;
use IpagDevs\Logging\DiscordHandler;

$logger = new Logger('app');

$logger->pushHandler(
    new DiscordHandler(
        webhook_url: 'https://discord.com/api/webhooks/xxx',
        level: Level::Debug
    )
);

$logger->error('System error occurred', [
    'user_id' => 123,
    'exception' => new RuntimeException('Critical failure'),
]);

How it works

The handler automatically:

Converts logs into Discord embeds
Respects Discord field and message limits
Normalizes values:
- array/object → pretty JSON
- Throwable → formatted stacktrace block
- Closure → callable[closure]
- string callables → callable:method
Safely truncates large payloads
Prevents application crashes (fail-safe HTTP handling)

Laravel Usage

In config/logging.php:

'channels' => [
    'discord' => [
        'driver' => 'monolog',
        'handler' => IpagDevs\Logging\DiscordHandler::class,
        'with' => [
            'webhook_url' => env('DISCORD_WEBHOOK_URL'),
        ],
        'level' => 'debug',
    ],
],

In .env:

DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/xxx

Example

Log::error('Payment failed', [
    'order_id' => 999,
    'user' => [
        'id' => 1,
        'name' => 'Lucas',
    ],
    'exception' => new RuntimeException('Gateway timeout'),
]);

This will be sent to Discord as an embed with:

log level as title
message as description
context automatically converted into fields

Safety

This handler is designed to be safe by default:

never throws exceptions outside the handler
never blocks application execution
ignores HTTP failures silently

License

The MIT License (MIT). Please see License File for more information.

ipagdevs / monolog-discord-handler

Maintainers

Package info

Statistics

Security