Report on Service Level Objectives Compliance

You have a few dashboards in Librato that describe your Service Level Objectives. You want a report on SLO breaches over the past day/week.

api = sloc_librato.LibratoApi(email=LIBRATO_EMAIL, token=LIBRATO_TOKEN)
charts = [{'threshold': 100, 'chart_name': 'Website Response Time Mean'}]
report.daily_report(api, 'SLO - Production Website', charts, 7)

slocr daily --space 'SLO - Production Website' --chart 'Website Response Time Mean' --threshold 100 --chart 'Website Reponse Time  p95' --threshold 200 --num-days 7

• python-project-template - Project template and massive timesaver, with many of the below tools prconfigured
• Paver for running miscellaneous tasks
• Setuptools for distribution (Setuptools and Distribute_ have merged_)
• Sphinx for documentation
• flake8 for source code checking
• pytest for unit testing
• mock for mocking (not required by the template, but included anyway)
• tox for testing on multiple Python versions

With pyenv and pyenv-virtualenv

pyenv virtualenv sloc_report
pyenv local sloc_report

With virtualenvwrapper

mkvirtualenv sloc_report

With plain virtualenv_::

virtualenv VENV
source VENV/bin/activate

pip install -r requirements-dev.txt

paver test

paver lint

Integration tests require real librato credentials. Ideally this should be a read-only API token. The following environment variables are required:

• LIBRATO_EMAIL - the primary email address associated with the account
• LIBRATO_TOKEN - the API token
• LIBRATO_TEST_SPACE - Name of a space that exists within the librato account and has at least one chart

To run the integration tests:

    paver test_integration

#. Run all the tests

paver test_all

You should see output similar to this:

$ paver test_all
---> pavement.test_all
No style errors
========================================= test session starts =========================================
platform darwin -- Python 2.7.3 -- pytest-2.3.4
collected 5 items

tests/test_main.py .....

====================================== 5 passed in 0.05 seconds =======================================
  ___  _   ___ ___ ___ ___
 | _ \/_\ / __/ __| __|   \
 |  _/ _ \\__ \__ \ _|| |) |
 |_|/_/ \_\___/___/___|___/

• CPython 2.7

Other Pythons may also work but are at this point unsupported.

Jython_ and IronPython_ may also work, but have not been tested. If there is interest in support for these alternative implementations, please open a feature request!

Please report any bugs or requests that you have using the GitHub issue tracker!

• Richard Clark - [email protected]