Skip to main content

Simple audit logging for Django requests

Project description

This package adds simple audit logging to a Django project.

A log is generated at info level each time a request is made. The log includes the following information:

  • A UTC timestamp

  • Request method (HTTP verb)

  • Full URL

  • IP address

  • A value from a custom user field (see below)

  • The requesting user’s email address

  • The requesting user’s first name

  • The requesting user’s last name

Installation

pip install django-audit-log-middleware

Usage

Using in a Django middleware configuration:

INSTALLED_APPS = [
    ...
    "django_audit_log_middleware",
]

MIDDLEWARE = [
    ...
    "django_audit_log_middleware.AuditLogMiddleware",
]

Dependencies

This project is a Django app and depends on the Django package.

This package uses Django IPware https://github.com/un33k/django-ipware for IP address capture.

Settings

AUDIT_LOG_USER_FIELD

Provide to define a field on your user model that should be captured in the audit log. Email, first name and last name are captured by default.

Tests

$ pip install -r requirements.txt
$ tox

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_audit_log_middleware-0.0.5.tar.gz (3.8 kB view hashes)

Uploaded Source

Built Distribution

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