跳转到主要内容

通过ErrorStack.com服务轻松实现Django集成

项目描述

一个用于将错误记录到ErrorStack服务的Django可重用应用程序。

安装

使用easy_install或pip从PyPI安装

pip install django-errorstack

或获取开发版本

pip install django-errorstack==tip

依赖关系

django-errorstack需要Django 1.0或更高版本。

使用方法

要在Django项目中使用django-errorstack

  1. 'errorstack'添加到您的INSTALLED_APPS设置中。

  2. 设置ERRORSTACK_STACK_KEY设置。

  3. errorstack.middleware.ErrorStackMiddleware添加到您的MIDDLEWARE_CLASSES设置的末尾。

DEBUG为False时,所有未处理的视图异常将被记录到ErrorStack。否则,错误处理将按常规进行:django-errorstack不会禁用或修改Django的常规错误处理。

手动记录错误

您可能想在您的代码中记录一些错误到ErrorStack,而不引发未处理的异常或向用户显示500页面。

django-errorstack 使用 Python 标准库中的 logging 模块的命名记录器。记录器的名称由 ERRORSTACK_LOGGER_NAME 设置定义(默认为 “errorstack”)。假设您不更改设置,您可以通过以下方式自行记录错误:

import logging

logger = logging.getLogger("errorstack")

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

此记录器仅将错误或临界错误(而不是警告、信息或调试消息)发送到 ErrorStack。

将 ErrorStack 处理器附加到自己的记录器

您的应用程序可能已经使用自己的命名记录器使用 stdlib logging 模块。如果您想将 ErrorStack 记录器处理器附加到自己的记录器,可以执行以下操作:

import logging

from errorstack.handlers import errorstack_handler

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

再次强调,此处理器仅监听错误或临界错误。

设置

ERRORSTACK_STACK_KEY

您想要发送错误到的错误堆栈的键。此选项是必需的。

ERRORSTACK_CATCH_404

如果此为 True,则将 Http404 异常记录到 ErrorStack。默认为 False

ERRORSTACK_LOGGER_NAME

要使用的记录器名称。默认为 “errorstack”。

变更记录

提示(未发布)

0.1 (2009.12.16)

  • 初始发布。

待办事项

项目详情


下载文件

下载适合您平台的文件。如果您不确定要选择哪个,请了解有关 安装包 的更多信息。

源分布

django-errorstack-0.1.0.tar.gz (5.2 kB 查看哈希)

上传时间

由以下提供支持