Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A python eventlet based statsd server

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


Simple event based statsd implementation written in python using eventlet. Its a work in progress but the basics are there.


statsdpy sample config:

#graphite host and port to connect too.
#graphite_host =
#graphite_port = 2003
#address and port we should listen for udp packets on
#listen_addr =
#listen_port = 8125
#Debug mode is enabled by default!
#debug = true
#How often to flush stats to graphite 
#flush_interval = 10
#calculate XXth percentile
#percent_threshold = 90
#accept multiple events per packet
#combined_events = no
  • Edit the config file to adjust your to your environment.
  • Start the service: statsdpy-server start --conf=/path/to/your.conf
  • Fire some udp counter or timer events at statsdpy
  • Check syslog for any errors starting up or processing events
  • Profit!

Its important to note that statsdpy runs in debug mode by default (at least for now). So if you wont be running it in the foreground with the -f|--foreground flag you might wanna set debug = false in your config. However, running with debug enabled and in the foreground makes it very handy for debuging new statsd clients/events (just dont point it at a valid graphite host).

Event Types

As with the original statsd implementation from etsy the following event types are supported:



Simple counters. Add 1 to the "sitelogins" event bucket. It stays in memory until flushed to graphite as specified by the flush_interval.


Another counter, this time add "7" to the "500errors" event bucket.



The "pageload" event took 320ms to complete this time. statsdpy computes the XXth percentile (as specified in the config), average (mean), lower and upper bounds for the configured flush interval.

Combined Events

Unlike the original implementation this version can also process multiple events per packet. If the config option "combined_events" is enabled multiple metrics can be combined in a single udp packet. Event's need to be separated by a single #:




This counter is being sent sampled every 1/10th of the time.


This counter is being sampled at a 50% rate.

Building packages

Clone the version you want and build the package with stdeb (sudo apt-get install stdeb):

git clone statsdpy-0.0.5
cd statsdlog-0.0.5
git checkout 0.0.5
python --command-packages=stdeb.command bdist_deb
dpkg -i deb_dist/python-statsdpy_0.0.5-1_all.deb
Something went wrong with that request. Please try again.