Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Daemon that runs and reports health checks

Project description

Sauna is a lightweight daemon designed to run health checks and send the results to a monitoring server.

Sauna comes batteries included, it is able run many system checks (load, memory, disk…) as well as monitor applications (redis, memcached, puppet…). It is easily extensible to include your own checks and can even run the thousands of existing Nagios plugins.


You can install it with pip:

pip install sauna

See the documentation for other installation methods.


Documentation for sauna is available at


Plugins are optional modules that provide a set of checks. You only opt-in for the plugins that make sense for your setup. Available plugins are:

  • Load average
  • Memory and swap usage
  • Disk partition usage
  • Processes and file descriptors
  • Redis
  • External command
  • Puppet agent
  • Postfix
  • Memcached
  • HTTP servers


Consumers on the other hand provide a way for checks to be processed by a monitoring server. Available consumers are:

  • NSCA
  • HTTP
  • TCP server
  • Stdout


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 tests

Run the test suite:


More information about how to contribute are available on the development guide.



Project details

Download files

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

Files for sauna, version 0.0.18
Filename, size File type Python version Upload date Hashes
Filename, size sauna-0.0.18-py3-none-any.whl (48.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size sauna-0.0.18.tar.gz (31.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page