devig/laravel-loki-logging

There is no license information available for the latest version (0.1.1) of this package.

Logging to Loki for Laravel (PHP 8)

0.1.1 2022-04-07 11:40 UTC

This package is not auto-updated.

Last update: 2024-03-22 19:40:23 UTC


README

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

Usage

  1. Install this package: composer require devcake-deventer/laravel-loki-logging
  2. Publish the configuration: php artisan vendor:publish --provider=Devcake\\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://logging.devcake.app/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