borgstein/logstream-laravel

Laravel client for the Logstream logging API

v1.0.2 2026-03-01 15:31 UTC

Requires

• php: ^8.1
• illuminate/http: ^10.0|^11.0|^12.0
• illuminate/log: ^10.0|^11.0|^12.0
• illuminate/queue: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0
• psr/log: ^2.0|^3.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0
• pestphp/pest: ^2.0
• pestphp/pest-plugin-laravel: ^2.0

MIT

• Fredrik Borgstein

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

Laravel	Logstream
debug	DEBUG
info, notice	INFO
warning	WARN
error, critical, alert, emergency	ERROR