2017 © Pedro Peláez
 

library statsd

A simple library for working with StatsD in PHP. Base on league/statsd

image

eleme/statsd

A simple library for working with StatsD in PHP. Base on league/statsd

  • Tuesday, August 30, 2016
  • by No5stranger
  • Repository
  • 1 Watchers
  • 0 Stars
  • 753 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 48 Forks
  • 1 Open issues
  • 7 Versions
  • 0 % Grown

The README.md

StatsD PHP Library

Build Status Total Downloads Latest Stable Version Bitdeli Badge, (*1)

A library for working with StatsD in PHP., (*2)

Install

Via Composer, (*3)

{
    "require": {
        "league/statsd": "1.4.*"
    }
}

To use the Statsd Service Provider, you must register the provider when bootstrapping your Laravel application., (*4)

Find the providers key in your app/config/app.php and register the Statsd Service Provider., (*5)

    'providers' => array(
        // ...
        'League\StatsD\Laravel\Provider\StatsdServiceProvider',
    )

Find the aliases key in your app/config/app.php and add the Statsd Facade Alias., (*6)

    'aliases' => array(
        // ...
        'Statsd' => 'League\StatsD\Laravel\Facade\StatsdFacade',
    )

For Laravel 5:, (*7)

Find the providers key in your config/app.php and register the Statsd Service Provider., (*8)

    'providers' => [
        // ...
        League\StatsD\Laravel5\Provider\StatsdServiceProvider::class,
    ]

Find the aliases key in your app/config/app.php and add the Statsd Facade Alias., (*9)

    'aliases' => [
        // ...
        'Statsd' => League\StatsD\Laravel5\Facade\StatsdFacade::class,
    ]

Usage

Configuring

$statsd = new League\StatsD\Client();
$statsd->configure(array(
    'host' => '127.0.0.1',
    'port' => 8125,
    'namespace' => 'example'
));

OR, (*10)

$statsd1 = StatsD\Client::instance('server1')->configure(array(...));
$statsd2 = StatsD\Client::instance('server2')->configure(array(...));

The StatsD client wait for ini_get('default_socket_timeout') seconds when opening the socket by default. To reduce this timeout, add 'timeout' => <float> to your config., (*11)

The StatsD client will throw a ConnectionException if it is unable to send data to the StatsD server. You may choose to disable these exceptions and log a PHP warning instead if you wish. To do so, include the following in your config:, (*12)

    'throwConnectionExceptions' => false

If omitted, this option defaults to true., (*13)

Counters

$statsd->increment('web.pageview');
$statsd->decrement('storage.remaining');
$statsd->increment(array(
    'first.metric',
    'second.metric'
), 2);
$statsd->increment('web.clicks', 1, 0.5);

Gauges

$statsd->gauge('api.logged_in_users', 123456);

Sets

$userID = 23;
$statsd->set('api.unique_logins', $userID);

Timers

$statsd->timing('api.response_time', 256);

Timing Blocks

$statsd->time('api.dbcall', function () {
    // this code execution will be timed and recorded in ms
});

Testing

phpunit

Contributing

Please see CONTRIBUTING for details., (*14)

Credits

License

The MIT License (MIT). Please see License File for more information., (*15)

The Versions

30/08 2016

dev-master

9999999-dev https://github.com/No5stranger/statsd

A simple library for working with StatsD in PHP. Base on league/statsd

  Sources   Download

MIT

The Development Requires

library statsd graphite

30/08 2016

1.4.1

1.4.1.0 https://github.com/No5stranger/statsd

A simple library for working with StatsD in PHP. Base on league/statsd

  Sources   Download

MIT

The Development Requires

library statsd graphite

21/04 2016

1.4.0

1.4.0.0 https://github.com/thephpleague/statsd

A simple library for working with StatsD in PHP.

  Sources   Download

MIT

The Development Requires

library statsd graphite

11/06 2015

1.3.0

1.3.0.0 https://github.com/thephpleague/statsd

A simple library for working with StatsD in PHP.

  Sources   Download

MIT

The Development Requires

library statsd graphite

17/05 2015

1.2.0

1.2.0.0 https://github.com/thephpleague/statsd

A simple library for working with StatsD in PHP.

  Sources   Download

MIT

The Development Requires

library statsd graphite

01/02 2014

1.1.0

1.1.0.0 https://github.com/thephpleague/statsd

A simple library for working with StatsD in PHP.

  Sources   Download

MIT

The Development Requires

library statsd graphite

27/08 2013

v1.0

1.0.0.0 https://github.com/php-loep/statsd

A simple library for working with StatsD in PHP.

  Sources   Download

MIT

The Development Requires

library statsd graphite