README

A laravel and lumen service provider to export metrics for prometheus.

Supported laravel versions

Main features

Metrics with APC
Metrics with Redis
Metrics with InMemory
Metrics with the push gateway
Request per route middleware (total and duration metrics)

Installation

Composer

composer require triadev/laravel-prometheus-exporter

Application

The package is registered through the package discovery of laravel and Composer.

https://laravel.com/docs/5.7/packages

Once installed you can now publish your config file and set your correct configuration for using the package.

php artisan vendor:publish --provider="GallopYD\PrometheusExporter\Provider\PrometheusExporterServiceProvider" --tag="config"

This will create a file config/prometheus-exporter.php.

Configuration

Key	Env	Value	Description	Default
adapter	PROMETHEUS_ADAPTER	STRING	apc, redis, inmemory or push	apc
namespace	---	STRING	default: app	app
namespace_http	---	STRING	namespace for "RequestPerRoute-Middleware metrics"	http
redis.host	PROMETHEUS_REDIS_HOST	STRING	redis host	127.0.0.1
redis.port	PROMETHEUS_REDIS_PORT	INTEGER	redis port	6379
redis.timeout	---	FLOAT	redis timeout	0.1
redis.read_timeout	---	INTEGER	redis read timeout	10
push_gateway.address	PROMETHEUS_PUSH_GATEWAY_ADDRESS	STRING	push gateway address	localhost:9091
buckets_per_route	---	STRING	histogram buckets for "RequestPerRoute-Middleware"	---

buckets_per_route

'buckets_per_route' => [
    ROUTE-NAME => [10,20,50,100,200],
    ...
]

Usage

Endpoint to get metrics

juhu/pe/metrics

Middleware

RequestPerRoute (only laravel)

A middleware to build metrics for "request_total" and "requests_latency_milliseconds" per route.

Alias

lpe.requestPerRoute

Metrics

requests_total (inc)
requests_latency_milliseconds (histogram)

Example

$router->get('requestPerRoute', function () {
    return 'valid';
})->middleware('lpe.requestPerRoute')->name('requestPerRoute');

app_requests_latency_milliseconds_bucket{route="requestPerRoute",method="GET",status_code="200",le="0.005"} 0 ... app_requests_latency_milliseconds_count{route="requestPerRoute",method="GET",status_code="200"} 1 app_requests_latency_milliseconds_sum{route="requestPerRoute",method="GET",status_code="200"} 6 app_requests_total{route="requestPerRoute",method="GET",status_code="200"} 1

Roadmap

histogram buckets per route (RequestPerRoute)

Reporting Issues

If you do find an issue, please feel free to report it with GitHub's bug tracker for this project.

Alternatively, fork the project and make a pull request. :)

Testing

docker-compose up
docker exec fpm ./vendor/phpunit/phpunit/phpunit

Contributing

Please see CONTRIBUTING for details.

Credits

Other

Project related links

Author

Christopher Lorke

License

The code for LaravelPrometheusExporter is distributed under the terms of the MIT license (see LICENSE).

gallop-yd / laravel-prometheus-exporter

Maintainers

Details