ready2order/laravel-fluent-logger

fluent logger for laravel and lumen

8.4-beta 2024-10-21 19:45 UTC

Requires

• php: ^8.1
• fluent/logger: ^1.0
• illuminate/config: ^10.0 | ^11.0
• illuminate/container: ^10.0 | ^11.0
• illuminate/contracts: ^10.0 | ^11.0
• illuminate/events: ^10.0 | ^11.0
• illuminate/log: ^10.0 | ^11.0
• illuminate/support: ^10.0 | ^11.0
• monolog/monolog: ^3.0

Requires (Dev)

• doctrine/coding-standard: ^8.2
• illuminate/filesystem: ^10.0 | ^11.0
• php-coveralls/php-coveralls: ^2.4
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^10.0
• slevomat/coding-standard: ^6.4
• squizlabs/php_codesniffer: ^3.5

MIT

• Yuuki Takezawa

• log
• logging
• fluent
• laravel
• lumen

README

fluent logger for laravel (with Monolog handler for Fluentd )

fluentd

usage

Installation For Laravel

Require this package with Composer

$ composer require ytake/laravel-fluent-logger

or composer.json

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

Supported Auto-Discovery(^Laravel5.5)

for laravel

your config/app.php

'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

bootstrap/app.php

$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.

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

Config

edit config/fluent.php

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,

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

added config/logging.php

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

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)

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

and more

for lumen

fluentd config sample(lumen)

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

Author

• Yuuki Takezawa (twitter)

License

The code for laravel-fluent-logger is distributed under the terms of the MIT license.