2012-06-25 10:39:28 +02:00
|
|
|
"""
|
|
|
|
raven.contrib.tornado
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
:copyright: (c) 2012 by the Sentry Team, see AUTHORS for more details
|
|
|
|
:license: BSD, see LICENSE for more details
|
|
|
|
"""
|
|
|
|
from __future__ import absolute_import
|
|
|
|
|
|
|
|
import time
|
|
|
|
|
|
|
|
import raven
|
|
|
|
from raven.base import Client
|
|
|
|
from raven.utils import get_auth_header
|
|
|
|
from tornado.httpclient import AsyncHTTPClient, HTTPError
|
|
|
|
|
|
|
|
|
|
|
|
class AsyncSentryClient(Client):
|
|
|
|
"""A mixin class that could be used along with request handlers to
|
|
|
|
asynchronously send errors to sentry. The client also captures the
|
|
|
|
information from the request handlers
|
|
|
|
"""
|
2013-12-27 20:07:17 +01:00
|
|
|
def __init__(self, *args, **kwargs):
|
2013-12-28 10:11:00 +01:00
|
|
|
self.validate_cert = kwargs.pop('validate_cert', True)
|
|
|
|
super(AsyncSentryClient, self).__init__(*args, **kwargs)
|
|
|
|
|
2012-06-25 10:39:28 +02:00
|
|
|
def capture(self, *args, **kwargs):
|
|
|
|
"""
|
|
|
|
Takes the same arguments as the super function in :py:class:`Client`
|
|
|
|
and extracts the keyword argument callback which will be called on
|
|
|
|
asynchronous sending of the request
|
|
|
|
|
|
|
|
:return: a 32-length string identifying this event and checksum
|
|
|
|
"""
|
2012-12-20 05:46:30 +01:00
|
|
|
if not self.is_enabled():
|
|
|
|
return
|
|
|
|
|
2012-06-25 10:39:28 +02:00
|
|
|
data = self.build_msg(*args, **kwargs)
|
|
|
|
|
|
|
|
self.send(callback=kwargs.get('callback', None), **data)
|
|
|
|
|
2013-04-04 08:20:51 +02:00
|
|
|
return (data['event_id'],)
|
2012-06-25 10:39:28 +02:00
|
|
|
|
2012-12-20 05:46:30 +01:00
|
|
|
def send(self, auth_header=None, callback=None, **data):
|
2012-06-25 10:39:28 +02:00
|
|
|
"""
|
|
|
|
Serializes the message and passes the payload onto ``send_encoded``.
|
|
|
|
"""
|
|
|
|
message = self.encode(data)
|
|
|
|
|
2012-12-20 05:46:30 +01:00
|
|
|
return self.send_encoded(message, auth_header=auth_header, callback=callback)
|
2012-06-25 10:39:28 +02:00
|
|
|
|
2012-12-20 05:46:30 +01:00
|
|
|
def send_encoded(self, message, auth_header=None, **kwargs):
|
2012-06-25 10:39:28 +02:00
|
|
|
"""
|
|
|
|
Given an already serialized message, signs the message and passes the
|
|
|
|
payload off to ``send_remote`` for each server specified in the servers
|
|
|
|
configuration.
|
|
|
|
|
|
|
|
callback can be specified as a keyword argument
|
|
|
|
"""
|
|
|
|
if not auth_header:
|
|
|
|
timestamp = time.time()
|
|
|
|
auth_header = get_auth_header(
|
|
|
|
protocol=self.protocol_version,
|
|
|
|
timestamp=timestamp,
|
|
|
|
client='raven-python/%s' % (raven.VERSION,),
|
2012-12-20 05:46:30 +01:00
|
|
|
api_key=self.public_key,
|
|
|
|
api_secret=self.secret_key,
|
2012-06-25 10:39:28 +02:00
|
|
|
)
|
|
|
|
|
|
|
|
for url in self.servers:
|
|
|
|
headers = {
|
|
|
|
'X-Sentry-Auth': auth_header,
|
|
|
|
'Content-Type': 'application/octet-stream',
|
|
|
|
}
|
|
|
|
|
|
|
|
self.send_remote(
|
|
|
|
url=url, data=message, headers=headers,
|
|
|
|
callback=kwargs.get('callback', None)
|
|
|
|
)
|
|
|
|
|
2014-02-02 03:58:16 +01:00
|
|
|
def send_remote(self, url, data, headers=None, callback=None):
|
|
|
|
if headers is None:
|
|
|
|
headers = {}
|
|
|
|
|
2012-06-25 10:39:28 +02:00
|
|
|
if not self.state.should_try():
|
|
|
|
message = self._get_log_message(data)
|
|
|
|
self.error_logger.error(message)
|
|
|
|
return
|
|
|
|
|
|
|
|
try:
|
|
|
|
self._send_remote(
|
|
|
|
url=url, data=data, headers=headers, callback=callback
|
|
|
|
)
|
2013-03-17 09:11:26 +01:00
|
|
|
except HTTPError as e:
|
2012-06-25 10:39:28 +02:00
|
|
|
body = e.response.body
|
|
|
|
self.error_logger.error(
|
|
|
|
'Unable to reach Sentry log server: %s '
|
|
|
|
'(url: %%s, body: %%s)' % (e,),
|
|
|
|
url, body, exc_info=True,
|
|
|
|
extra={'data': {'body': body, 'remote_url': url}}
|
|
|
|
)
|
2013-03-17 09:11:26 +01:00
|
|
|
except Exception as e:
|
2012-06-25 10:39:28 +02:00
|
|
|
self.error_logger.error(
|
|
|
|
'Unable to reach Sentry log server: %s (url: %%s)' % (e,),
|
|
|
|
url, exc_info=True, extra={'data': {'remote_url': url}}
|
|
|
|
)
|
|
|
|
message = self._get_log_message(data)
|
|
|
|
self.error_logger.error('Failed to submit message: %r', message)
|
|
|
|
self.state.set_fail()
|
|
|
|
else:
|
|
|
|
self.state.set_success()
|
2013-12-28 10:11:00 +01:00
|
|
|
|
2012-06-25 10:39:28 +02:00
|
|
|
def _send_remote(self, url, data, headers=None, callback=None):
|
|
|
|
"""
|
|
|
|
Initialise a Tornado AsyncClient and send the reuqest to the sentry
|
|
|
|
server. If the callback is a callable, it will be called with the
|
|
|
|
response.
|
|
|
|
"""
|
|
|
|
if headers is None:
|
|
|
|
headers = {}
|
|
|
|
|
|
|
|
return AsyncHTTPClient().fetch(
|
2013-12-27 20:07:17 +01:00
|
|
|
url, callback, method="POST", body=data, headers=headers,
|
2013-12-28 10:11:00 +01:00
|
|
|
validate_cert=self.validate_cert
|
2012-06-25 10:39:28 +02:00
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
class SentryMixin(object):
|
|
|
|
"""
|
|
|
|
A mixin class that extracts information from the Request in a Request
|
|
|
|
Handler to capture and send to sentry. This mixin class is designed to be
|
|
|
|
used along with `tornado.web.RequestHandler`
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
:emphasize-lines: 6
|
|
|
|
|
|
|
|
class MyRequestHandler(SentryMixin, tornado.web.RequestHandler):
|
|
|
|
def get(self):
|
|
|
|
try:
|
|
|
|
fail()
|
2013-03-17 09:11:26 +01:00
|
|
|
except Exception as e:
|
2013-05-06 09:57:29 +02:00
|
|
|
self.captureException()
|
2012-06-25 10:39:28 +02:00
|
|
|
|
|
|
|
|
|
|
|
While the above example would result in sequential execution, an example
|
|
|
|
for asynchronous use would be
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
:emphasize-lines: 6
|
|
|
|
|
|
|
|
class MyRequestHandler(SentryMixin, tornado.web.RequestHandler):
|
|
|
|
|
|
|
|
@tornado.web.asynchronous
|
|
|
|
@tornado.gen.engine
|
|
|
|
def get(self):
|
|
|
|
# Do something and record a message in sentry
|
|
|
|
response = yield tornado.gen.Task(
|
|
|
|
self.captureMessage, "Did something really important"
|
|
|
|
)
|
|
|
|
self.write("Your request to do something important is done")
|
|
|
|
self.finish()
|
|
|
|
|
|
|
|
|
|
|
|
The mixin assumes that the application will have an attribute called
|
|
|
|
`sentry_client`, which should be an instance of
|
|
|
|
:py:class:`AsyncSentryClient`. This can be changed by implementing your
|
|
|
|
own get_sentry_client method on your request handler.
|
|
|
|
"""
|
|
|
|
|
|
|
|
def get_sentry_client(self):
|
|
|
|
"""
|
|
|
|
Returns the sentry client configured in the application. If you need
|
|
|
|
to change the behaviour to do something else to get the client, then
|
|
|
|
subclass this method
|
|
|
|
"""
|
|
|
|
return self.application.sentry_client
|
|
|
|
|
|
|
|
def get_sentry_data_from_request(self):
|
|
|
|
"""
|
|
|
|
Extracts the data required for 'sentry.interfaces.Http' from the
|
|
|
|
current request being handled by the request handler
|
|
|
|
|
|
|
|
:param return: A dictionary.
|
|
|
|
"""
|
|
|
|
return {
|
2014-05-20 21:02:18 +02:00
|
|
|
'request': {
|
2012-11-23 22:08:49 +01:00
|
|
|
'url': self.request.full_url(),
|
2012-06-25 10:39:28 +02:00
|
|
|
'method': self.request.method,
|
2013-08-21 14:31:50 +02:00
|
|
|
'data': self.request.body,
|
2012-06-25 10:39:28 +02:00
|
|
|
'query_string': self.request.query,
|
|
|
|
'cookies': self.request.headers.get('Cookie', None),
|
|
|
|
'headers': dict(self.request.headers),
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
def get_sentry_user_info(self):
|
|
|
|
"""
|
|
|
|
Data for sentry.interfaces.User
|
|
|
|
|
|
|
|
Default implementation only sends `is_authenticated` by checking if
|
|
|
|
`tornado.web.RequestHandler.get_current_user` tests postitively for on
|
|
|
|
Truth calue testing
|
|
|
|
"""
|
|
|
|
return {
|
2014-05-20 21:02:18 +02:00
|
|
|
'user': {
|
2012-06-25 10:39:28 +02:00
|
|
|
'is_authenticated': True if self.get_current_user() else False
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
def get_sentry_extra_info(self):
|
|
|
|
"""
|
|
|
|
Subclass and implement this method if you need to send any extra
|
|
|
|
information
|
|
|
|
"""
|
|
|
|
return {
|
|
|
|
'extra': {
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2012-12-26 22:30:54 +01:00
|
|
|
def get_default_context(self):
|
|
|
|
data = {}
|
2012-06-25 10:39:28 +02:00
|
|
|
|
|
|
|
# Update request data
|
|
|
|
data.update(self.get_sentry_data_from_request())
|
|
|
|
|
|
|
|
# update user data
|
|
|
|
data.update(self.get_sentry_user_info())
|
|
|
|
|
|
|
|
# Update extra data
|
|
|
|
data.update(self.get_sentry_extra_info())
|
|
|
|
|
2012-12-26 22:30:54 +01:00
|
|
|
return data
|
|
|
|
|
|
|
|
def _capture(self, call_name, data=None, **kwargs):
|
|
|
|
if data is None:
|
|
|
|
data = self.get_default_context()
|
|
|
|
else:
|
2013-01-07 15:39:52 +01:00
|
|
|
default_context = self.get_default_context()
|
|
|
|
if isinstance(data, dict):
|
|
|
|
default_context.update(data)
|
|
|
|
else:
|
|
|
|
default_context['extra']['extra_data'] = data
|
|
|
|
data = default_context
|
2012-12-26 22:30:54 +01:00
|
|
|
|
2012-06-25 10:39:28 +02:00
|
|
|
client = self.get_sentry_client()
|
2012-12-26 22:30:54 +01:00
|
|
|
|
|
|
|
return getattr(client, call_name)(data=data, **kwargs)
|
2012-06-25 10:39:28 +02:00
|
|
|
|
|
|
|
def captureException(self, exc_info=None, **kwargs):
|
2012-12-26 22:30:54 +01:00
|
|
|
return self._capture('captureException', exc_info=exc_info, **kwargs)
|
2012-06-25 10:39:28 +02:00
|
|
|
|
|
|
|
def captureMessage(self, message, **kwargs):
|
2012-12-26 22:30:54 +01:00
|
|
|
return self._capture('captureMessage', message=message, **kwargs)
|
2012-06-25 10:39:28 +02:00
|
|
|
|
2013-06-04 07:24:37 +02:00
|
|
|
def log_exception(self, typ, value, tb):
|
2012-06-25 10:39:28 +02:00
|
|
|
"""Override implementation to report all exceptions to sentry.
|
2013-06-04 07:24:37 +02:00
|
|
|
log_exception() is added in Tornado v3.1.
|
2012-06-25 10:39:28 +02:00
|
|
|
"""
|
2013-06-04 07:24:37 +02:00
|
|
|
rv = super(SentryMixin, self).log_exception(typ, value, tb)
|
|
|
|
self.captureException(exc_info=(typ, value, tb))
|
2012-06-25 10:39:28 +02:00
|
|
|
return rv
|
2013-06-04 07:24:37 +02:00
|
|
|
|
|
|
|
def send_error(self, status_code=500, **kwargs):
|
|
|
|
"""Override implementation to report all exceptions to sentry, even
|
|
|
|
after self.flush() or self.finish() is called, for pre-v3.1 Tornado.
|
|
|
|
"""
|
|
|
|
if hasattr(super(SentryMixin, self), 'log_exception'):
|
|
|
|
return super(SentryMixin, self).send_error(status_code, **kwargs)
|
|
|
|
else:
|
|
|
|
rv = super(SentryMixin, self).send_error(status_code, **kwargs)
|
2013-08-29 07:48:53 +02:00
|
|
|
if 500 <= status_code <= 599:
|
2013-08-29 07:26:39 +02:00
|
|
|
self.captureException(exc_info=kwargs.get('exc_info'))
|
2013-06-04 07:24:37 +02:00
|
|
|
return rv
|