错误/异常收集器和报告器
zilch的Python项目详细描述
自言自语
zilch是一个小库,用于记录和查看来自python的异常。 这个库的灵感来自(并使用了来自的几个相同的函数) david cramer的Sentry,但目标是在 代码/功能占用空间更小。
基本用法
报告异常
在要报告错误的应用程序中,导入zilch并配置
直接记录到数据库的报告者:
from zilch.store import SQLAlchemyStore
import zilch.client
zilch.client.store = SQLAlchemyStore('sqlite:///exceptions.db')
然后报告异常:
from zilch.client import capture_exception
try:
# do something that explodes
except Exception, e:
capture_exception()
然后,该错误将记录在数据库中,以便以后查看。
高级使用
在更大的集群场景中,或者在延迟很重要的情况下,报告 异常可以传递给ZeroMQ以记录到中心 网络录音机。客户机和录音机都必须 ZeroMQ已安装。
设置要录制的客户端:
import zilch.client zilch.client.recorder_host = "tcp://localhost:5555"
然后报告异常:
from zilch.client import capture_exception try: # do something that explodes except Exception, e: capture_exception()
异常将被发送到 recorder_host已指定。
集中记录异常
记录器使用ZeroMQ来记录通过 网络要运行录制主机,请在录制它们的计算机上运行:
>> zilch-recorder tcp://localhost:5555 sqlite:///exceptions.db
如果不运行Recorder,则ZeroMQ将保留消息直到它 有空。在那之后,它将开始阻塞(在未来, 将添加选项以配置邮件的磁盘卸载)。
录像机将在初次发射时创建所需的表格。
查看记录的异常
zilch附带一个Pyramidweb应用程序,用于查看 记录的异常。一旦安装了Pyramid和WebHelpers,就可以 键入:
>> zilch-web sqlite:///exceptions.db
其他Web配置参数可用于指定 Web应用程序应绑定到的主机/端口(可通过运行 zilch-web和-h选项)。
许可证
zilch根据麻省理工学院的许可证提供。