A simple statsd client.

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for jsocol from gravatar.com jsocol

Unverified details

These details have not been verified by PyPI
Project links
Meta
Classifiers

Project description

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

Latest CI status Latest release Supported Python versions Wheel Status
Code:

https://github.com/jsocol/pystatsd

License:

MIT; see LICENSE file

Issues:

https://github.com/jsocol/pystatsd/issues

Documentation:

https://statsd.readthedocs.io/

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 pystatsd
$ python setup.py install

Docs

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

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page