PHPackages                             lucacri/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. lucacri/laravel-prometheus-exporter

ActiveLibrary[Logging & Monitoring](/categories/logging)

lucacri/laravel-prometheus-exporter
===================================

A prometheus exporter for Laravel

4.0.0(2y ago)01.4kMITPHPPHP >=8

Since Jul 27Pushed 2y agoCompare

[ Source](https://github.com/lucacri/laravel-prometheus-exporter)[ Packagist](https://packagist.org/packages/lucacri/laravel-prometheus-exporter)[ RSS](/packages/lucacri-laravel-prometheus-exporter/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (2)Dependencies (5)Versions (11)Used By (0)

laravel-prometheus-exporter
===========================

[](#laravel-prometheus-exporter)

A prometheus exporter for Laravel.

[![Author](https://camo.githubusercontent.com/e49c99c3d676e4229f956c6ab6d116cef11b5521de9fa0beea553e709821ac01/687474703a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d406c7563616372692d626c75652e7376673f7374796c653d666c61742d737175617265)](https://twitter.com/lucacri)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Packagist Version](https://camo.githubusercontent.com/fee74531cd600175a2f0b64780c1c29c735d49d9c48c351cde4d29350308c3a5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c7563616372692f6c61726176656c2d70726f6d6574686575732d6578706f727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/lucacri/laravel-prometheus-exporter)[![Total Downloads](https://camo.githubusercontent.com/1b975ca204f3c15161d4189c254141d4b9100cc3a74ed42adb8d616b4d330c77/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c7563616372692f6c61726176656c2d70726f6d6574686575732d6578706f727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/lucacri/laravel-prometheus-exporter)

This package is a wrapper bridging [promphp/prometheus\_client\_php](https://github.com/promphp/prometheus_client_php) into Laravel.

Credit
------

[](#credit)

This package is based off `superbalist/laravel-prometheus-exporter` but since they are not updating it anymore, I needed to fork it and provide updates.

Installation
------------

[](#installation)

```
composer require lucacri/laravel-prometheus-exporter
```

Register the service provider in app.php

```
'providers' => [
    // ...
    Lucacri\LaravelPrometheusExporter\PrometheusServiceProvider::class,
]
```

Register the facade in app.php

```
'aliases' => [
    // ...
    'Prometheus' => Lucacri\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(\Lucacri\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

33

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity69

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 ~352 days

Recently: every ~475 days

Total

8

Last Release

793d ago

Major Versions

1.0.3 → 2.0.02023-03-28

2.0.0 → 3.0.02023-03-28

3.0.1 → 4.0.02024-04-24

PHP version history (3 changes)1.0.0PHP >=5.6.0

2.0.0PHP ^7.2|^8

4.0.0PHP >=8

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2913531?v=4)[Luca Critelli](/maintainers/Lucacri)[@lucacri](https://github.com/lucacri)

---

Top Contributors

[![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)")[![lucacri](https://avatars.githubusercontent.com/u/2913531?v=4)](https://github.com/lucacri "lucacri (3 commits)")[![nope7777](https://avatars.githubusercontent.com/u/8977306?v=4)](https://github.com/nope7777 "nope7777 (1 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (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)")[![abelharisov](https://avatars.githubusercontent.com/u/6592868?v=4)](https://github.com/abelharisov "abelharisov (1 commits)")[![zoidyzoidzoid](https://avatars.githubusercontent.com/u/2572493?v=4)](https://github.com/zoidyzoidzoid "zoidyzoidzoid (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)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/lucacri-laravel-prometheus-exporter/health.svg)

```
[![Health](https://phpackages.com/badges/lucacri-laravel-prometheus-exporter/health.svg)](https://phpackages.com/packages/lucacri-laravel-prometheus-exporter)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

76518.2M120](/packages/laravel-mcp)[lkaemmerling/laravel-horizon-prometheus-exporter

A small package to gain and export long time information from Laravel & Horizon for Prometheus.

1612.1M](/packages/lkaemmerling-laravel-horizon-prometheus-exporter)[laravel/surveyor

Static analysis tool for Laravel applications.

8690.3k12](/packages/laravel-surveyor)[api-platform/laravel

API Platform support for Laravel

59156.3k11](/packages/api-platform-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)