Skip to main content

django_trace is a python package for monitoring your django web app

Project description


django_trace is a django app that monitors your web app and your server resources and audits logins and web requests Each of these operations can be disabled and they are all secure

How to install: pip install django_trace


  • in your, under INSTALLED_APPS, add 'django_trace'
  • add 'django_trace.middleware.MonitorMiddleware' to your MIDDLEWARE_CLASSES (for django<1.10) or MIDDLEWARE (for django >= 1.10)_inside your
  • migrate using these commands
python makemigrations django_trace
python migrate
  • optionally you can configure the options for django_trace by adding DJANGO_TRACE to your

Here is an optional configuration that you can put in your

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'

    "WARNING_EMAILS": [""],
    "PATH_FILTER": [],
    "MAX_LOG_COUNT": 10000,

By default, ONLY_TRACE_LOGGED_IN_USERS is True which means you only record web requests for logged in users.

To see who is logged in or out of the system, see the admin page which is /admin/django_trace/audit. To see all the http activities, see the admin page /admin/django_trace/log

If there are urls that you do not wish to monitor, you can tiler them out using a list of regex in PATH_FILTER. By default, the system keeps 10000 records in the logs which can be modified by adjusting MAX_LOG_COUNT.

Sending alerts when resources are running low:

"WARNING_EMAILS" can be used to inform you when your server is running low on memory or disk usage. In order to use that, you put the emails of the people whom need to be informed in the WARNING_EMAILS list. MEMORY_THRESHOLD and DISK_THRESHOLD have a 85% default but you can adjust them.

Then, you must run the command

python check_resources

in your cron job to check the state of your server periodically. There is a quiet period set to 1 day so if one of the resources is running low and an email is sent, the check will abort withing the next day. If you want to change the quiet period from the default 1 day, you can use the option QUIET_TIME_MINUTES within DJANGO_TRACE.

Also, the host name is automatically determined to be included in the email. If you want to overwrite it, use the HOST option.

If you have any questions or request, please feel free to contact the author or post it on github.

Project details

Download files

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

Source Distribution

django_trace-1.15.tar.gz (5.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page