sprockets.clients.statsd¶
The sprockets.clients.statsd package implements a simple statsd client that is used by the sprockets.mixins.statsd package. It can be used in your applications for sending metric values to statsd.
Installation¶
sprockets.clients.statsd is available on the Python Package Index and can be installed via pip or easy_install:
pip install sprockets.clients.statsd
Configuration¶
The default statsd server that is used is localhost:8125. The STATSD_HOST and STATSD_PORT environment variables can be used to set the statsd server connection parameters. Note that the socket for communicating with statsd is created once upon module import and will not change until the application is restarted or the module is reloaded.
API Documentation¶
StatsD API¶
The default statsd server that is used is localhost:8125. The STATSD environment variable can be used to set the statsd server connection parameters. Note that the socket for communicating with statsd is created once upon module import and will not change until the application is restarted or the module is reloaded.
- sprockets.clients.statsd.add_timing(*args, **kwargs)¶
Add a timer value to statsd. The key is specified as one or more strings that will be joined together with period delimiters. The value must be specified as a keyword argument. The following example will add a
timing to the statsd key foo.bar.baz of 3.14159.
add_timing('foo', 'bar', 'baz', value=3.14159)
Parameters: - parts (list) – The key parts to append to the base key
- value (int|float) – The time value
- sprockets.clients.statsd.incr(*args, **kwargs)¶
Increment a statsd counter by the specified value. If you intend to increment the value by anything other than one, you must specify the value as a keyword argument. In the following example, the statsd key foo.bar.baz will be incremented by 2.
incr('foo', 'bar', 'baz', value=2)
Parameters: - args (list) – Metric name parts to increment
- value (int|float) – The value to increment by
- sprockets.clients.statsd.set_address()¶
Set the (host, port) to connect to from the environment.
If the environment is updated, a call to this function will update the address this client connects to.
This function will prefer to use the STATSD connection string environment variable, but will fall back to using the STATSD_HOST and STATSD_PORT.
- sprockets.clients.statsd.set_gauge(*args, **kwargs)¶
Set a gauge value in statsd. The key is specified as one or more strings that will be joined together with period delimiters. The value must be specified as a keyword argument. The following example will set the statsd key foo.bar.baz to 3.
set_gauge('foo', 'bar', 'baz', 3)
Parameters: - args (list) – The gauge metric name to set
- value (int|float) – The gauge value
Examples¶
The following example demonstrates how to use sprockets.clients.statsd by incrementing a counter, setting a gauge value, and adding a timing value:
from sprockets.clients import statsd
# Increment foo.bar.baz by 1
statsd.incr('foo', 'bar', 'baz')
# Set a gauge value
statsd.set_gauge('foo', 'bar', 'baz', value=10)
# Add a timing value
statsd.add_timing('foo', 'bar', 'baz', value=3.14159)
Version History¶
See Version History
Issues¶
Please report any issues to the Github project at https://github.com/sprockets/sprockets.clients.statsd/issues
Source¶
sprockets.clients.statsd source is available on Github at https://github.com/sprockets/sprockets.clients.statsd