onema/php-datadogstatsd

This is an extremely simple PHP datadogstatsd client. This is a fork of the library found in the https://www.datadoghq.com/ github repository.

PHP DataDog StatsD Client

This is an extremely simple PHP datadogstatsd client. Requires PHP >= 5.3.0., _(*1)

See CHANGELOG.md for changes., _(*2)

Installation

Composer

Add the following to your composer.json:, _(*3)

"datadog/php-datadogstatsd": "0.3.*"

Note: The first version shipped in composer is 0.0.3, _(*4)

Or manually

Clone repository at github.com/DataDog/php-datadogstatsd, _(*5)

Setup: require './libraries/datadogstatsd.php';, _(*6)

Usage

Increment

To increment things:, _(*7)

``` php DogStatsd::increment('your.data.point'); DogStatsd::increment('your.data.point', .5); DogStatsd::increment('your.data.point', 1, array('tagname' => 'value'));, <sub>(*8)</sub>

### Decrement

To decrement things:

``` php
DogStatsd::decrement('your.data.point');

Timing

To time things:, <sub>(*9)</sub>

``` php $start_time = microtime(true); run_function(); DogStatsd::timing('your.data.point', microtime(true) - $start_time);, <sub>(*10)</sub>

DogStatsd::timing('your.data.point', microtime(true) - $start_time, 1, array('tagname' => 'value'));, <sub>(*11)</sub>

### Submitting events

To submit events, you'll need to first configure the library with your
Datadog credentials, since the event function submits directly to Datadog
instead of sending to a local dogstatsd instance.

``` php
$apiKey = 'myApiKey';
$appKey = 'myAppKey';

DogStatsd::configure($apiKey, $appKey);
DogStatsd::event('A thing broke!', array(
    'alert_type'      => 'error',
    'aggregation_key' => 'test_aggr'
));
DogStatsd::event('Now it is fixed.', array(
    'alert_type'      => 'success',
    'aggregation_key' => 'test_aggr'
));

You can find your api and app keys in the API tab., <sub>(*12)</sub>

For more documentation on the optional values of events, see http://docs.datadoghq.com/api/#events/., <sub>(*13)</sub>

Note that while sending metrics with this library is fast since it's sending locally over UDP, sending events will be slow because it's sending data directly to Datadog over HTTP. We'd like to improve this in the near future., <sub>(*14)</sub>