Skip to main content

a pluggable app that runs a full check on the deployment, using a number of plugins to check e.g. database, queue server, celery processes, etc.

Project description


This project checks a number of backends, if they are able to connect and do a simple action, e.g. check out the django ORM backend:


class DjangoDatabaseBackend(BaseHealthCheckBackend):

def check_status(self):
obj = TestModel.objects.create(title="test")
obj.title = "newtest"
return True
except IntegrityError:
raise ServiceReturnedUnexpectedResult("Integrity Error")
except DatabaseError:
raise ServiceUnavailable("Database error")


The project is made using some of the same codes, that the django admin site uses - so when you have sucessfully written a new plugin, you register it to the pool, e.g.



Add this to

url(r'^ht/', include('health_check.urls'))

Add required apps:

(remember to add dependencies, e.g. djcelery - however you should have that already, if you have celery running)

Set up monitoring

E.g. add to pingdom - django-health-check will return HTTP 200 if everything is OK and HTTP 500 if *anything* is not working.


![Screenshot of django-health-check](

Our mascot
![django-health-check is the most interresting project in the world](


Python 2.7+ (Yes, thats right, we have **Python 3 support**)

Django 1.2+

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 django-health-check, version 0.2
Filename, size File type Python version Upload date Hashes
Filename, size django-health-check-0.2.tar.gz (7.8 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