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/
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
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'
import statshog
statsd = statshog.StatsClient(telegraf=True)
statsd.timing('stats.timed', 320, tags={"mytag": 456})
Update your settings.py to have the following values if using non-defaults:
STATSD_HOST
(default:'localhost'
)STATSD_PORT
(default:8125
)STATSD_PREFIX
(default:None
)STATSD_MAXUDPSIZE
(default:512
)STATSD_IPV6
(default:False
)STATSD_TELEGRAF
(default:False
)STATSD_SEPARATOR
(default:'.'
)
Then, you can use statshog as following:
from statshog.defaults.django import statsd
statsd.timing('stats.timed', 320)
To use together with
django-statsd, also add
the following to your settings.py
:
STATSD_CLIENT = "statshog"