README

Laravel-Easy-Log helps you to log into differnet files per level or into a MySQL-datatbase, for which you also get a Log-view.

Installation

composer require cafe-serendipity/laravel-easy-log

AddProvider

add the provider to config/app.php

Piccard\LEL\LELServiceProvider::class

Publish files

having the configuration-file, views & controller available in your application, you have to publish them

php artisan vendor:publish --tag=lel --force

Decide how to log

Application-Level

if you wanna log on application-level, means also Laravel is logging through Laravel-Easy-Log, add the following to bootstrap/app.php just before return $app;. Because Laravel-Easy-Log is logging ow for you, you have to switch on at least file or db in config/laravel-easy-log.php

$app->configureMonologUsing(function ($logger) {
  \Piccard\LEL\LEL::configureMonolog($logger);
});

now use it as usual:

use Illuminate\Support\Facades\Log;

...

Log::debug("CONTEXT log in DEBUG", array('col1' => 'Hi, I am a context log.'));    
Log::info("CONTEXT log in INFO", array(
        'col1' => 'Hi, I am a context log.',
        'col2' => 'Hi, I am a context log.'
    ));

Custom-Level

if you don't wanna have Laravel logging through Laravel-Easy-Log, but you wanna do it on your own, you have to create an instance of Laravel-Easy-Log:

$logger = \Piccard\LEL\LEL::configureMonolog("channel-name"); 
$logger->info("Whatever you want to log");

now use the instance:

$logger->debug("CONTEXT log in DEBUG", array('col1' => 'Hi, I am a context log.'));    
$logger->info("CONTEXT log in INFO", array(
        'col1' => 'Hi, I am a context log.',
        'col2' => 'Hi, I am a context log.'
    ));

Configure Laravel-Easy-Log

Open up config/laravel-easy-log and enable the handlers you want to use. Basically you can use the same options like in Monolog.

DB

use_default_connection You can use your default DB-connection or define a custom one.
app is just another column, if you use different Laravel-applications and the same logging-server, so you can filter them better out.
table the table which will be created for logging
columns define here some extra columns, which you can use when you log, which is similar to Monolog's context logging

Log::info("CONTEXT log in DEBUG", array('col1' => 'Hi, I am a context log.'));

Log-View

To get to the view of your DB-Logs goto the route /lel

Files

log_levels define here which files you want foreach log-level

License

laravel-easy-log is licensed under the MIT License - see the LICENSE file for details.

Author

Andreas Stephan

cafe-serendipity / laravel-easy-log

Maintainers

Details