fxmonster / laravel-prometheus
Export Laravel metrics to Prometheus
Requires
- php: ^8.1
- illuminate/config: *
- illuminate/contracts: ^8.0
- illuminate/support: *
- promphp/prometheus_client_php: ^2.7.1
- spatie/laravel-package-tools: ^1.15.0
Requires (Dev)
- laravel/horizon: ^5.16.1
- laravel/pint: ^1.10
- nunomaduro/collision: ^7
- nunomaduro/larastan: ^2.6.0
- orchestra/testbench: ^8.5.5
- pestphp/pest: ^2.6.2
- pestphp/pest-plugin-arch: ^2.2
- pestphp/pest-plugin-laravel: ^2.0
- spatie/laravel-ray: ^1.32.4
- spatie/pest-plugin-snapshots: ^2.0.1
This package is auto-updated.
Last update: 2025-02-22 10:18:56 UTC
README
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.