liuggio / statsd-php-client
Statsd (Object Oriented) client library for PHP
Installs: 3 266 293
Dependents: 10
Suggesters: 0
Security: 0
Stars: 114
Watchers: 11
Forks: 32
Open Issues: 16
Requires
- php: >=5.3.2
Requires (Dev)
- monolog/monolog: >=1.2.0
- phpunit/phpunit: ^4.7
Suggests
- monolog/monolog: Monolog, in order to do generate statistic from log >=1.2.0)
This package is auto-updated.
Last update: 2024-10-17 00:08:25 UTC
README
statsd-php-client
is an Open Source, and Object Oriented Client for etsy/statsd written in php
Install with composer
composer require liuggio/statsd-php-client
Simple Usage
$statsd = new StatsdService(); $service->timing('usageTime', 100); $service->increment('visitor'); $service->decrement('click'); $service->gauge('gaugor', 333); $service->set('uniques', 765); $service->flush();
Why use this library instead the statsd/php-example?
-
You are wise.
-
You could also use monolog to redirect data to statsd
-
This library is tested.
-
This library optimizes the messages to send, compressing multiple messages in individual UDP packets.
-
This library pays attention to the maximum length of the UDP.
-
This library is made by Objects not array, but it also accepts array.
-
You do want to debug the packets, and using
SysLogSender
the packets will be logged in yoursyslog
log (on debian-like distro:tail -f /var/log/syslog
)
Advanced Instantiation
use Liuggio\StatsdClient\StatsdClient, Liuggio\StatsdClient\Factory\StatsdDataFactory, Liuggio\StatsdClient\Sender\SocketSender, Liuggio\StatsdClient\Service\StatsdService; // use Liuggio\StatsdClient\Sender\SysLogSender; $sender = new SocketSender(/*'localhost', 8126, 'udp'*/); // $sender = new SysLogSender(); // enabling this, the packet will not send over the socket $client = new StatsdClient($sender); $factory = new StatsdDataFactory('\Liuggio\StatsdClient\Entity\StatsdData'); $service = new StatsdService($client, $factory); // create the metrics with the service $service->timing('usageTime', 100); //... // send the data to statsd $service->flush();
Usage with Monolog
use Liuggio\StatsdClient\StatsdClient, Liuggio\StatsdClient\Factory\StatsdDataFactory, Liuggio\StatsdClient\Sender\SocketSender; // use Liuggio\StatsdClient\Sender\SysLogSender; use Monolog\Logger; use Liuggio\StatsdClient\Monolog\Handler\StatsDHandler; $sender = new SocketSender(/*'localhost', 8126, 'udp'*/); // $sender = new SysLogSender(); // enabling this, the packet will not send over the socket $client = new StatsdClient($sender); $factory = new StatsdDataFactory(); $logger = new Logger('my_logger'); $logger->pushHandler(new StatsDHandler($client, $factory, 'prefix', Logger::DEBUG)); $logger->addInfo('My logger is now ready');
the output will be: prefix.my_logger.INFO.My-logger:1|c" 36 Bytes
Short Theory
Easily Install StatSD and Graphite
In order to try this application monitor you have to install etsy/statsd and Graphite
see this blog post to install it with vagrant Easy install statsd graphite.
StatsD
StatsD is a simple daemon for easy stats aggregation
Graphite
Graphite is a Scalable Realtime Graphing
The Client sends data with UDP (faster)
https://www.google.com/search?q=tcp+vs+udp
Contribution
Active contribution and patches are very welcome. To keep things in shape we have quite a bunch of unit tests. If you're submitting pull requests please make sure that they are still passing and if you add functionality please take a look at the coverage as well it should be pretty high :)
- First fork or clone the repository
git clone git://github.com/liuggio/statsd-php-client.git
cd statsd-php-client
- Install vendors:
composer.phar install
- This will give you proper results:
phpunit --coverage-html reports
Core developers:
This project is actively maintained by David Moreau AKA @dav-m85 and @liuggio