django-doctor is a Django pluggable application for checking the operational status of a Django installation. It includes checking that caching and storage is correctly set up, that email is working, etc.
This is an early draft, so use it at your own risk.
Install django-doctor (available on PyPi):
pip install django-doctor
Add it to INSTALLED_APPS in your settings.py (so Django can locate
templates):
INSTALLED_APPS += ['doctor']
And add it to your root URLconf:
urlpatterns = patterns('',
url(r'^doctor/', include('doctor.urls')),
...
)
These are the available configurable settings, along with their default values:
| Name | Default | Description |
|---|---|---|
DOCTOR_BASE_TEMPLATE |
'base.html' |
The template all the doctor templates should inherit from |
DOCTOR_SERVICES |
'doctor.services.cache.CacheServiceCheck', |
Paths to service check classes. |
DOCTOR_STORAGE_CLASSES |
settings.DEFAULT_FILE_STORAGE, |
Paths to storage classes to check. |
We are working on making a pluggable structure for the service check, work in progress. Checks for cache, Celery, email and storages are currently included by default.
Run unit tests by running python setup.py test
- Set up the project tests so they can run standalone
- Refine the service class approach
- Include sending of test email in a view?
- Implement more health checks:
- Databases
- Haystack?
- Sentry?
- That the request.is_secure() check is properly set up