spiria-digital/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 Spiria-Digital\laravel-statsd package with composer, _(*3)

composer require Spiria-Digital/laravel-statsd:5.5.1

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

Laravel >5.5, _(*5)

Since version 5.5, Laravel support Package Auto-Discovery, which means that Service Provider and aliases can be added automatically through the package composer file. Therefore, once Composer has installed or updated your packages Laravel-Statsd should be registered as a service provider and should provide the Statsd Facade., _(*6)

Laravel <5.4, _(*7)

If you are using an older verison of Laravel you must add the provider and the alias manually., _(*8)

You can register Statsd with Laravel by opening up app/config/app.php and adding the providers key in the providers array:, _(*9)

'Spiria-Digital\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:, _(*10)

'Statsd' => 'Spiria-Digital\Statsd\Facades\Statsd'

Configuration

Statsd configuration file can be extended by creating app/config/statsd.php. You can find the default configuration file under vendor/Spiria-Digital/laravel-statsd/config/config.php., _(*11)

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

$ php artisan config:publish Spiria-Digital/laravel-statsd

Usage

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

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:, _(*14)

Statsd::send()

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

This package is an updated version of rcrowe/laravel-statsd and has been tested with laravel 5.4+ only. It does not currently support Lumen., _(*16)