Skip to main content

A Python statsd client with Telegraf-compatible tag support

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.

Metadata

Release files for statsd-telegraf 3.2.1.post1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for statsd-telegraf 3.2.1.post1
File Size Uploaded
statsd-telegraf-3.2.1.post1.tar.gz 24.9 kB Details

Release files / statsd-telegraf-3.2.1.post1.tar.gz

Download URL statsd-telegraf-3.2.1.post1.tar.gz
Size 24.9 kB
Tags Source
SHA-256 checksum
How to use checksums
284d2355dfd5944f81bf79acd7b44cb4da5de70e8dec51a203ea12f5f5d447f8
BLAKE2b-256 checksum
How to use checksums
7899c2ea5337145ae44f528e4b5c7289179bfb3dcfa2e1227c2913d61df47ba6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

3.2.1.post1 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page