Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

A fork of pystatsd package with Telegraf-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.

Release history Release notifications

This version
History Node

3.2.1.post1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
statsd-telegraf-3.2.1.post1.tar.gz (24.9 kB) Copy SHA256 hash SHA256 Source None Mar 22, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page