Skip to main content
https://travis-ci.org/snowball-one/cid.png?branch=master https://coveralls.io/repos/snowball-one/cid/badge.png?branch=master

Logging is important. Anyone who has had a call at 3am to say the site is down knows this. Without quality logging it is almost impossible to work out what on earth is happening.

Even with plenty of logs it can be hard to track down exactly what the effects of a particular request are. Enter Django Correlation IDs. The approach is quite a simple one. Incoming requests are assigned a unique id (a uuid). This can either happen in say your public facing web server (e.g. nginx) or be applied as soon as it hits django.

This cid is then available through the django request/response cycle. We provide filters for logging witch adds the cid to the logging record so you can add it to your formatting string. We also provide wrappers around all the standard database backends which adds the cid as a comment before each SQL request.

Features

  • Processing/Generation of a correlation id

  • Database wrappers to add correlation id to each sql call

  • Logging filter to inject the correlation id into logs

  • A template context processor to make correlation id available in templates

  • Output correlation id as a header

Documentation can be found at: http://django-correlation-id.readthedocs.org/

History

0.1.0 (2014-08-05)

  • First release on PyPI.

0.1.2 (2016-12-01)

  • Made CID repsonse header configurable, and optional (thanks @dbaty)

0.2.0 (2016-12-06)

  • Added support for Django 1.10 middleware (thanks @qbey)

Release files for mbq-django-cid 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mbq-django-cid 0.2.2
File Size Uploaded
mbq-django-cid-0.2.2.tar.gz 6.7 kB Details

Release files / mbq-django-cid-0.2.2.tar.gz

Download URL mbq-django-cid-0.2.2.tar.gz
Size 6.7 kB
Tags Source
SHA-256 checksum
How to use checksums
98c548a4e35c61b57e95797aff90f68919d8430643161e3b7ce556ddef33f0f9
BLAKE2b-256 checksum
How to use checksums
569c97cc0b6d225d9070032b6ccfdd2113db04ba6ce6c62229bae2b5173d2b16
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.2.2 This release

1 release file

0.2.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page