Skip to main content

KISS healthcheck implemented in Python and Bash

Project description


[![Documentation Status](](
[![Build Status](](
![Docker Build Status](
![GitHub release](
![PyPI - Python Version](
![PyPI - Wheel](

Health check system designed to be easy to extend by not enforcing the programming language.
A single health check unit (let we call it later just 'check') can be written even in BASH.


- `script` - a script that is checking something
- `check` - your definition (input arguments) how to use a `check` eg. "type": http + params what is the URL, you can define multiple configurations for single check

Guide to "check" creation
1. Write a `script` in any programming language, take environment variables as input (skip this step if you want to use existing pre-defined scripts)
2. Create a json `check` that will contain a working configuration example for your `script`.


See a working example in the `./example` directory.

# from this directory
make install

infracheck --help

docker or docker-compose:

version: '2'
image: wolnosciowiec/infracheck
command: " --directory=/data --server-path-prefix=/some-prefix"
# place your health checks structure at ./healthchecks
- "./healthchecks:/data"
- "/var/run/docker.sock:/var/run/docker.sock:ro"
- "8000:8000"
# - "traefik.frontend.rule=Host: health.localhost; PathPrefix: /some-prefix"
# - "traefik.enable=true"
# - "traefik.basic.protocol=${PROTO}"
# - "traefik.port=8000"

Project details

Release history Release notifications

Download files

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

Files for infracheck, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size infracheck-1.1.0-py3-none-any.whl (14.8 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size infracheck-1.1.0.tar.gz (42.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page