README

Laravel client for Logstream.

Install

composer require borgstein/logstream-laravel

Service provider and Facade are auto-discovered.

Configuration

Publish the config file:

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

Add to .env:

LOGSTREAM_API_KEY=your_api_key_here

Usage

Option A — Facade

use Logstream\Laravel\Facades\Logstream;

Logstream::info('User signed up', ['userId' => $user->id]);
Logstream::error('Payment failed', ['orderId' => $order->id]);

Option B — Laravel Log channel

In config/logging.php:

'channels' => [
    'logstream' => [
        'driver' => 'custom',
        'via'    => \Logstream\Laravel\LogstreamLogger::class,
        'level'  => 'debug',
    ],
],

Then use as any Laravel log channel:

Log::channel('logstream')->info('User signed up');

// Or add to your stack:
'stack' => [
    'driver'   => 'stack',
    'channels' => ['daily', 'logstream'],
],

Async logging

Set LOGSTREAM_ASYNC=true in .env. Logs will be dispatched as queued jobs — requires a configured queue driver.

Level mapping