vube/monolog-splunk-formatter

Splunk Line Formatter for Monolog

Splunk Formatter

, _(*1)

A Splunk Formatter for Monolog, _(*2)

About

vube/monolog-splunk-formatter is a formatter for use with Monolog. It augments the Monolog LineFormatter by adding Splunk-optimized handling of associative array contexts., _(*3)

Prerequisites/Requirements

• PHP 5.3.0 or greater
• Composer

Installation

Installation is possible using Composer, _(*4)

composer require vube/monolog-splunk-formatter ~1.0

Usage

Create an instance of \Vube\Monolog\Formatter\SplunkLineFormatter and set it as the formatter for the \Monolog\Handler\StreamHandler that you use with your \Monolog\Logger instance., _(*5)

use \Monolog\Logger;
use \Monolog\Handler\StreamHandler;
use \Vube\Monolog\Formatter\SplunkLineFormatter;

$log = new Logger('DEMO');
$handler = new StreamHandler('php://stdout', Logger::WARNING);
$handler->setFormatter(new SplunkLineFormatter());
$log->pushHandler($handler);

$log->addError('Bad stuff happened', array('detail1' => 'something', 'detail2' => 'otherthing'));

Unit Testing

vube/monolog-splunk-formatter ships with unit tests using PHPUnit., _(*6)

• If PHPUnit is installed globally run phpunit to run the tests., _(*7)

• If PHPUnit is not installed globally, install it locally through composer by running composer install --dev. Run the tests themselves by calling vendor/bin/phpunit., _(*8)

Unit tests are also automatically run on Travis CI, _(*9)

License

vube/monolog-splunk-formatter is released under the MIT public license. See the enclosed LICENSE for details., _(*10)

Thanks

Thanks to Bramus for contributing a Monolog formatter, I was inspired by and reused some of his work., _(*11)