📖 Full documentation: https://django-eventlog.readthedocs.io/
django-eventlog is a very simple event logger you can use to track certain actions in your code. Events are stored in a Django model and can be viewed in the Django Admin.
from eventlog import EventGroup e = EventGroup() # Start a new Event Group e.info('About to send 1000 mails.', # Trigger an Event initiator='Mailer Daemon') try: # ... sending 1000 mails e.info('All emails sent!', # Trigger an Event in the same group, initiator='Mailer Daemon') # so they are combined in the admin. except Exception: e.error('There was an error sending the emails.', initiator='Mailer Daemon')
Events can be grouped in a “Event Group” and when hovering over one item in the admin, all events of the same group are highlighted:
The details view of an event will list all other events of this group so you can track the progress:
While looking similar, it’s not intended to be a replacement for your
logging facility, rather an addition to it.
django-eventlog stores it’s data in a regular database model, so each log entry will trigger a SQL Insert. Therefore you should be careful using it in high performance and/or high volume environments.