PHPackages bushlanov-dev/laravel-prometheus-exporter - 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. bushlanov-dev/laravel-prometheus-exporter ActiveProject[Logging & Monitoring](/categories/logging) bushlanov-dev/laravel-prometheus-exporter ========================================= Laravel and Lumen prometheus exporter 0.3.2(11mo ago)112MITPHPPHP ^8.1 || ^8.2 || ^8.3 || ^8.4CI passing Since Dec 3Pushed 7mo ago1 watchersCompare [ Source](https://github.com/BushlanovDev/laravel-prometheus-exporter)[ Packagist](https://packagist.org/packages/bushlanov-dev/laravel-prometheus-exporter)[ RSS](/packages/bushlanov-dev-laravel-prometheus-exporter/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (6)Dependencies (10)Versions (7)Used By (0) Laravel and Lumen Prometheus Exporter ===================================== [](#laravel-and-lumen-prometheus-exporter) [![Actions status](https://github.com/BushlanovDev/laravel-prometheus-exporter/actions/workflows/ci.yml/badge.svg?style=flat-square)](https://github.com/BushlanovDev/laravel-prometheus-exporter/actions)[![Coverage](https://raw.githubusercontent.com/BushlanovDev/laravel-prometheus-exporter/refs/heads/main/.github/badge-coverage.svg?v=1)](https://github.com/BushlanovDev/laravel-prometheus-exporter/actions)[![Packagist Version](https://camo.githubusercontent.com/178922c111c88e6181efb67577e3503067bef7a2140e4975054a2565db32b0d1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f627573686c616e6f762d6465762f6c61726176656c2d70726f6d6574686575732d6578706f727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bushlanov-dev/laravel-prometheus-exporter)![PHP Version](https://camo.githubusercontent.com/2d18ce514c7016022dad012ac9e39a8b6f47cc411b2daff6627cbf208f8cea63/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230382e312d3838393242462e7376673f7374796c653d666c61742d737175617265)![Laravel Version](https://camo.githubusercontent.com/41743d2257ff669a2931b6b3fc180832b7e9b377dfbbc7d1b329813866342e82/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d392e782c25323031302e782c25323031312e782c25323031322e782d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)![Lumen Version](https://camo.githubusercontent.com/f369a82d6a68d1db0b01f69ad840c15270f19bd339194fedfa5261d357d6bff5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c756d656e2d392e782c25323031302e782c25323031312e782d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE) A prometheus exporter for the Laravel and the Lumen. This package is a wrapper bridging [promphp/prometheus\_client\_php](https://github.com/promphp/prometheus_client_php) Installation ------------ [](#installation) ``` composer require bushlanov-dev/laravel-prometheus-exporter ``` ### Laravel [](#laravel) Laravel 11+ register the service provider in `bootstrap/providers.php`: ``` return [ // ... BushlanovDev\LaravelPrometheusExporter\Providers\PrometheusServiceProvider::class, ]; ``` Old versions of laravel register the service provider in `config/app.php`: ``` 'providers' => [ // ... BushlanovDev\LaravelPrometheusExporter\Providers\PrometheusServiceProvider::class, ]; ``` Laravel 11+ register the middleware in `bootstrap/app.php`: ``` // ... ->withMiddleware(function (Middleware $middleware) { $middleware->alias([ 'prometheus' => BushlanovDev\LaravelPrometheusExporter\Middleware\PrometheusLaravelMiddleware::class, ]); }) ``` Old versions of laravel register the middleware in `app/Http/Kernel.php`: ``` protected $routeMiddleware = [ // ... 'prometheus' => BushlanovDev\LaravelPrometheusExporter\Middleware\PrometheusLaravelMiddleware::class, ]; ``` Register metrics route `routes/web.php`: ``` Route::get('metrics', [BushlanovDev\LaravelPrometheusExporter\Controllers\LaravelMetricsController::class, 'metrics']); ``` Add middleware to routes. It is advisable to give names to all routes: ``` Route::get('/', function () { // ... })->middleware('prometheus')->name('route_name'); ``` ### Lumen [](#lumen) Register the service provider and middleware in `bootstrap/app.php`: ``` $app->register(BushlanovDev\LaravelPrometheusExporter\Providers\PrometheusServiceProvider::class); ``` ``` $app->routeMiddleware([ 'prometheus' => BushlanovDev\LaravelPrometheusExporter\Middleware\PrometheusLumenMiddleware::class, ]); ``` Register metrics route: ``` $app->router->group(['namespace' => '\BushlanovDev\LaravelPrometheusExporter\Controllers'], function ($router) { $router->get('metrics', ['as' => 'metrics', 'uses'=> 'LumenMetricsController' . '@metrics']); }); ``` Add middleware to routes. It is advisable to give names to all routes: ``` $router->get('/', ['middleware' => 'prometheus', 'as' => 'route_name', function () use ($router) {/*...*/}]); ``` Guzzle metrics -------------- [](#guzzle-metrics) To observe Guzzle metrics, you should register the following provider: ``` BushlanovDev\LaravelPrometheusExporter\Providers\GuzzleServiceProvider::class ``` And register the middleware for Http facade or Guzzle client: ``` Http::globalMiddleware(function ($handler) { return $this->app['prometheus.guzzle.middleware']($handler); }); $this->app->alias('prometheus.guzzle.client', Client::class); ``` Configuration ------------- [](#configuration) The package has a default configuration which uses the following environment variables. ``` PROMETHEUS_NAMESPACE=app PROMETHEUS_STORAGE_ADAPTER=redis PROMETHEUS_REDIS_HOST=localhost PROMETHEUS_REDIS_PORT=6379 PROMETHEUS_REDIS_DATABASE=0 PROMETHEUS_REDIS_TIMEOUT=0.1 PROMETHEUS_REDIS_READ_TIMEOUT=10 PROMETHEUS_REDIS_PERSISTENT_CONNECTIONS=0 PROMETHEUS_REDIS_PREFIX=PROMETHEUS_ ``` To customize the configuration file, publish the package configuration using Artisan: ``` php artisan vendor:publish --provider="BushlanovDev\LaravelPrometheusExporter\Providers\PrometheusServiceProvider" ``` ### Protect metrics endpoint [](#protect-metrics-endpoint) If you need to prevent others from accessing your /metrics routes, you can enable the corresponding setting. Currently, only basic\_auth is supported to secure your metrics endpoint. ``` PROMETHEUS_ROUTE_AUTH_ENABLED=true PROMETHEUS_ROUTE_AUTH_USERNAME=username PROMETHEUS_ROUTE_AUTH_PASSWORD=password ``` License ------- [](#license) This repository's source code is available under the [MIT License](LICENSE). ### Health Score 33 — LowBetter than 75% of packages Maintenance58 Moderate activity, may be stable Popularity7 Limited adoption so far Community7 Small or concentrated contributor base Maturity50 Maturing project, gaining track record 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 ~35 days Recently: every ~44 days Total 6 Last Release 345d ago PHP version history (2 changes)0.1.0PHP ^8.1 || ^8.2 || ^8.3 0.1.1PHP ^8.1 || ^8.2 || ^8.3 || ^8.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/6e7e58d480641faf4a7eb02eef574f12f67365b63800390e9dc32208a436b43c?d=identicon)[BushlanovDev](/maintainers/BushlanovDev) --- Top Contributors [![BushlanovDev](https://avatars.githubusercontent.com/u/182418502?v=4)](https://github.com/BushlanovDev "BushlanovDev (29 commits)") --- Tags laravellaravel-packagelumenmetricsphpprometheusprometheus-exporterlaravellumenexporterprometheus ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/bushlanov-dev-laravel-prometheus-exporter/health.svg) ``` [![Health](https://phpackages.com/badges/bushlanov-dev-laravel-prometheus-exporter/health.svg)](https://phpackages.com/packages/bushlanov-dev-laravel-prometheus-exporter) ``` ### Alternatives [lkaemmerling/laravel-horizon-prometheus-exporter A small package to gain and export long time information from Laravel & Horizon for Prometheus. 1602.0M](/packages/lkaemmerling-laravel-horizon-prometheus-exporter)[spatie/laravel-health Monitor the health of a Laravel application 85810.0M83](/packages/spatie-laravel-health)[larabug/larabug Laravel 6.x/7.x/8.x/9.x/10.x/11.x/12.x/13.x bug notifier 299549.3k1](/packages/larabug-larabug)[masterro/laravel-mail-viewer Easily view in browser outgoing emails. 6392.1k](/packages/masterro-laravel-mail-viewer)[melihovv/laravel-log-viewer A Laravel log viewer 1231.5k1](/packages/melihovv-laravel-log-viewer) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)