Skip to main content

Set of utilities for better logging in WSGI applications

Project description

Kudzu provides WSGI middleware and logging handlers which:

  • Read or generate unique ID for each request and include this request ID in emitted log records.
  • Sends request ID in response using X-Request-ID header. This ID is also made globally available and can included when calling other applications or components.
  • Logs all requests and responses using Python standard logging.

Kudzu is framework independent and it is compatible with both Python 2 (tested with 2.6 and 2.7) and Python 3 (tested with 3.3 and 3.4).


Kudzu can be installed using pip (or easy_install) from PyPI:

$ pip install kudzu

Alternatively you can download and extract tarball and install the package manually:

$ python install

Placing the package to your PYTHONPATH should also work.

Example usage

# Apply middleware to WSGI application
application = kudzify_app(application)

# Include request ID and remote address in log records
kudzify_logger(format='[%(addr)s|%(rid)s] %(levelname)s:%(message)s')

See for more information.


Tests for all supported Python versions can be run using Tox:

$ tox

Alternativelly you can install Kudzu with test dependencies pytest and Werkzeug and run tests manually:

$ py.test

Release history Release notifications | RSS feed

This version


Download files

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

Files for Kudzu, version 0.1
Filename, size File type Python version Upload date Hashes
Filename, size Kudzu-0.1.tar.gz (12.2 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