然后我们安装对应语言的客户端,我用的是Python,则
pip install raven
raven
就是它的客户端,然后生成一个Client
的实例,用于上报重要信息
client = Client(http://82c130028fa942f29add1e0aa0ff9cbd:cffa174304d248b9aa2bdb385d3b01b8@127.0.0.1:9000/6)
之后,在需要进行上报信息的地方导入该实例即可,比如我在Scrapy
的下载中间件中,使用Sentry的代码如下
class ErrorTraceMiddleware(object):
def process_response(self, request, response, spider):
if response.status >= 400:
reason = 'error http code {} for {}'.format(response.status, request.url)
self._faillog(request, HttpError, reason, spider)
return response
def process_exception(self, request, exception, spider):
self._faillog(request, DownloadException, exception, spider)
return
def _faillog(self, request, exc, reason, spider):
if USE_SENTRY:
try:
raise exc
except Exception:
message = 'error occurs when downloading {}'.format(request.url)
client.captureException(message=message)
else:
print(reason)
如果同时需要跟踪页面解析错误的信息,那么需要实现一个SpiderMiddleware
,或者通过signals
来做,这里由于篇幅就不介绍了。
下面是在Haipproxy中关于使用Sentry的一些Bug Trace相关信息
haipproxy errors
也有详细的错误信息
details可见还是非常直观的
def parse_decorator(return_value):
def page_parse(func):
@wraps(func)
def handle_error(*keys):
try:
return func(*keys)
except Exception as e:
client.captureException()
return return_value
return handle_error
return page_parse
使用sentry,我们主要调用的就是client.captureException()
方法,它在except
作用域中,用于收集错误堆栈,为了便于复现或者调试错误,有的时候,我们可能需要附加除了错误堆栈之外的一些其它信息,这时候可以用message
这个参数。它可以传递一些额外的信息,这样更加方便跟踪错误。
还有一个client.captureMessage()
方法,它的主要作用在于上报一些重要信息而非错误堆栈。
目前只是对其的一些简单使用,后续还会加深了解,比如多团队多用户协作,与其它项目管理软件进行集成(如Gitlab
),如何做高可用等