This project is not maintained anymore and is archived. Consider switching to the new swift-health-exporter.

This repository contains a small Python program that will scrape metrics from the output of swift-dispersion-report and swift-recon, and submit these to a StatsD endpoint.

Like any other setuptools-based Python 2 program, for example:

pip install git+https://github.com/sapcc/swift-health-statsd

Python 3 might also work, but has not been tested. (Feedback is appreciated.)

For development, setup a virtualenv and install into there:

pip install -e .
python setup.py test

Run the swift-health-statsd program from your $PATH or, if installed into a virtualenv, from the virtualenv's bin directory. The following environment variables are recognized:

ADD_HOSTNAME_SUFFIX is useful when the receiver would otherwise only observe the last value for each metric. Here's how metric names are formatted:

# example log output with ADD_HOSTNAME_SUFFIX=false (default)
DEBUG:swift_health_statsd.recon:Sending swift_cluster.drives_audit_errors = 0
DEBUG:swift_health_statsd.recon:Sending swift_cluster.drives_audit_errors = 2
DEBUG:swift_health_statsd.recon:Sending swift_cluster.drives_audit_errors = 0
# example log output with ADD_HOSTNAME_SUFFIX=true
DEBUG:swift_health_statsd.recon:Sending swift_cluster.drives_audit_errors.from.192.168.0.1 = 0
DEBUG:swift_health_statsd.recon:Sending swift_cluster.drives_audit_errors.from.192.168.0.2 = 2
DEBUG:swift_health_statsd.recon:Sending swift_cluster.drives_audit_errors.from.192.168.0.3 = 0