ytake/laravel-fluent-logger

fluent logger for laravel and lumen

laravel-fluent-logger

fluent logger for laravel (with Monolog handler for Fluentd ), _(*1)

fluentd, _(*2)

, _(*3)

, _(*4)

Versions

usage

Installation For Laravel

Require this package with Composer, _(*5)

$ composer require ytake/laravel-fluent-logger

or composer.json, _(*6)

"require": {
  "ytake/laravel-fluent-logger": "^6.0"
},

Supported Auto-Discovery(^Laravel5.5), _(*7)

for laravel

your config/app.php, _(*8)

'providers' => [
    \Ytake\LaravelFluent\LogServiceProvider::class,
]

publish configure

• basic

$ php artisan vendor:publish

• use tag option

$ php artisan vendor:publish --tag=log

• use provider

$ php artisan vendor:publish --provider="Ytake\LaravelFluent\LogServiceProvider"

for Lumen

use Ytake\LaravelFluent\LumenLogServiceProvider, _(*9)

bootstrap/app.php, _(*10)

$app->register(\Ytake\LaravelFluent\LumenLogServiceProvider::class);

Lumen will use your copy of the configuration file if you copy and paste one of the files into a config directory within your project root., _(*11)

cp vendor/ytake/laravel-fluent-logger/src/config/fluent.php config/

Config

edit config/fluent.php, _(*12)

return [

    'host' => env('FLUENTD_HOST', '127.0.0.1'),

    'port' => env('FLUENTD_PORT', 24224),

    /** @see https://github.com/fluent/fluent-logger-php/blob/master/src/FluentLogger.php */
    'options' => [],

    /** @see https://github.com/fluent/fluent-logger-php/blob/master/src/PackerInterface.php */
    // specified class name
    'packer' => null,

    // optionally override Ytake\LaravelFluent\FluentHandler class to customize behaviour
    'handler' => null,

    'processors' => [],

    'tagFormat' => '{{channel}}.{{level_name}}',
];

added config/logging.php, _(*13)

return [
    'channels' => [
        'stack' => [
            'driver' => 'stack',
            // always added fluentd log handler
            // 'channels' => ['single', 'fluent'],
            // fluentd only
            'channels' => ['fluent'],
        ],

        'fluent' => [
            'driver' => 'fluent',
            'level' => 'debug',
        ],

        'single' => [
            'driver' => 'single',
            'path' => storage_path('logs/laravel.log'),
            'level' => 'debug',
        ],

        'daily' => [
            'driver' => 'daily',
            'path' => storage_path('logs/laravel.log'),
            'level' => 'debug',
            'days' => 7,
        ],

        'slack' => [
            'driver' => 'slack',
            'url' => env('LOG_SLACK_WEBHOOK_URL'),
            'username' => 'Laravel Log',
            'emoji' => ':boom:',
            'level' => 'critical',
        ],

        'syslog' => [
            'driver' => 'syslog',
            'level' => 'debug',
        ],

        'errorlog' => [
            'driver' => 'errorlog',
            'level' => 'debug',
        ],
    ],
];

or custom / use via, _(*14)

return [
    'channels' => [
        'custom' => [
            'driver' => 'custom',
            'via' => \Ytake\LaravelFluent\FluentLogManager::class,
        ],
    ]
];

fluentd config sample

## match tag=local.** (for laravel log develop)
<match local.**>
  type stdout
</match>

example (production), _(*15)

<match production.**> type stdout </match> and more, _(*16)

for lumen

fluentd config sample(lumen)

<match lumen.**>
  type stdout
</match>

Tag format

The tag format can be configured to take variables from the LogEntry object. This will then be used to match tags in fluent., _(*17)

{{channel}} will be Laravel's current environment as configured in APP_ENV, NOT the logging channel from config/logging.php, _(*18)

{{level_name}} will be the uppercase string version of the log level., _(*19)

{{level}} is the numeric value of the log level. Debug == 100, etc, _(*20)

You can also use variables that exist in LogEntry::$extra. Given a message like, _(*21)

$l = new \Monolog\LogRecord(extra: ['foo' => 'bar']);

You could use a tag format of myapp.{{foo}} to produce a tag of myapp.bar., _(*22)

Monolog processors

You can add processors to the Monolog handlers by adding them to the processors array within the fluent.php config., _(*23)

config/fluent.php:, _(*24)

'processors' => [function (\Monolog\LogRecord $record) {
    $record->extra['cloudwatch_log_group'] = 'test_group';

    return $record;
}],

Alternatively, you can pass the class name of the processor. This helps keep your config compatible with config:cache, _(*25)

config/fluent.php:, _(*26)

'processors' => [CustomProcessor::class],

CustomProcessor.php:, _(*27)

class CustomProcessor
{
    public function __invoke(\Monolog\LogRecord $record)
    {
        $record->extra['cloudwatch_log_group'] = 'test_group';

        return $record;
    }
}

Author

• Yuuki Takezawa (twitter)

License

The code for laravel-fluent-logger is distributed under the terms of the MIT license., _(*28)