Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Swift Informant Middleware
Python

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
etc
extra
informant
test
.gitignore
.travis.yml
.travis_requirements
.unittests
LICENSE
README.md
setup.py

README.md

Swift Informant - Build Status

Swift Proxy Middleware to send events to a statsd instance.

After the request has been serviced (using a event posthook) it will fire a statsd counter incrementing the request method's status code. It breaks these up by whether the request was an operation on an Account, Container, or an Object. In addition to the counter a timer event is fired for the request duration of the event, as well as counter for bytes transferred.

Counter Sample:

obj.GET.200:1|c

Timer Sample:

duration.acct.GET.200:140|ms

Bytes Transferred Sample:

tfer.obj.PUT.201 2423.9

To enable, load informant as the first pipeline entry (even before catcherrors):

pipeline = informant catch_errors healthcheck cache ratelimit proxy-server

And add the following filter config:

[filter:informant]
use = egg:informant#informant
# statsd_host = 127.0.0.1
# statsd_port = 8125
# standard statsd sample rate 0.0 <= 1
# statsd_sample_rate = 0.5
# list of allowed methods, all others will generate a "BAD_METHOD" event
# valid_http_methods = GET,HEAD,POST,PUT,DELETE,COPY
# send multiple statsd events per packet as supported by statsdpy
# combined_events = no
# They key used to combine events for reporting to statsd, alternate
# versions used a # to seperate events. The offical way is by newline
# combine_key = \n
# prepends name to metric collection output for easier recognition, e.g. company.swift.
# metric_name_prepend =

The commented out values are the defaults. This module does not require any additional statsd client modules.

To utilize combined_events you'll need to run a statsd server that supports mulitple events per packet such as statsdpy

Building packages

Clone the version you want and build the package with stdeb:

git clone git@github.com:pandemicsyn/swift-informant.git informant-0.0.8
cd informant-0.0.8
git checkout 0.0.8
python setup.py --command-packages=stdeb.command bdist_deb
dpkg -i deb_dist/python-informant_0.0.8-1_all.deb
Something went wrong with that request. Please try again.