rcrowe/laravel-statsd

Send to Statsd server from Laravel

Allows you to seamlessly send data to a Statsd server from within your Laravel application., _(*1)

, _(*2)

Installation

Add rcrowe\laravel-statsd as a requirement to composer.json:, _(*3)

{
    "require": {
        "rcrowe/laravel-statsd": "0.5.*"
    }
}

Update your packages with composer update or install with composer install., _(*4)

Once Composer has installed or updated your packages you need to register Statsd with Laravel itself. Open up app/config/app.php and find the providers key towards the bottom and add:, _(*5)

'rcrowe\Statsd\StatsdServiceProvider'

You will also need to register the facade so that you can access it within your application. To do this add the following to your aliases in app/config/app.php:, _(*6)

'Statsd' => 'rcrowe\Statsd\Facades\Statsd'

Configuration

Statsd configuration file can be extended by creating app/config/packages/rcrowe/laravel-statsd/config.php. You can find the default configuration file at vendor/rcrowe/laravel-statsd/src/config/config.php., _(*7)

You can quickly publish a configuration file by running the following Artisan command., _(*8)

$ php artisan config:publish rcrowe/laravel-statsd

Usage

Laravel-Statsd exposes the following functions to send data to Statsd:, _(*9)

Statsd::timing($key, $time);

Statsd::gauge($key, $value);

Statsd::set($key, $value);

Statsd::increment($key);

Statsd::decrement($key);

Statsd::updateCount($key, $delta);

The data is automatically sent to Statsd at the end of Laravels life-cycle, but you can force data to be sent with:, _(*10)

Statsd::send()

Note: Data will only be sent to Statsd if your environment matches the environments defined in the config file., _(*11)