Skip to main content

A simple statsd client with DogTag-compatible tag support.

Project description

statsd is a friendly front-end to Graphite. This is a Python client for the statsd daemon. More specifically, this is a fork of jsocol’s pystatsd client, with the addition of support for DogTag-compatible tags.

Code:

https://github.com/toddjames/statsd-tags

License:

MIT; see LICENSE file

Issues:

https://github.com/toddjames/statsd-tags/issues

Documentation:

https://statsd-tags.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.

DogTag-compatible tags are supported, as well:

>>> import statsd
>>> c = statsd.StatsClient('localhost', 8125)
>>> c.gauge('baz', 42, tags=['production', 'fqdn': 'example.org'])

Installing

The easiest way to install statsd is with pip!

You can install from PyPI:

$ pip install statsd-tags

Or GitHub:

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

Or from source:

$ git clone https://github.com/toddjames/statsd-tags
$ cd statsd-tags
$ python setup.py install

Docs

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

statsd-tags-3.2.1.post1.tar.gz (24.6 kB view hashes)

Uploaded Source

Built Distribution

statsd_tags-3.2.1.post1-py2.py3-none-any.whl (11.7 kB view hashes)

Uploaded Python 2 Python 3

Supported by

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