Skip to main content

django-eventlog stores event messages in a Django model.

Project description

https://travis-ci.org/bartTC/django-eventlog.svg?branch=master https://codecov.io/github/bartTC/django-eventlog/coverage.svg?branch=master

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/master/docs/_static/screenshot.png

Keep in mind:

While looking similar, it’s not intended to be a replacement for your regular Python 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.

Changelog

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-0.9.tar.gz (582.8 kB view hashes)

Uploaded Source

Built Distribution

django_eventlog-0.9-py2.py3-none-any.whl (11.7 kB view hashes)

Uploaded Python 2 Python 3

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