phippsytech / monologsnag
A handler for monolog that logs to LogSnag
Requires
- monolog/monolog: ^3.2
README
MonoLogSnag is a handler for Monolog that pushes your logs to LogSnag, a use-case agnostic event tracking and analytics platform.
Installation
To install MonoLogSnag, run the following command:
composer require phippsytech/monologsnag
Initialising MonoLogSnag
To use MonoLogSnag with Monolog you need to initialise it like this:
use Monolog\Logger; use PhippsyTech\MonoLogSnag\Handler as MonoLogSnagHandler; $token = <insert your api key here>; $project = "test"; $channel = "test"; // Create a log channel $log = new Logger($channel); // Push the MonoLogSnagHandler to the log channel $monoLogSnagHandler = new MonoLogSnagHandler($apiKey, $project); $log->pushHandler($monoLogSnagHandler);
To make things easier to read, in all following code snippets I will refer to the above code with // --> Initialise MonoLogSnag here <--
Basic Usage
This will send a message with an empty description labeled "Hello World" to LogSnag
// --> Initialise MonoLogSnag here <-- // Send log to LogSnag $log->info('Hello World');
Adding Description
In Monolog you can add extra data in the logging context. This is in the form of an array.
MonoLogSnag converts the array into Markdown and sends it via the description:
// --> Initialise MonoLogSnag here <-- // Send log to LogSnag $log->info('A customer just placed an order', [ 'Product' => "Happy Thoughts", 'Price' => 1.95 ]);
Adding Tags
LogSnag lets you include up to 5 tags on a log entry. MonoLogSnag uses the extra
part of a $record
to hold these tags. You can then filter on these tags in LogSnag.
To add the tags we use the pushProcessor()
to modify the $record->extra
array.
In the following example we are adding the log level as a tag named level
// --> Initialise MonoLogSnag here <-- // Add a tag called level that contains the current log level. $log->pushProcessor(function ($record) { $record->extra['level'] = $record->level->name; return $record; }); // Send log to LogSnag. This log is recording a page visit. $page = $_SERVER['REQUEST_URI'] ?? 'unknown'; $log->info('Page Visit', [ 'page' => $_SERVER['REQUEST_URI'] ]);
Log Level Icons and Notifications
Currently all log levels have notify: true
.
The following icons are used for each log level:
debug: 😶
info: 🙂
notice: 🤔
warning: 🧐
error: 😠
critical: 😡
alert: 🤬
emergency: 💀
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Looking Ahead
I plan to add the ability to override the default icon and notify settings in the future. If you'd like to see this happen sooner, please get in touch or consider submitting a pull request with the feature added.
Authors and acknowledgments
Michael Phipps (Author) - Twitter
LogSnag - Website - GitHub - Twitter
Shayan Taslim - Twitter
Monolog - Website - GitHub
Jordi Boggiano - Twitter
License
MonoLogSnag is licensed under the MIT License. See LICENSE for more information.