Skip to content
A Python client for statsd http://statsd.readthedocs.org/
Python
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
docs
statsd
.gitignore
.travis.yml
AUTHORS
CHANGES
LICENSE
MANIFEST.in
README.rst
requirements.txt
setup.py
tox.ini

README.rst

A Python statsd client

statsd is a friendly front-end to Graphite. This is a Python client for the statsd daemon.

Quickly, to use:

>>> import statsd
>>> c = statsd.StatsClient('localhost', 8125)
>>> c.incr('foo')  # Increment the 'foo' counter.
>>> c.timing('stats.timed', 320)  # Record a 320ms 'stats.timed'.

You can also add a prefix to all your stats:

>>> import statsd
>>> c = statsd.StatsClient('localhost', 8125, prefix='foo')
>>> c.incr('bar')  # Will be 'foo.bar' in statsd/graphite.

Installing

The easiest way to install statsd is with pip!

You can install from PyPI:

$ pip install statsd

Or GitHub:

$ pip install -e git+https://github.com/jsocol/pystatsd#egg=statsd

Or from source:

$ git clone https://github.com/jsocol/pystatsd
$ cd statsd
$ python setup.py install

Docs

There are lots of docs in the docs/ directory and on ReadTheDocs.

Something went wrong with that request. Please try again.