ftw.raven 1.3.1

目的

此包扩展了 raven，它是Plone集成Sentry的一种方法，不是基于记录器的，而是挂钩到Zope异常处理。

请注意，已经存在一个标准的基于记录器的 Zope / Plone集成raven。除非您想要基于异常挂钩的集成，否则您应该使用标准实现。

安装和配置

• 将 ftw.raven 包添加到您的依赖项中。

• 在buildout中使用环境变量配置raven客户端

buildout的示例配置

[instance]
eggs +=
    ftw.raven
environment-vars +=
    RAVEN_DSN https://123:456@sentry.local/2

配置-测试

您可以通过访问任何上下文上的 raven-test 视图作为 Manager-用户来测试您的配置。这将触发一个异常，该异常应出现在您的sentry项目中。

请注意，在某些情况下，触发器可能无法在本地测试系统中正常工作。

在JavaScript中，您可以在JavaScript控制台中调用 raven_test() 函数，这将也会触发一个异常。

版本跟踪

当报告异常时，可以发送版本。版本可以是发布分发的版本号（例如在pypi上发布）或应用程序未在pypi上发布时项目检出的HEAD SHA。

[instance]
environment-vars +=
    RAVEN_PROJECT_DIST my.project

[instance]
environment-vars +=
    RAVEN_BUILDOUT_ROOT ${buildout:directory}

忽略异常

默认情况下，不会报告所有异常，因为一些异常，如重定向或404，不是错误，而是作为异常实现。如果没有配置，将不会报告异常NotFound、Unauthorized、Redirect和Intercepted。

可以通过环境变量RAVEN_ENABLE_EXCEPTIONS启用这些异常的报告

[instance]
environment-vars +=
    RAVEN_ENABLE_EXCEPTIONS NotFound, Redirect

如果您需要禁用自定义异常，可以使用环境变量RAVEN_DISABLE_EXCEPTIONS来做到这一点

[instance]
environment-vars +=
    RAVEN_DISABLE_EXCEPTIONS UnimportantError

报告JavaScript错误

为了能够报告JavaScript错误，必须安装ftw.raven:default通用设置配置文件，该配置文件注册了一个包含raven库和配置的JavaScript。

附加标签

可以为部署报告附加额外的预定义标签。这些标签可以直接在环境变量RAVEN_TAGS中以JSON形式声明，或者变量RAVEN_TAGS_FILE可以包含指向json文件的路径。这两种方法可以结合使用，相应的字典将合并（RAVEN_TAGS变量的标签优先）。

JSON必须是一个包含字符串作为键和值的单级散列。

示例

[instance]
environment-vars +=
    RAVEN_TAGS {"deployment": "production"}

[instance]
environment-vars +=
    RAVEN_TAGS_FILE ${buildout:directory}/conf/raven_tags.json

链接

• Github: https://github.com/4teamwork/ftw.raven

• 问题：https://github.com/4teamwork/ftw.raven/issues

• Pypi: http://pypi.python.org/pypi/ftw.raven

• 持续集成：https://jenkins.4teamwork.ch/search?q=ftw.raven

版权

本软件包版权所有4teamwork。

ftw.raven受GNU通用公共许可证，版本2的许可。

变更日志