Yet another Django audit log app, hopefully the easiest one.
This app allows you to keep track of every action taken by your users.
Install Django Easy Audit by running
pip install django-easy-audit.
Alternatively, you can download the latest release from GitHub, unzip it, and place the folder 'easyaudit' in the root of your project.
Add 'easyaudit' to your
INSTALLED_APPS = [ ... 'easyaudit', ]
Add Easy Audit's middleware to your
MIDDLEWARE_CLASSES) setting like this:
MIDDLEWARE = ( ... 'easyaudit.middleware.easyaudit.EasyAuditMiddleware', )
python manage.py migrate easyauditto create the app's models.
That's it! Now every CRUD event on your whole project will be registered in the audit models, which you will be able to query from the Django admin app. Additionally, this app will also log all authentication events and all URLs requested.
For an exhaustive list of available settings, please check our wiki.
Below are some of the settings you may want to use. These should be defined in your project's
Set these to
Falseto stop logging model, authentication, and/or request events.
A list of Django models which will be ignored by Django Easy Audit. Use it to prevent logging one or more of your project's models. List items can be classes or strings with
A list of URLs which will be ignored by Django Easy Audit. List items are expected to be regular expressions that will be matched against the URL path. Check our wiki for more details on how to use it.
What does it do
Django Easy Audit uses Django signals to listen to the events happenning in your project, such as when a user creates, updates or deletes a registry. This applies to every model of every app in your project.
When any of these events takes place, Django Easy Audit will log it in the model
You can query this information in the Django Admin app.
Besides logging CRUD events, Django Easy Audit will log all authentication events (such as when a user logs in, out, or fails to log in) and all the URLs requested in the project. This information is stored in models
Why you should use it
There are many Django auditing apps out there, but most them require you to change very important parts of your project's code. For example, they require you to add fields to your models, or make them inherit from a certain class. Some of them create a mirror for each of your models, which means duplicate migrations.
It is not that they don't work or that they are not great apps. But in case you need something easier to set up, and you don't want your code to depend so much on a third-party app, Django Easy Audit may be your best choice.
The good thing about this app is that it doesn't get in the way. It is easy and quick to install, and it begins logging everything right away, without you having to inject code anywhere in your project.