kibatic/prometheus-metrics-builder

Library that helps to build prometheus metrics

Maintainers

Details

github.com/kibatic/PrometheusMetricsBuilder

Source

Issues

Installs: 1

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 2

Forks: 0

Open Issues: 0

v1.0.1 2022-11-21 20:19 UTC

Requires

  • php: ^8.0.2 || ^7.4.0

Requires (Dev)

MIT 1ba2c41a46561c56315df363c677b981d88e2983

  • Philippe Le Van <philippe.levan.woop@kibatic.com>

phpMetricsexporterprometheus

This package is auto-updated.

Last update: 2024-12-22 01:14:45 UTC

README

example workflow

This library helps you to build a Prometheus metrics endpoint for your PHP application.

Quick start

Install the library

composer require kibatic/prometheus-metrics-builder

Basic usage

$metricList = new MetricList();
$metricList->addMetric(new Metric('foo', 1));
$metricList->addMetric(new Metric('bar', "NaN"));
$metricList->addMetric(new Metric(
    'bar',
    1.35,
    [
        'label1' => 'value1',
        'label2' => 'value2',
    ]
));
$response = $metricList->getResponseContent();
$metricList->clearMetrics();

The content of the response will be:

foo 1
bar NaN
bar{label1="value1",label2="value2"} 1.35

More advanced usage

attributes

$metric = new Metric(
    'my_metric_name',
    12,
    [
        'module' => 'invoice',
        'instance' => 'value2',
    ],
    new \DateTimeImmutable()
)

timestamp with miliseconds

$metric = new Metric(
    'foo',
    1,
    [],
    new \DateTimeImmutable('2020-01-01 00:00:00.012')
);

For developpeurs

Run tests

# install all the needed dependencies
make composer

# run unit tests
make test

Roadmap

  • no plan for the moment

Versions

2022-11-21 : v1.0.1

  • add CI with github actions

2022-11-21 : v1.0.0

  • initial version