# jazzband/django-auditlog

A Django app that keeps a log of changes made to an object.

Repository: https://github.com/jazzband/django-auditlog
Canonical: https://ross.abutalabs.com/products/django-auditlog
Language: Python
License: MIT
License Family: permissive
Topics: django, python, auditing
Last push: 2026-08-24T17:40:52+00:00

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 50, longevity 100
- inputs: {"age_days": 4700, "days_push": 9, "days_rel": 258, "gap_med": 49, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1376, forks 451 (observed 2026-08-28T04:04:33.247686+00:00)

## What it is
django-auditlog is a reusable Django app that logs changes made to model objects, including the user (actor) who made them. It stores change summaries in JSON and is designed to be simple, fast, and dependency-light compared to full version-control-style solutions.

## Use cases
- track who changed a Django model record and what changed
- keep an audit trail of object changes for compliance
- log model field diffs in JSON format
- replace django admin's built-in log with something more flexible
- record the actor behind automated and user-driven changes

## When to choose
- you need a lightweight audit trail for Django models without full object versioning
- you want to know which user modified which records and when
- you prefer minimal dependencies and simple JSON change summaries

## When to avoid
- you need full version control, rollback, or historical snapshots of objects
- you are not using Django
- you need audit logging outside the ORM layer, such as raw SQL or external services

## Facets
- artifact type: library
- maturity: active
- function: logging, database
- domain: web-development, developer-tools, security
- platform: python
- tags: django, audit-log, change-tracking, model-history, jazzband

## Member repositories
- jazzband/django-auditlog (main) score 82

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:33.247686+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:40:30.216907+00:00, confidence not recorded.
  - readme: https://github.com/jazzband/django-auditlog (fetched 2026-08-28T04:04:33.247686+00:00, sha 119ed33de162)
  - registry_pypi: https://pypi.org/pypi/django-auditlog/json (fetched 2026-08-29T11:56:40.345905+00:00, sha 6b4b6109ad32)
- Data as of 2026-08-30T08:39:29.467469+00:00.