liuggio / statsd-client-bundle
Provides a statsd client and simple ready-to-use support for #Symfony2 Application
Installs: 693 264
Dependents: 0
Suggesters: 0
Security: 0
Stars: 164
Watchers: 9
Forks: 43
Open Issues: 7
Type:symfony-bundle
Requires
- php: ^7.0 || ^8.0
- liuggio/statsd-php-client: ~1.0.14
- symfony/framework-bundle: ^4.0 || ^5.0
Requires (Dev)
- doctrine/dbal: >=2.2.0
- monolog/monolog: >=1.2.0
- phpunit/phpunit: ^6.5 || ^7.0 || ^9.5
- symfony/yaml: ^4.0 || ^5.0
Suggests
- doctrine/dbal: Doctrine DBAL, collect statistic to/from the database (>=2.2.0 required)
- monolog/monolog: Monolog, in order to generate statistic from log >=1.2.0)
This package is auto-updated.
Last update: 2024-10-29 04:14:32 UTC
README
This bundle helps you to monitor your application.
It uses statsd-php-client as Client for the etsy/Statsd API.
It Includes
- a Service, a Factory and an Entity callable by the DIC
- a Monolog Handler
- a series of Collectors in order to aggregate your personal data.
- a series of Commands in order to execute data also from cli.
Simple usage!
$this->get('statsd') ->increment('log.error') ->gauge('log.rate', 25) ->flush();
Check out the documentation
Articles
- Article: ServerGrove - Interesting Symfony Bundles: StatsDClientBundle
- Article : Install Stats.d / Graphite on a debian server in order to monitor a Symfony2 application (1/2)
- Article : Monitor your Symfony2 application via Stats.d and Graphite (2/2)
- Slide : Building OpenSky with Symfony2 by Jonathan H. Wage
Abstract
Monitoring what is happening in your production Symfony2 application, with StatsD and Graphite.
Within this bundle you could use ready-to-go monitor for
-
Monolog
-
Amount of visitor
-
Logged vs Anonymous user
-
SQL: Verbs used (amount of select/set/update/upgrade/delete) (this feature is not suggested, please use a server monitor tool eg. nagios, munin)
-
Amount of PHP ram used
-
You could create your own using the Factory and the Service.
On dev env the data are not pushed to the socket but to syslog.
If debug mode is enabled no packet are sent over the udp socket, and you could see what's going on reading the syslog with tail -f /var/log/syslog
Mar 19 00:48:11 liuggio nginx: statsd-open
Mar 19 00:48:11 liuggio nginx: statsd-write "tvision.visitor:1|tvision.memory:43520|tvision.user.anonymous:1|tvision.query.start:1|tvision.query.insert:1|c" 118 Bytes
Mar 19 00:48:11 liuggio nginx: statsd-close
Note: by default in dev
environment debug is true.
One UDP packet to rule them all
With a proper config file, your StatsD server will receive in a single upd packet:
prefix.visitor:1|c # Increment visitor
prefix.user.anonymous:1|c # The visitor is not logged
prefix.log.app.error.user_action:1 # Stats by monolog with $this->get('logger')->error('user_action')
prefix.memory:4480|g # The php memory peak was 4480 MB
prefix.exception.exception.500:1|c # Exception occurred, the Exception code was 500
prefix.query.insert:1|c # Query Insert
prefix.query.select:1|c # Query Select
Short Theory and links
Vagrant StatSD and Graphite
see this blog post to install Easy install statsd graphite with vagrant.
StatsD
StatsD is a simple daemon for easy stats aggregation
Graphite
Graphite is a Scalable Realtime Graphing
The Client send data with UDP (faster)
https://www.google.com/search?q=tcp+vs+udp
Contribution
See CONTRIBUTING.md
Contributors
https://github.com/liuggio/StatsDClientBundle/graphs/contributors