This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
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

0.1.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

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 HPE HPE Development 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