Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Easy Django integration with the ErrorStack.com service

Project Description

A Django reusable application for logging errors to the ErrorStack service.

Installation

Install from PyPI with easy_install or pip:

pip install django-errorstack

or get the in-development version:

pip install django-errorstack==tip

Dependencies

django-errorstack requires Django 1.0 or later.

Usage

To use django-errorstack in your Django project:

  1. Add 'errorstack' to your INSTALLED_APPS setting.
  2. Set the ERRORSTACK_STACK_KEY setting.
  3. Add errorstack.middleware.ErrorStackMiddleware to the end of your MIDDLEWARE_CLASSES setting.

When DEBUG is False, all unhandled view exceptions will be logged to ErrorStack. Error handling will otherwise proceed as it would otherwise: django-errorstack does not disable or modify Django’s usual error handling.

Logging errors manually

You may want to log some errors to ErrorStack in your own code, without raising an unhandled exception or displaying a 500 page to your user.

django-errorstack uses a named logger from the Python standard library logging module. The name of the logger is defined by the ERRORSTACK_LOGGER_NAME setting (defaults to “errorstack”). Assuming you don’t change the setting, you could log errors yourself like this:

import logging

logger = logging.getLogger("errorstack")

try:
    #... some code that raises an exception
except:
    logger.error("Something bad happpened.", exc_info=True)

This logger only sends errors or critical errors (not warnings or info or debug messages) to ErrorStack.

Attaching the ErrorStack handler to your own logger

Your application may already use the stdlib logging module with your own named loggers. If you want to attach the ErrorStack logger handler to your own loggers, you can do the following:

import logging

from errorstack.handlers import errorstack_handler

logger = logging.getLogger("my_logger")
logger.addHandler(errorstack_handler)

Again, this handler only listens for errors or critical errors.

Settings

ERRORSTACK_STACK_KEY

The key of the error stack you want to send errors to. This option is required.

ERRORSTACK_CATCH_404

Log Http404 exceptions to ErrorStack if this is True. False by default.

ERRORSTACK_LOGGER_NAME

The logger name to use. Defaults to “errorstack”.

CHANGES

tip (unreleased)

0.1 (2009.12.16)

  • Initial release.

TODO

Release History

Release History

This version
History Node

0.1.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-errorstack-0.1.0.tar.gz (5.2 kB) Copy SHA256 Checksum SHA256 Source Dec 16, 2009

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting