Full featured error tracking module for Python apps supports Flask and Django
ErrorTracker is a batteries-included app and extensions for python app, that can track errors, send notification, mask sensitive data and capture frames data.
Simple to use extension that lets you add error recording interfaces to Python applications. It's implemented in such a way that the developer has total control of the resulting application.
Out-of-the-box, Error Tracker plays nicely with various ORM's, including
It also boasts a simple Model management interface.
The biggest feature of ErrorTracker is flexibility. To start off with you can create a very simple application in no time, with exception monitor enabled, but then you can go further and customize different aspects.
ErrorTracker is an active project, well-tested and production ready.
To install ErrorTracker, simply:
pip install error-tracker
- Sensitive data( like password, secret ) Masking
- Record all the frames ( frame data are stored in JSON format so that it can be analyzed later)
- Unique URL generation
- Number of times the exception occurred and first/last time of exception
- Sending notifications with exception details
- Record different types of exception like 500 or 404 etc
- Raise or update ticket in Jira/Bugzilla etc by ticketing interface.
Flask App configuration
... APP_ERROR_SEND_EMAIL = True APP_ERROR_RECIPIENT_EMAIL = ('email@example.com',) APP_ERROR_SUBJECT_PREFIX = "Server Error" APP_ERROR_EMAIL_SENDER = 'firstname.lastname@example.org'
from flask import Flask from flask_mail import Mail import settings from error_tracker import AppErrorTracker, NotificationMixin from flask_sqlalchemy import SQLAlchemy ... app = Flask(__name__) app.config.from_object(settings) db = SQLAlchemy(app) class Notifier(Mail, NotificationMixin): def notify(self, request, exception, email_subject=None, email_body=None, from_email=None, recipient_list=None): message = Message(email_subject, recipient_list, email_body, sender=from_email) self.send(message) mailer = Notifier(app=app) error_tracker = AppErrorTracker(app=app, db=db, notifier=mailer) .... .... # Record exception when 404 error code is raised @app.errorhandler(403) def error_403(e): error_tracker.capture_exception() # any custom logic # Record error using decorator @app.errorhandler(500) @error_tracker.track_exception def error_500(e): # some custom logic ....
Django App Usage
We need to update settings.py file as
- Add app to installed apps list
- Add Middleware for exception tracking. This should be added at the end so that it can process exception 1st in the middleware call stack.
- Other configs related to notification
... APP_ERROR_RECIPIENT_EMAIL = ('email@example.com',) APP_ERROR_SUBJECT_PREFIX = "Server Error" APP_ERROR_EMAIL_SENDER = 'firstname.lastname@example.org' INSTALLED_APPS = [ ... 'error_tracker.DjangoErrorTracker' ] MIDDLEWARE = [ ... 'error_tracker.django.middleware.ExceptionTrackerMiddleWare' ]
This has got extensive document browse at https://error-tracker.readthedocs.io/en/latest/
All docs are in docs/source
And if you want to preview any .rst snippets that you may want to contribute, go to http://rst.ninjs.org/.
Several usage examples are included in the /tests folder. Please feel free to add your own examples, or improve on some of the existing ones, and then submit them via GitHub as a pull-request.
You can see some of these examples in action at https://github.com/sonus21/error-tracker/tree/master/examples To run the examples on your local environment, one at a time, do something like:
cd error-tracker/examples cd DjangoSample python manage.py runserver
cd flask-sample python app.py
To run the tests, from the project directory, simply:
pip install -r requirements-dev.txt bash run-tests.sh
You should see output similar to:
............................................. ---------------------------------------------------------------------- Ran 31 tests in 1.144s OK
You're most welcome to raise pull request or fixes.