A really simple TCP management interface is available by default on port 8126 or overriden in the configuration file. Inspired by the memcache stats approach this can be used to monitor a live statsd server. You can interact with the management server by telnetting to port 8126, the following commands are available:
The stats output currently will give you:
You can use the del commands to delete an individual metric like this :
#to delete counter sandbox.test.temporary
echo "delcounters sandbox.test.temporary" | nc 127.0.0.1 8126
Or you can use the del command to delete a folder of metrics like this :
#to delete counters sandbox.test.*
echo "delcounters sandbox.test.*" | nc 127.0.0.1 8126
Each backend will also publish a set of statistics, prefixed by its module name.
Graphite:
Those statistics will also be sent to graphite under the namespaces
stats.statsd.graphiteStats.last_exception
and
stats.statsd.graphiteStats.last_flush
.
A simple nagios check can be found in the utils/ directory that can be used to check metric thresholds, for example the number of seconds since the last successful flush to graphite.
The health output: