spatie / laravel-prometheus by spatie

Export Laravel metrics to Prometheus
389,057
153
4
Package Data
Maintainer Username: spatie
Maintainer Contact: freek@spatie.be (Freek Van der Herten)
Package Create Date: 2023-05-09
Package Last Update: 2024-08-28
Home Page: https://freek.dev/2507-visualising-laravel-and-horizon-metrics-using-prometheus-and-grafana
Language: PHP
License: MIT
Last Refreshed: 2024-12-17 03:10:19
Package Statistics
Total Downloads: 389,057
Monthly Downloads: 34,195
Daily Downloads: 1,565
Total Stars: 153
Total Watchers: 4
Total Forks: 19
Total Open Issues: 2

Export Laravel metrics to Prometheus

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

This package can export key metrics of your app to Prometheus. It does this by providing an easy way to register metrics. Here's an example where we are going to export the user count to Prometheus.

Prometheus::addGauge('User count')
    ->value(fn() => User::count();

These metrics will be exposed at the /prometheus endpoint. The package offers a way to add a security layer, so your key metrics don't become public.

You can configure your Prometheus instance to periodically crawl and import the metrics at the /prometheus endpoint of your app. Using Grafana, you can visualize the data points that are stored in Prometheus.

Support us

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.

Documentation

You can find full documentation on our dedicated documentation site.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

The Horizon collectors were heavily inspired on Lukas Kämmerling' excellent laravel-horizon-prometheus-exporter package.

License

The MIT License (MIT). Please see License File for more information.