通过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
将'errorstack'添加到您的INSTALLED_APPS设置中。
设置ERRORSTACK_STACK_KEY设置。
将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 的哈希
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 4d693f2af02b1d5b9d5fa2f554b6b963521809092926b6f8cae2f1b0829f70a4 |
|
MD5 | d0538197f8060e5cb68611f5f6ee517d |
|
BLAKE2b-256 | 4c0c7ec3cc22bac9f1a89bf92d41b9c9b4d8e08855e50558112d085176680e62 |