Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bexiocom/prometheus_php
A PHP instrumentation library for Prometheus compatible with PHP 5.5 5.6, 7.0 and 7.1.
https://github.com/bexiocom/prometheus_php
monitoring php php5 php55 php7 php70 php71 prometheus
Last synced: about 9 hours ago
JSON representation
A PHP instrumentation library for Prometheus compatible with PHP 5.5 5.6, 7.0 and 7.1.
- Host: GitHub
- URL: https://github.com/bexiocom/prometheus_php
- Owner: bexiocom
- License: mit
- Created: 2017-08-23T11:46:46.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2017-08-31T18:54:44.000Z (about 7 years ago)
- Last Synced: 2024-08-08T23:54:38.942Z (about 2 months ago)
- Topics: monitoring, php, php5, php55, php7, php70, php71, prometheus
- Language: PHP
- Homepage: https://bexiocom.github.io/prometheus_php/
- Size: 51.8 KB
- Stars: 9
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# A Prometheus client library for PHP
[](https://travis-ci.org/bexiocom/prometheus_php)
[](https://codeclimate.com/github/bexiocom/prometheus_php)
[](https://codeclimate.com/github/bexiocom/prometheus_php/coverage)
[](https://packagist.org/packages/bexiocom/prometheus_php)
This library aims to be a lightweight utility for instrumenting a PHP
application using [Prometheus](https://prometheus.io). It is heavily inspired
by the [golang client](https://github.com/prometheus/client_golang).
- The library is supposed to be compatible with the PHP version 5.5, 5.6, 7.0
and 7.1.
- This library tries to do not take any assumptions about the environment it is
used in. You should be able to use it without any magic or with what ever
tool belt you are using. Be it a lightweight dependency injection, Sympfony
or something else.
## Features
- Counter, Gauge and Histogram metric types.
- Redis and in memory storage.
- Rendering to text format.
## Missing features
- Summary metric types.
- Ability to submit metric samples to a PushGateway.
- Storage utilising filesystem, Memcached and APC.
- Rendering to Protocol buffer format
- Registry class to ease usage when using the library without andy dependency
injection tool.
## Getting Started
Add this library to your project.
```bash
composer require bexiocom/prometheus_php:dev-master
```
## Usage
Simple counter with no labels attached:
```php
inc();
$storage->persist($counter);
```
More enhanced counter with labels:
```php
withLabels(['type' => 'blue']);
$blueCounter->inc();
$redCounter = $collection->withLabels(['type' => 'red']);
$redCounter->add(42);
$storage->persist($collection);
```
Expose the metrics:
```php
[
InMemory::DEFAULT_VALUE_INDEX => 1
],
'labeled_counter' => [
'{"type":"blue"}' => 1,
'{"type":"red"}' => 42,
],
]);
$counter = Counter::createFromValues('simple_counter', 'Just a simple counting');
$renderer->render($counter, $storage->collectSamples($counter));
$collection = CounterCollection::createFromValues('labeled_counter', 'Counting with labels', ['type']);
$renderer->render($collection, $storage->collectSamples($collection));
header(sprintf('Content-Type: %s', TextRenderer::MIME_TYPE));
echo $buffer->getContents();
```
Use Redis as storage backend:
> NOTE: When using the Redis storage, it is highly suggested to add ```ext-redis``` as requirement to your project.
```php
connect('localhost');
// Optional: tune your redis connection.
$redis->setOption(\Redis::OPT_READ_TIMEOUT, 10);
$storage = new Redis($redis, 'PROMETHEUS:');
```
Use Redis but open connection lacily:
```php
connect('localhost')) {
throw new \Exception('Failed to connect to Redis server');
}
$redis->setOption(\Redis::OPT_READ_TIMEOUT, 10);
});
```
## How to contribute
First off, thank you for considering contributing to this PHP Prometheus client
library. It's people like you that make it useful for more than a handful of
people.
Pull requests are happily accepted, given they follow the following simple
rules:
- New feature must be covered with tests
- All tests must pass
```bash
composer check
```
- Do not mix things up. Only one feature/fix per pull request.