vmorozov / laravel-prometheus
Prometheus client for laravel framework. Includes some of default metrics for any laravel application out of the box and ability to add custom metrics easily. .
Fund package maintenance!
vmorozov
Requires
- php: ^8.2
- illuminate/contracts: >=9.0
- promphp/prometheus_client_php: ^2.7
- spatie/laravel-package-tools: ^1.16
Requires (Dev)
- laravel/pint: ^1.13
- orchestra/testbench: ^v9.5.2
- phpunit/phpunit: ^11.4
This package is auto-updated.
Last update: 2025-06-05 13:07:36 UTC
README
A Laravel package for integrating Prometheus metrics collection into your Laravel application.
This package makes it easy to collect and expose metrics for monitoring your application's performance and behavior.
Installation
- Install the package via composer:
composer require vmorozov/laravel-prometheus
- Publish vendor files:
php artisan vendor:publish --provider="VMorozov\\Prometheus\\PrometheusServiceProvider"
Usage
This package provides default metrics that allow you to monitor response times (divided into buckets and percentiles) and request counts.
It also allows you to create custom metrics and collectors for your specific needs.
To see the collected metrics, go to the /metrics endpoint of your application.
This endpoint returns metrics in the Prometheus exposition format, which can be scraped by a Prometheus server.
Configuration
The package can be configured using the laravel-prometheus.php configuration file.
This file is published to your application's config directory when you run the vendor:publish command.
Key configuration options include:
- namespace: Prefix for all metrics (default: your APP_NAME env value)
- storage_type: How metrics data is stored (redis, in_memory, apcu)
- route_url: URL path for the metrics endpoint (default:
/metrics) - default_metrics_enabled: Whether default metrics are enabled (they are enabled by default)
- on_demand_metric_collectors: Collectors that run only when the metrics endpoint is accessed
For detailed configuration information, see the Configuration Documentation.
Default Metrics
The package includes two default metrics:
- Request Duration Histogram: Measures the duration of HTTP requests.
- Queue Size Gauge: Measures the size of Laravel queues (you have to configure which connections and queues to monitor).
For more information about the default metrics, see the Default Metrics Documentation.
Custom Metrics
You can create custom metrics to monitor specific aspects of your application. The package supports three types of metrics:
- Counter: A cumulative metric that only increases (requests_processed, users_registered, etc.)
- Gauge: A metric that can go up and down and represents current state of something (example: queue_size, cpu_load, etc.)
- Histogram: A metric that samples observations and counts them in buckets (when you need to have quantiles of your metric values)
For information on creating and using custom metrics, see the Custom Metrics Documentation.
On-Demand Metrics Collectors
On-Demand Metrics Collectors are classes that collect metrics only when the metrics endpoint is accessed.
This is useful for metrics that are expensive to collect or that don't need to be updated on every request.
For information on creating and using custom On-Demand Metrics Collectors, see the On-Demand Metrics Collectors Documentation.
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
License
The MIT License (MIT). Please see License File for more information.