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

A reusable Django app to monitor all aspects of your webapp

Project Description

DO NOT USE THIS. Work in progress.

A reusable Django app to monitor all aspects of your webapp.

The idea is to create an app that provides some APIs that can be re-used by any other app.

Let’s say you want to create a graph that shows how many users sign up at your site every day.

First you will create a model that can hold this data. django-monitoring will provide some abstract base classes for commonly used model types:

class MonitorUserCount(MonitorCountBase, models.Model):

Next you will register a new monitor that is connected to that monitor model:

from monitoring import monitor
from myapp.models import MonitorUserCount

monitor.register('user_count', UserRegistrationCount)

Now you can add one count to this monitor anywhere in your code:

from monitoring import monitor

def post_registration__handler(sender, user, *args, **kwargs):
    monitor.add('user_count', 1)

django-monitoring will figure out, that the user_count monitor is connected to the MonitorUserCount model and it will also know that this model is of the type MonitorCountBase which will know how to add one data point to itself. In this case it would just add a row to the table which says that 1 user was added at

Finally django-monitoring provides a view which will show graphs for all connected monitors. I still have to think about how to teach that view which monitors to show, how to render the data and how to filter the data.

The base classes will probably have an attribute which describes the default template but you could easily override those templates for your app.


To get the latest stable release from PyPi (not yet released!)

$ pip install django-monitoring

To get the latest commit from GitHub

$ pip install -e git+git://

Add monitoring to your INSTALLED_APPS


Add the monitoring URLs to your

urlpatterns = patterns('',
    url(r'^monitoring/', include('monitoring.urls')),

Don’t forget to migrate your database

./ migrate monitoring


TODO: Describe usage or point to docs. Also describe available settings and templatetags.


If you want to contribute to this project, please perform the following steps

# Fork this repository
# Clone your fork
$ mkvirtualenv -p python2.7 django-monitoring
$ python install
$ pip install -r dev_requirements.txt

$ git co -b feature_branch master
# Implement your feature and tests
$ git add . && git commit
$ git push -u origin feature_branch
# Send us a pull request for your feature branch

Release History

This version
History Node


Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers