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:
- License:
MIT; see LICENSE file
- Issues:
- Documentation:
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)
| 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 |