openlogs-laravel

A Laravel bridge for OpenLogs: adds a first-class openlogs log channel with optional queued delivery on a dedicated queue. Built on the framework-agnostic techforce/openlogs-monolog handler.

Install

composer require techforce/openlogs-laravel

The service provider is auto-discovered. Publish the config if you want to tweak defaults:

php artisan vendor:publish --tag=openlogs-config

Configure

Set your OpenLogs connection in .env:

OPENLOGS_URL=https://logs.example.com
OPENLOGS_API_KEY=your-project-api-key

Add the channel to config/logging.php:

'channels' => [
    'openlogs' => [
        'driver' => 'custom',
        'via'    => \TechForce\OpenLogs\Laravel\OpenLogsChannel::class,
    ],

    // ...or send everything there via a stack:
    'stack' => [
        'driver'   => 'stack',
        'channels' => ['single', 'openlogs'],
    ],
],

Then log as usual:

Log::channel('openlogs')->info('User signed up', ['user_id' => 42]);

Records are buffered and delivered to OpenLogs as a single batch at the end of the request (or when the buffer fills).

Config reference (config/openlogs.php)

Queued delivery

To move the HTTP POST off the request and onto a background worker:

OPENLOGS_QUEUE=true

Each batch is dispatched as a SendLogBatch job carrying the normalized entries. It targets a dedicated openlogs queue by default so log shipping never competes with your application's jobs. Run a worker for it:

php artisan queue:work --queue=openlogs

Failure handling in queued mode: the job uses the queue's retry/backoff for transient outages, and after retries are exhausted it replays the batch to your fallback_channel.

Note: don't route your queue worker's own logs through the openlogs channel — that can create a delivery loop. The fallback_channel is automatically guarded against pointing back at openlogs.

Fallback

If OpenLogs is unreachable (or returns an error), the batch is written to fallback_channel (default single) so logs are never lost. A fallback that would resolve back to the openlogs channel is detected and disabled.

License

MIT