README

Laravel package for logging with Loki

Usage

Install this package: composer require yexk/laravel-loki-logger
Publish the configuration: `php artisan vendor:publish --tag=laravel-loki-logger

Create a new log channel in config/logging.php:

'loki' => [
  'driver' => 'monolog',
  'handler' => LokiLogger::class,
]

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
Configure the loki:persist job to run periodically in your schedule. We recommend every minute, but feel free to reduce this.
Log::info('Hello Loki!');

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://localhost`
`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`