A Python statsd client with DogTag-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.
1 maintainer
Metadata
1 maintainer
Release files for statsd-tags 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-tags-3.2.1.post1.tar.gz | 24.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| statsd_tags-3.2.1.post1-py2.py3-none-any.whl | Python 3, Python 2 | none | any | Details |
Total release size: 36.3 kB
