beberlei/metrics

Simple library to talk to metrics collector services.

Tuesday, July 17, 2018
by beberlei
Repository
12 Watchers
249 Stars
299,456 Installations

PHP
3 Dependents
0 Suggesters
30 Forks
7 Open issues
19 Versions
5 % Grown

The README.md

Metrics

, _(*1)

Simple library that abstracts different metrics collectors. I find this necessary to have a consistent and simple metrics API that doesn't cause vendor lock-in., _(*2)

It also ships with a Symfony Bundle. This is not a library for displaying metrics., _(*3)

Currently supported backends:, _(*4)

Doctrine DBAL
Graphite
InfluxDB
Telegraf
Librato
Logger (Psr\Log\LoggerInterface)
Null (Dummy that does nothing)
Prometheus
StatsD
Zabbix
DogStatsD

Installation

Using Composer:, _(*5)

composer require beberlei/metrics

API

You can instantiate clients:, _(*6)

<?php

$collector = \Beberlei\Metrics\Factory::create('statsd');

You can measure stats:, _(*7)

<?php

$collector->increment('foo.bar');
$collector->decrement('foo.bar');

$start = microtime(true);
$diff  = microtime(true) - $start;
$collector->timing('foo.bar', $diff);

$value = 1234;
$collector->measure('foo.bar', $value);

Some backends defer sending and aggregate all information, make sure to call flush:, _(*8)

<?php

$collector->flush();

Configuration

<?php
$statsd = \Beberlei\Metrics\Factory::create('statsd');

$zabbix = \Beberlei\Metrics\Factory::create('zabbix', array(
    'hostname' => 'foo.beberlei.de',
    'server'   => 'localhost',
    'port'     => 10051,
));

$zabbixConfig = \Beberlei\Metrics\Factory::create('zabbix_file', array(
    'hostname' => 'foo.beberlei.de',
    'file'     => '/etc/zabbix/zabbix_agentd.conf'
));

$librato = \Beberlei\Metrics\Factory::create('librato', array(
    'hostname' => 'foo.beberlei.de',
    'username' => 'foo',
    'password' => 'bar',
));

$null = \Beberlei\Metrics\Factory::create('null');

Symfony Bundle Integration

<?php

class AppKernel extends Kernel
{
    public function registerBundles()
    {
        //..
        $bundles[] = new \Beberlei\Bundle\MetricsBundle\BeberleiMetricsBundle();
        //..
    }
}

Do Configuration:, _(*10)

# app/config/config.yml
beberlei_metrics:
    default: foo
    collectors:
        foo:
            type: statsd
        bar:
            type: zabbix
            prefix: foo.beberlei.de
            host: localhost
            port: 10051
        baz:
            type: zabbix_file
            prefix: foo.beberlei.de
            file: /etc/zabbix/zabbix_agentd.conf
        librato:
            type: librato
            username: foo
            password: bar
            source: hermes10
        dbal:
            type: doctrine_dbal
            connection: metrics # using the connection named "metrics"
        monolog:
            type: monolog
        influxdb:
            type: influxdb
            influxdb_client: influxdb_client_service # using the InfluxDB client service named "influxdb_client_service"
            tags:
                dc: "west"
                node_instance: "hermes10"
        prometheus:
            type: prometheus
            prometheus_collector_registry: prometheus_collector_registry_service # using the Prometheus collector registry service named "prometheus_collector_registry_service"
            namespace: app_name # optional
            tags:
                dc: "west"
                node_instance: "hermes10"

This adds collectors to the Metrics registry. The functions are automatically included in the Bundle class so that in your code you can just start using the convenient functions. Metrics are also added as services:, _(*11)

<?php

$metrics = $container->get('beberlei_metrics.collector.foo');

and the default collector can be fetched:, _(*12)

<?php

$metrics = $container->get('beberlei_metrics.collector');

The Versions

17/07 2018

dev-master

9999999-dev

Simple library to talk to metrics collector services.

library metrics

Simple library to talk to metrics collector services.

beberlei/metrics

The README.md

Metrics

Installation

API

Configuration

Symfony Bundle Integration

The Versions

dev-master

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

dev-color

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

v2.7.0

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

v2.6.0

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

v2.5.0

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

dev-CS

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

v2.4.0

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

v2.3.0

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

v2.2.0

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

v2.1.0

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

v2.0.3

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

v2.0.2

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

v2.0.1

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau

v2.0.0

The Requires

The Development Requires

by Benjamin Eberlei

by Grégoire Pineau