PHPackages minhyung/laravel-openobserve - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. minhyung/laravel-openobserve ActiveLibrary[Logging & Monitoring](/categories/logging) minhyung/laravel-openobserve ============================ Laravel package for OpenObserve integration - centralized log management and monitoring 0.1.0(1mo ago)171MITPHPPHP ^8.3CI passing Since May 28Pushed 1mo agoCompare [ Source](https://github.com/overworks/laravel-openobserve)[ Packagist](https://packagist.org/packages/minhyung/laravel-openobserve)[ RSS](/packages/minhyung-laravel-openobserve/feed)WikiDiscussions 0.x Synced today READMEChangelogDependencies (11)Versions (2)Used By (0) Laravel OpenObserve =================== [](#laravel-openobserve) [![Tests](https://github.com/overworks/laravel-openobserve/actions/workflows/tests.yml/badge.svg?branch=0.x)](https://github.com/overworks/laravel-openobserve/actions/workflows/tests.yml)[![Latest Version on Packagist](https://camo.githubusercontent.com/acad0e10bc9c07b3b911ab11043cd38eaccbbaf1c18b39ce7fc4b1f23d708187/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d696e6879756e672f6c61726176656c2d6f70656e6f6273657276652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/minhyung/laravel-openobserve)[![Total Downloads](https://camo.githubusercontent.com/3a30e2050688602d6c483e81fcc2f91dc4d214354d62405c4bb04a38e08256a2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d696e6879756e672f6c61726176656c2d6f70656e6f6273657276652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/minhyung/laravel-openobserve) Laravel adapter for [minhyung/openobserve](https://github.com/overworks/php-openobserve), the PHP client for [OpenObserve](https://openobserve.ai). This package provides: - A configured `Minhyung\OpenObserve\Client` instance bound in the container - A custom Laravel log channel driver that ships logs through OpenObserve's Monolog handler - An `openobserve:test` Artisan command for connection checks **[한국어 문서](README.ko.md)** Requirements ------------ [](#requirements) - PHP 8.3+ - Laravel 11.x or 12.x Installation ------------ [](#installation) ``` composer require minhyung/laravel-openobserve ``` Publish the configuration file: ``` php artisan vendor:publish --tag=openobserve-config ``` Configuration ------------- [](#configuration) Add OpenObserve connection details to your `.env` file: ``` OPENOBSERVE_URL=http://localhost:5080 OPENOBSERVE_ORGANIZATION=default OPENOBSERVE_STREAM=laravel-logs OPENOBSERVE_EMAIL=your-email@example.com OPENOBSERVE_PASSWORD=your-password ``` ### Configuration Options [](#configuration-options) OptionEnv VariableDefault`url``OPENOBSERVE_URL``http://localhost:5080``organization``OPENOBSERVE_ORGANIZATION``default``stream``OPENOBSERVE_STREAM``default``auth.email``OPENOBSERVE_EMAIL`-`auth.password``OPENOBSERVE_PASSWORD`-`timeout``OPENOBSERVE_TIMEOUT``5``ssl_verify``OPENOBSERVE_SSL_VERIFY``true``timeout` and `ssl_verify` are applied to the Guzzle HTTP client that the service provider builds and injects into the OpenObserve client. ### Laravel Logging Channel Setup [](#laravel-logging-channel-setup) Add the OpenObserve channel to your `config/logging.php`: ``` 'channels' => [ // ... existing channels 'openobserve' => [ 'driver' => 'custom', 'via' => \Minhyung\LaravelOpenObserve\Logging\OpenObserveLogger::class, 'level' => env('LOG_LEVEL', 'debug'), 'name' => 'openobserve', ], // Optionally include openobserve in a stack channel 'stack' => [ 'driver' => 'stack', 'channels' => ['single', 'openobserve'], 'ignore_exceptions' => false, ], ], ``` Set the default log channel in your `.env` file: ``` LOG_CHANNEL=stack # or 'openobserve' ``` Usage ----- [](#usage) ### Laravel Logging [](#laravel-logging) Use it just like standard Laravel logging: ``` use Illuminate\Support\Facades\Log; Log::info('User logged in', ['user_id' => 123]); Log::error('An error occurred', ['error' => $exception->getMessage()]); ``` ### Direct Client Access [](#direct-client-access) The container resolves a configured `Minhyung\OpenObserve\Client`. Use the Facade or dependency injection to access it. ``` use Minhyung\LaravelOpenObserve\Facades\OpenObserve; OpenObserve::logs()->json('laravel-logs', [ ['level' => 'info', 'message' => 'User action', 'user_id' => 123], ]); ``` ``` use Minhyung\OpenObserve\Client; class SomeController extends Controller { public function __construct(private Client $openObserve) { } public function index() { $this->openObserve->logs()->json('laravel-logs', [ ['level' => 'info', 'message' => 'Controller executed'], ]); } } ``` See [minhyung/openobserve](https://github.com/overworks/php-openobserve) for the full client API (search, streams, alerts, dashboards, OTLP, etc.). ### Connection Test [](#connection-test) ``` php artisan openobserve:test ``` Testing ------- [](#testing) ``` composer test ``` Security Vulnerabilities ------------------------ [](#security-vulnerabilities) If you discover a security vulnerability, please email . License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE) for more information. Credits ------- [](#credits) - [Minhyung Park](https://github.com/overworks) - [All Contributors](../../contributors) ### Health Score 38 — LowBetter than 83% of packages Maintenance92 Actively maintained with recent releases Popularity9 Limited adoption so far Community7 Small or concentrated contributor base Maturity38 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 38d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/381cd0165a6aa9f238950dc1ae39f15a2b01a3dc33c111cd0fc1b12ab4259100?d=identicon)[lostland](/maintainers/lostland) --- Top Contributors [![overworks](https://avatars.githubusercontent.com/u/2780002?v=4)](https://github.com/overworks "overworks (11 commits)") --- Tags laravelloggingmonitoringobservabilityopenobserve ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/minhyung-laravel-openobserve/health.svg) ``` [![Health](https://phpackages.com/badges/minhyung-laravel-openobserve/health.svg)](https://phpackages.com/packages/minhyung-laravel-openobserve) ``` ### Alternatives [craftcms/cms Craft CMS 3.6k3.6M3.1k](/packages/craftcms-cms)[psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[simplestats-io/laravel-client Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof. 5022.0k](/packages/simplestats-io-laravel-client)[naoray/laravel-github-monolog Log driver to store logs as github issues 10823.1k](/packages/naoray-laravel-github-monolog) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)