statshog 1.0.1

A simple statsd client.

A Python statsd client

A python client for Etsy's StatsD server and InfluxDB's Telegraf StatsD server.

Code: https://github.com/macobo/statshog

License: MIT; see LICENSE file

Issues: https://github.com/macobo/statshog/issues

Documentation: https://statshog.readthedocs.io/

Install

The easiest way to install statsd is with pip!

You can install from PyPI:

pip install statshog

Or GitHub:

$ pip install -e git+https://github.com/macobo/statshog#egg=statshog

Or from source:

git clone https://github.com/macobo/statshog
cd pystatsd
python setup.py install

Usage

Quick usage

import statshog
statsd = statshog.StatsClient(host='localhost', port=8125)
statsd.incr('foo')  # Increment the 'foo' counter.
statsd.timing('stats.timed', 320)  # Record a 320ms 'stats.timed'

Using with telegraf/influxdb

import statshog
statsd = statshog.StatsClient(telegraf=True)
statsd.timing('stats.timed', 320, tags={"mytag": 456})

django-statsd

To use together with django-statsd, add the following to your settings.py:

STATSD_CLIENT = "statshog"