shalvah/monolog-pusher

Monolog handler for sending logs to Pusher

2.2 2021-05-05 22:44 UTC

Requires

• php: >= 7.2
• monolog/monolog: ^2.0
• pusher/pusher-php-server: ^4.0 | ^5.0 | ^6.0

Requires (Dev)

• mockery/mockery: ^1.1
• phpunit/phpunit: ^7.2

MIT

• Shalvah A

• logging
• monolog
• error
• logs
• pusher

README

Monolog handler that sends logs to Pusher Channels.

Installation

composer require shalvah/monolog-pusher

Usage

• Create a new PusherHandler, passing in the Pusher constructor options as an array:

$config = ['YOUR_APP_KEY', 'YOUR_APP_SECRET', 'YOUR_APP_ID', ['cluster' => 'YOUR_APP_CLUSTER']];
$handler = new \Shalvah\MonologPusher\PusherHandler($config);

• Alternatively, if you've already got an existing Pusher instance, you can pass that to the handler:

$pusher = new \Pusher\Pusher();
$handler = new \Shalvah\MonologPusher\PusherHandler($pusher);

• Attach the handler to your Monolog logger:

$logger = new \Monolog\Logger('pusher-logs');
$logger->pushHandler($handler);

• Now you can call the various log methods (info, error, debugand so forth) on your logger to send a log message to Pusher. The name of the Pusher channel used will be the name you set when creating your Logger (in the above example, "pusher-logs"). The name of the event will be log:

$logger->error('oops!');

By default, the PusherHandler will only log messages of level error and above. You can change this by passing a minimum level as a second parameter to the constructor:

$handler = new \Shalvah\MonologPusher\PusherHandler($config, \Monolog\Logger::DEBUG);