Skip to main content

django-eventlog stores event messages in a Django model.

Project description

https://img.shields.io/pypi/v/django-eventlog.svg https://github.com/bartTC/django-eventlog/actions/workflows/push.yml/badge.svg

📖 Full documentation: https://django-eventlog.readthedocs.io/

Compatibility Matrix:

Py/Dj

3.8

3.9

3.10

3.11

3.2 (LTS)

4.0

4.1

4.2 (LTS)

django-eventlog

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.

Usage Example:

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:

https://github.com/bartTC/django-eventlog/raw/main/docs/_static/change_list.png

The details view of an event will list all other events of this group so you can track the progress:

https://github.com/bartTC/django-eventlog/raw/main/docs/_static/change_form.png

Changelog

1.2 (2023-04-28)

  • Python 3.7 to 3.11 compatibility

  • Django 3.2 to 4.2 support

1.1 (2018-05-11)

  • Added ability to manually set a group id to make an EventGroup object reusable through threads.

1.0 (2018-02-13)

  • Production ready 1.0 release.

  • The details Admin view now displays all events of the group with an annotated delay, so you can see the progress of the group.

0.9 (2018-02-13)

  • Initial release.

  • Django 1.8 to 2.0 compatibility.

  • Python 2.7 to 3.6 compatibility.

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-eventlog-1.2.tar.gz (1.7 MB view hashes)

Uploaded source

Built Distribution

django_eventlog-1.2-py2.py3-none-any.whl (12.6 kB view hashes)

Uploaded py2 py3

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