Skip to content

Latest commit

 

History

History
31 lines (28 loc) · 1.55 KB

README.md

File metadata and controls

31 lines (28 loc) · 1.55 KB

Laravel Loki Logging

Logging to Loki for Laravel
Fork https://github.com/rdemorais/laravel-loki-logging

Usage

  1. Install this package: composer require elgibor-solution/laravel-loki-logging
  2. Publish the configuration: php artisan vendor:publish --provider=ESolution\\LaravelLokiLogging\\L3ServiceProvider
  3. Create a new log channel in config/logging.php:
    'loki' => [
      'driver' => 'monolog',
      'handler' => L3Logger::class,
    ]
  4. Configure at least the LOG_CHANNEL, LOG_USERNAME and LOG_PASSWORD
    1. Ensure APP_NAME is configured appropriately. If this value cannot be changed, use LOG_APP.
    2. Optionally configure LOG_SERVER and LOG_FORMAT
  5. Configure the loki:persist job to run periodically in your schedule. We recommend every minute, but feel free to reduce this.
  6. Log::info('Hello Loki!');

Configuration

The behaviour of the logger can be adjusted with the config options below.

Key Description Default
context Extra variables to be added as labels to the message. Variable substitutions are available. application: env('LOG_APPLICATION')
type: '{level_name}'
format How log messages should be formatted. Variable substitutions are available. [{level_name}] {message}
loki.server The loki server to which data should be logged. https://<url>/loki
loki.username Username for HTTP basic authentication, can be left empty. Env-variable LOG_USERNAME
loki.password Password for HTTP basic authentication, can be left empty. Env-variable LOG_PASSWORD