sunnyingit/statsd

A library for working with StatsD

StatsD PHP Library

A library for working with StatsD in PHP.

Install

Via Composer

{
    "require": {
        "league/statsd": "~1.0"
    }
}

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

Find the providers key in your app/config/app.php and register the Statsd Service Provider.

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

Find the aliases key in your app/config/app.php and add the Statsd Facade Alias.

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

Usage

Configuring

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

OR

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

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);

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.

Credits

• Marc Qualie
• All Contributors

License

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