Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Daemon that runs and reports health checks

Project Description

Sauna is a small daemon designed to run health checks and send the results to a monitoring server. It is able to report to Nagios and Shinken out of the box.

It is made to be resource efficient (it avoids forking at all costs), simple to install and low maintenance.

Installation

A Debian package compatible with wheezy and jessie is available. Grab the latest release on Github and install it:

dkpg -i sauna_<version>_all.deb || apt-get install -f

Alternatively, Sauna is available on PyPI, you can install it with pip:

pip install sauna

Usage

Using Sauna you will manipulate two entities: plugins and consumers.

Plugins are optional modules that provide a set of checks. There is for instance the Load plugin which provides checks about load average or the Redis plugin which monitors the status of a Redis database. You only opt-in for the plugins that make sense for your setup.

Consumers on the other hand provide a way to send the results of checks generated by plugins to your monitoring server. There is the NSCA consumer that sends data to a Nagios compatible server or the HTTP consumer to send the check results to an API like livestatus.

Start by generating a sample configuration file sauna-sample.yml:

sauna sample

Edit the sample configuration to fit your system, pick the plugins that you want and choose a consumer. When you are done move the file as sauna.yml.

Start sauna:

sauna

You can easily run it as a daemon using systemd or supervisor.

Contributing

Sauna is written in Python 3. Adding a check plugin or a consumer should be straightforward. Clone the repository and install it in development mode in a virtualenv:

pip install -e .

The code base follows pep8, test the code for compliance with:

pep8 sauna test

Run the test suite:

nosetests

License

MIT

Release History

Release History

History Node

0.0.18

History Node

0.0.17

History Node

0.0.16

History Node

0.0.15

History Node

0.0.14

History Node

0.0.13

History Node

0.0.12

History Node

0.0.11

History Node

0.0.10

History Node

0.0.9

History Node

0.0.8

History Node

0.0.7

History Node

0.0.6

History Node

0.0.5

History Node

0.0.4

This version
History Node

0.0.3

History Node

0.0.2

History Node

0.0.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
sauna-0.0.3-py3-none-any.whl (15.3 kB) Copy SHA256 Checksum SHA256 py3 Wheel Mar 16, 2016
sauna-0.0.3.tar.gz (10.9 kB) Copy SHA256 Checksum SHA256 Source Mar 16, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting