Skip to main content

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-telegraf-3.2.1.post1.tar.gz (24.9 kB view details)

Uploaded Source

File details

Details for the file statsd-telegraf-3.2.1.post1.tar.gz.

File metadata

File hashes

Hashes for statsd-telegraf-3.2.1.post1.tar.gz
Algorithm Hash digest
SHA256 284d2355dfd5944f81bf79acd7b44cb4da5de70e8dec51a203ea12f5f5d447f8
MD5 376210ea911215eaee37db3f74ba68a3
BLAKE2b-256 7899c2ea5337145ae44f528e4b5c7289179bfb3dcfa2e1227c2913d61df47ba6

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

3.2.1.post1 This release

1 file

Supported by

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