PHPackages pointcloudtechnology/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. pointcloudtechnology/laravel-prometheus-exporter ActiveLibrary[Logging & Monitoring](/categories/logging) pointcloudtechnology/laravel-prometheus-exporter ================================================ A prometheus exporter for Laravel. Forked from Superbalist. v2.0.2(3mo ago)040.1k↓82.8%1MITPHPPHP ^7.4 || ^8.0 Since Jul 27Pushed 3mo agoCompare [ Source](https://github.com/pointcloudtechnology/laravel-prometheus-exporter)[ Packagist](https://packagist.org/packages/pointcloudtechnology/laravel-prometheus-exporter)[ RSS](/packages/pointcloudtechnology-laravel-prometheus-exporter/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (5)Dependencies (5)Versions (15)Used By (0) laravel-prometheus-exporter =========================== [](#laravel-prometheus-exporter) A prometheus exporter for Laravel. **This is a fork of [Superbalist/laravel-prometheus-exporter](https://github.com/Superbalist/laravel-prometheus-exporter) since the original package depends on an abandoned dependency. See [Superbalist#11](https://github.com/Superbalist/laravel-prometheus-exporter/issues/11) .** This package is a wrapper bridging [promphp/prometheus\_client\_php](https://github.com/PromPHP/prometheus_client_php) into Laravel. Installation ------------ [](#installation) ``` composer require superbalist/laravel-prometheus-exporter ``` Register the service provider in app.php ``` 'providers' => [ // ... Superbalist\LaravelPrometheusExporter\PrometheusServiceProvider::class, ] ``` Register the facade in app.php ``` 'aliases' => [ // ... 'Prometheus' => Superbalist\LaravelPrometheusExporter\PrometheusFacade::class, ] ``` Configuration ------------- [](#configuration) The package has a default configuration which uses the following environment variables. ``` PROMETHEUS_NAMESPACE=app PROMETHEUS_METRICS_ROUTE_ENABLED=true PROMETHEUS_METRICS_ROUTE_PATH=metrics PROMETHEUS_METRICS_ROUTE_MIDDLEWARE=null PROMETHEUS_STORAGE_ADAPTER=memory REDIS_HOST=localhost REDIS_PORT=6379 PROMETHEUS_REDIS_PREFIX=PROMETHEUS_ ``` To customize the configuration file, publish the package configuration using Artisan. ``` php artisan vendor:publish --provider="Superbalist\LaravelPrometheusExporter\PrometheusServiceProvider" ``` You can then edit the generated config at `app/config/prometheus.php`. ### Storage Adapters [](#storage-adapters) The storage adapter is used to persist metrics across requests. The `memory` adapter is enabled by default, meaning data will only be persisted across the current request. We recommend using the `redis` or `apc` adapter in production environments. The `PROMETHEUS_STORAGE_ADAPTER` env var is used to specify the storage adapter. If `redis` is used, the `REDIS_HOST` and `REDIS_PORT` vars also need to be configured. ### Exporting Metrics [](#exporting-metrics) The package adds a `/metrics` end-point, enabled by default, which exposes all metrics gathered by collectors. This can be turned on/off using the `PROMETHEUS_METRICS_ROUTE_ENABLED` var, and can also be changed using the `PROMETHEUS_METRICS_ROUTE_PATH` var. If you would like to protect this end-point, you can write any custom middleware and enable it using `PROMETHEUS_METRICS_ROUTE_MIDDLEWARE`. ### Collectors [](#collectors) A collector is a class, implementing the [CollectorInterface](src/CollectorInterface.php), which is responsible for collecting data for one or many metrics. Please see the [ExampleCollector](src/ExampleCollector.php) included in this repository. You can auto-load your collectors by adding them to the `collectors` array in the prometheus.php config. Usage ----- [](#usage) ``` // retrieve the exporter $exporter = app(\Superbalist\LaravelPrometheusExporter::class); // or $exporter = app('prometheus'); // or $exporter = Prometheus::getFacadeRoot(); // register a new collector $collector = new \My\New\Collector(); $exporter->registerCollector($collector); // retrieve all collectors var_dump($exporter->getCollectors()); // retrieve a collector by name $collector = $exporter->getCollector('user'); // export all metrics // this is called automatically when the /metrics end-point is hit var_dump($exporter->export()); // the following methods can be used to create and interact with counters, gauges and histograms directly // these methods will typically be called by collectors, but can be used to register any custom metrics directly, // without the need of a collector // create a counter $counter = $exporter->registerCounter('search_requests_total', 'The total number of search requests.'); $counter->inc(); // increment by 1 $counter->incBy(2); // create a counter (with labels) $counter = $exporter->registerCounter('search_requests_total', 'The total number of search requests.', ['request_type']); $counter->inc(['GET']); // increment by 1 $counter->incBy(2, ['GET']); // retrieve a counter $counter = $exporter->getCounter('search_requests_total'); // create a gauge $gauge = $exporter->registerGauge('users_online_total', 'The total number of users online.'); $gauge->inc(); // increment by 1 $gauge->incBy(2); $gauge->dec(); // decrement by 1 $gauge->decBy(2); $gauge->set(36); // create a gauge (with labels) $gauge = $exporter->registerGauge('users_online_total', 'The total number of users online.', ['group']); $gauge->inc(['staff']); // increment by 1 $gauge->incBy(2, ['staff']); $gauge->dec(['staff']); // decrement by 1 $gauge->decBy(2, ['staff']); $gauge->set(36, ['staff']); // retrieve a gauge $counter = $exporter->getGauge('users_online_total'); // create a histogram $histogram = $exporter->registerHistogram( 'response_time_seconds', 'The response time of a request.', [], [0.1, 0.25, 0.5, 0.75, 1.0, 2.5, 5.0, 7.5, 10.0] ); // the buckets must be in asc order // if buckets aren't specified, the default 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1.0, 2.5, 5.0, 7.5, 10.0 buckets will be used $histogram->observe(5.0); // create a histogram (with labels) $histogram = $exporter->registerHistogram( 'response_time_seconds', 'The response time of a request.', ['request_type'], [0.1, 0.25, 0.5, 0.75, 1.0, 2.5, 5.0, 7.5, 10.0] ); // the buckets must be in asc order // if buckets aren't specified, the default 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1.0, 2.5, 5.0, 7.5, 10.0 buckets will be used $histogram->observe(5.0, ['GET']); // retrieve a histogram $counter = $exporter->getHistogram('response_time_seconds'); ``` ### Health Score 55 — FairBetter than 97% of packages Maintenance85 Actively maintained with recent releases Popularity29 Limited adoption so far Community16 Small or concentrated contributor base Maturity76 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits 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 ~238 days Recently: every ~416 days Total 14 Last Release 108d ago Major Versions 1.2.0 → v2.0.02024-04-22 PHP version history (4 changes)1.0.0PHP >=5.6.0 1.1.0PHP ^7.2 1.2.0PHP ^7.2 || ^8.0 v2.0.0PHP ^7.4 || ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/1718c50a83d40b50e968650bc8c5779a98ca70037fca54eb1f0ad4cfc0fa4fcc?d=identicon)[pointcloudtechnology](/maintainers/pointcloudtechnology) --- Top Contributors [![adi64](https://avatars.githubusercontent.com/u/5867277?v=4)](https://github.com/adi64 "adi64 (27 commits)")[![matthewgoslett](https://avatars.githubusercontent.com/u/1571743?v=4)](https://github.com/matthewgoslett "matthewgoslett (14 commits)")[![nicja](https://avatars.githubusercontent.com/u/2102143?v=4)](https://github.com/nicja "nicja (5 commits)")[![Floriszenz](https://avatars.githubusercontent.com/u/30691071?v=4)](https://github.com/Floriszenz "Floriszenz (2 commits)")[![lucacri](https://avatars.githubusercontent.com/u/2913531?v=4)](https://github.com/lucacri "lucacri (1 commits)")[![alsma](https://avatars.githubusercontent.com/u/3245855?v=4)](https://github.com/alsma "alsma (1 commits)")[![janwehner](https://avatars.githubusercontent.com/u/1687426?v=4)](https://github.com/janwehner "janwehner (1 commits)")[![nope7777](https://avatars.githubusercontent.com/u/8977306?v=4)](https://github.com/nope7777 "nope7777 (1 commits)")[![shad0wfir3](https://avatars.githubusercontent.com/u/20926935?v=4)](https://github.com/shad0wfir3 "shad0wfir3 (1 commits)")[![stefanbauer](https://avatars.githubusercontent.com/u/3192662?v=4)](https://github.com/stefanbauer "stefanbauer (1 commits)")[![zoidyzoidzoid](https://avatars.githubusercontent.com/u/2572493?v=4)](https://github.com/zoidyzoidzoid "zoidyzoidzoid (1 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/pointcloudtechnology-laravel-prometheus-exporter/health.svg) ``` [![Health](https://phpackages.com/badges/pointcloudtechnology-laravel-prometheus-exporter/health.svg)](https://phpackages.com/packages/pointcloudtechnology-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)[masterro/laravel-mail-viewer Easily view in browser outgoing emails. 6392.1k](/packages/masterro-laravel-mail-viewer)[arquivei/laravel-prometheus-exporter A Prometheus exporter for Laravel and Lumen 20807.4k1](/packages/arquivei-laravel-prometheus-exporter)[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)