A Django app to log management commands
Django CommandLog adds the feature of logging the django management commands into the database so it’s available in the admin interface.
We’ve been using this to check the result of scheduled management commands directly through the admin interface. It works by copying the stream of stdout and stderr.
The decorator also adds some helper methods, see below.
- Add “django_commandlog” to your INSTALLED_APPS settings like this:
INSTALLED_APPS = [ ... 'django_commandlog', ]
python manage.py migrateto add the tables of
django_commandlogto your database.
3. To log an admin command, add the
@command_log decorator above the class
(see example below). Thus, it currently supports only custom management
commands. If you wish to add this to default django manage commands you’ll
have to create a child class with the decorator. Pull/Merge requests
are welcome with a fix for this.
@command_log class SampleCommand(BaseCommand): def handle(self, *args, **options): ...
There are currently no configuration values.
When your class is decorated with @command_log, you have access to additional methods.
CommandLog includes counters for basic CRUD operations (Create, Read, Update, Delete) which can be used through helper methods provided:
add_log_created(10) add_log_read(30) add_log_updated(20) add_log_deleted(30) add_log_errors(14)
There are two fields used to track the commands or runs: reference and user. Reference is any number you want to track in your manage commands.
You can also add a user to the tracking by using the
user can be a string which will be kept as-is or you can use a
add_log_reference("C1235342321") add_log_user("user:ldap:username") # or add_log_user(user_instance)
- python 2.7, 3.4, 3.5
- django 1.10
Tested on Django 1.10.3