You should really be

using monolog

Cascade-Guest: "Cascade WiFi 2008."

monolog

Software Developer at Cascade Energy, Inc.

Will Vaughn

@nackjicholsonn

github:nackjicholson

willieviseoae@gmail.com

will.vaughn@cascadeenergy.com

Symfony2, Silex, AngularJs

Amazon Web Services, NodeJS

monolog

You should really just be using monolog

Monolog

monolog

Monolog

Delivers logs
Configurable
Extensible

monolog

Monolog

Searchability
Monitoring
Reporting

monolog

Install


"require": {
    "monolog/monolog": "1.x"
}

composer.json


$ composer require "monolog/monolog"="1.x"

composer cli

monolog

debug

info

notice

warning

error

critical

alert

emergency

PSR-3

Detailed debug information

Interesting events

Normal but significant events

Exceptional occurrences, not errors

Expected runtime errors

Critical conditions, in need of action

Immediate action is necessary

Catastrophic failure, system unusable

monolog

100 -- Logger::DEBUG

200 -- Logger::INFO

250 -- Logger::NOTICE

300 -- Logger::WARNING

400 -- Logger::ERROR

500 -- Logger::CRITICAL

550 -- Logger::ALERT

600 -- Logger::EMERGENCY

PSR-3

Monolog levels:

monolog

Simple logs

<?php

use Monolog\Logger;

require 'vendor/autoload.php';

$logger = new Logger('channel');

$logger->debug('debug test');
$logger->warning('warning test');


[2014-11-01 21:46:40] channel.DEBUG: debug test [] []
[2014-11-01 21:46:40] channel.WARNING: warning test [] []

monolog

Monolog provides A TON of built in Handlers.

Handlers

StreamHandler
RotatingFileHandler
NativeMailerHandler
PushoverHandler
NewRelicHandler
LogglyHandler
GelfHandler (Graylog2)
ZendMonitorHandler

ChromePHPHandler
SwiftMailerHandler
RavenHandler (Sentry)
MongoDBHandler
DynamoDBHandler
ElasticSearchHandler
RedisHandler
HipChatHandler

and many more...

monolog

Log to multiple destinations.

Handlers


$filePath = __DIR__ . '/multiple.streams.log';

// Default takes everything >= Logger::DEBUG
$stdoutHandler = new StreamHandler('php://stdout');

// File only handles records with Level >= Logger::WARNING
$fileHandler = new StreamHandler($filePath, Logger::WARNING);

$logger = new Logger('channel');
$logger->pushHandler($stdoutHandler);
$logger->pushHandler($fileHandler);

$logger->info('stdout only');
$logger->warning('stdout and file');
$logger->debug('stdout only');
$logger->error('stdout and file');


# Logged to file

[2014-11-02 01:26:37] channel.WARNING: stdout and file [] []
[2014-11-02 01:26:37] channel.ERROR: stdout and file []


# Logged to stdout

[2014-11-02 01:26:37] channel.INFO: stdout only [] []
[2014-11-02 01:26:37] channel.WARNING: stdout and file [] []
[2014-11-02 01:26:37] channel.DEBUG: stdout only [] []
[2014-11-02 01:26:37] channel.ERROR: stdout and file []

monolog

Don't bother me unless theres a real problem.

Handlers


$handler = new StreamHandler('php://stdout');
$fingersCrossed = new FingersCrossedHandler($handler, Logger::CRITICAL);

$logger = new Logger("channel");
$logger->pushHandler($fingersCrossed);

// These aren't handled until a log of level >= Logger::CRITICAL
$logger->info('info msg');
$logger->notice('notice msg');

// All sent with this one
$logger->critical('critical msg');


# Logged to stdout as a batch

[2014-11-02 01:26:37] channel.INFO: info msg [] []
[2014-11-02 01:26:37] channel.NOTICE: notice msg [] []
[2014-11-02 01:26:37] channel.CRITICAL: critical msg [] []

monolog

Send it all at the end with BufferHandler.

Handlers


// Default to only handling levels >= Logger::CRITICAL
$gitterHandler = new GitterImHandler('apitoken', 'roomId');
$bufferHandler = new BufferHandler($gitterHandler);

$logger = new Logger("channel");
$logger->pushHandler($bufferHandler);

// Buffered, and handled as batch at the end.
$logger->debug('test.debug ignored.');
$logger->critical('test.critical in gitter.im');
$logger->notice('test.notice');
$logger->emergency('test.emergency in gitter.im');
$logger->error('test.error');

Trait for classes which have Logger as a dependency.

Injection


trait LoggerAwareTrait
{
    /** @var LoggerInterface */
    protected $logger;

    /**
     * Sets a logger.
     * 
     * @param LoggerInterface $logger
     */
    public function setLogger(LoggerInterface $logger)
    {
        $this->logger = $logger;
    }
}

monolog

Records


$record = array(
    'message' => string,
    'context' => array
    'level' => integer,
    'level_name' => string,
    'channel' => string,
    'datetime' => float (unix microtime)
    'extra' => array
);

The data currency of monolog.

monolog

"channel-environment-system"

Channels

// Too generic.
$logger = new Logger('foobar');
$logger = new Logger('myWebsite');

// Awesomely specific.
$logger = new Logger('cascade-staging-www');
$logger = new Logger('cascade-production-www');
$logger = new Logger('cascade-development-weather');
$logger = new Logger('otherCompany-development-weather');

monolog

Context


$logger->debug('my message', ['foo' => 'bar']);

monolog

Context


[2014-11-02 01:26:37] channel.DEBUG: my message {"foo":"bar"} []

monolog

Context

    
$user = new User("will");
$db->put($user);
$logger->info('User ' . $user->username . ' saved.');

monolog

Context


[2014-11-02 01:26:37] channel.INFO: User will saved. [] []

monolog

Context


$user = new User("will");
$db->put($user);

$context = get_object_vars($user);
$logger->info("User saved.", $context);

monolog

Context


[2014-11-02 01:26:37] channel.INFO: User saved. {"username":"will"} []

monolog

Formatters

JsonFormatter


public function format(array $record)
{
    return json_encode($record) . ($this->appendNewline ? "\n" : '');
}

monolog

Processors

MemoryUsageProcessor
ProcessIdProcessor
IntrospectionProcessor
WebProcessor

monolog

Processors

class MemoryUsageProcessor extends MemoryProcessor
{
    public function __invoke(array $record)
    {
        $bytes = memory_get_usage($this->realUsage);
        $formatted = $this->formatBytes($bytes);

        $record['extra'] = array_merge(
            $record['extra'],
            array(
                'memory_usage' => $formatted,
            )
        );

        return $record;
    }
}