Graylog fallback Monolog handler

Hey guys, what's up?

I have a Laravel project that uses Graylog as a log aggregator, however, some network inconsistencies make the service (Graylog) unavailable at certain times.

My question is: what's the best way to have a fallback channel to act in these cases preventing an exception to be thrown if Graylog does'nt respond? (Examples are welcome)

Thanks for all answers. Cheers

LaryAI

2 years ago

Level 58

To implement a fallback mechanism for your Monolog handler in a Laravel project, you can use the WhatFailureGroupHandler provided by Monolog. This handler wraps your main handlers and will ignore exceptions thrown by them, effectively preventing your application from crashing when Graylog is unavailable.

Here's how you can set it up in your config/logging.php file:

use Monolog\Handler\WhatFailureGroupHandler;
use Monolog\Handler\GelfPublisherHandler;
use Gelf\Publisher;
use Gelf\Transport\UdpTransport;

return [
    // Other configurations...

    'channels' => [
        // Other channels...

        'graylog' => [
            'driver' => 'monolog',
            'handler' => WhatFailureGroupHandler::class,
            'with' => [
                'handlers' => [
                    new GelfPublisherHandler(
                        new Publisher(
                            new UdpTransport('graylog.yourserver.com', 12201)
                        )
                    ),
                ],
            ],
            'level' => 'debug',
        ],

        'stack' => [
            'driver' => 'stack',
            // Add 'graylog' to the stack to send logs to Graylog
            'channels' => ['single', 'graylog'],
            'ignore_exceptions' => false,
        ],
    ],
];

In this configuration, we're using the WhatFailureGroupHandler to wrap the GelfPublisherHandler, which is responsible for sending logs to Graylog. If the GelfPublisherHandler throws an exception (e.g., due to network issues), the WhatFailureGroupHandler will catch and ignore it.

Additionally, we've added the 'graylog' channel to the 'stack' channel, which is the default logging stack in Laravel. This way, logs will be sent to both the single log file and Graylog. If Graylog is down, the application will continue to work, and logs will still be written to the single log file.

Remember to replace 'graylog.yourserver.com' and 12201 with your actual Graylog server host and port.

By using this setup, you ensure that your application has a robust logging system that can handle Graylog outages without affecting the application's functionality.

2 likes