All notable changes to this project will be documented in this file. Project adheres to Semantic Versioning.
- [Core] Fixed stackframes in some situations being in inverse order.
- [Flask] Fix wrong exception handling logic (accidentally relied on Flask internals).
- [Core] No longer send NaN local vars as non-standard JSON.
- [Core] Switched from culprit to transaction for automatic transaction reporting.
- [CI] Removed py3.3 from build
- [Django] resolved an issue where the log integration would override the user.
- [Core] Fixed DSNs without secrets not sending events.
- [Core] Added lazy import for pkg_resources
- [Core] Added NamedTuple Serializer
- [Sanic] Fixed sanic integration dependencies
- [Django] Fixed sql hook bug
- [Sanic] Added support for sanic.
- [Core] Disabled dill logger by default
- [Core] Added
SENTRY_NAME
,SENTRY_ENVIRONMENT
andSENTRY_RELEASE
environment variables - [Core] DSN secret is now optional
- [Core] Added fix for cases with exceptions in repr
- [core] Fixed bug with mutating
record.data
- [Core] Add trimming to breadcrumbs.
- [Core] Improve host message at startup.
- [Core] Update pytest to work on other environments
- [Core] Fixed missing deprecation on
processors.SanitizePasswordsProcessor
- [Core] Improve exception handling in
Serializer.transform
- [Core] Fixed
celery.register_logger_signal
ignoring subclasses - [Core] Fixed sanitizer skipping
byte
instances - [Lambda] Fixed
AttributeError
whenrequestContext
not present
- [Core] Support for defining
sanitized_keys
on the client (pr/990) - [Django] Support for Django 2.0 Urlresolver
- [Docs] Several fixes and improvements
- [Core] Changed default timeout on http calls to 5 seconds
- [Core] Fixed relative paths for traces generated on Windows
- [Django] Fixed import issues for Django projects < 1.7
- [Django] Fixed django management command data option
- [Django/DRF] Added
application/octet-stream
to non-cacheable types in middleware - [Django] Added parsing X-Forwarded-For for
user.ip_address
- [Flask] Added
request.remote_addr
as fallback for ip addresses - [Lambda] Added initial AWS Lambda support with
contrib.awslambda.LambdaClient
- [Core] Fixed requirements in setup.py
- [Core]
get_frame_locals
properly usingmax_var_size
- [Core] Fixed raven initialization when
logging._srcfile
is None - [Core] Fixed import locking to avoid recursion
- [Django] Fixed several issues for Django 1.11 and Django 2.0
- [Django/DRF] Fixed issue with unavailable request data
- [Flask] Added app.logger instrumentation
- [Flask] Added signal on setup_logging
- [ZConfig] Added standalone ZConfig support
- [Celery] Fixed several issues related to Celery
- Support both string and class values for
ignore_exceptions
parameters. Class values also support child exceptions. - Ensure consistent fingerprint for SoftTimeLimitExceeded exceptions
- Add sample_rate configuration
- fix registration of hooks for Django
- Strip whitespace from DSNs automatically.
- Add
last_event_id
accessor toClient
. - Do not require
sys.argv
to be available any more. - Tags defined on a logging handler will now be merged with individual log record's tags.
- Added explicit support for multidicts in the django client.
- Refactored transports to support multiple URLs. This might affect
you if you have custom subclasses of those. The main change is that
the URL parameter moved from the constructor into the
send
method. - Corrected an issue with recursive route resolvers which commonly affected things like django-tastyepie.
- Corrected an issue where Django's HTTP request was not always available within events.
- Made raven python breadcrumb patches work when librato monkey patches logging.
- Improved fix for the Django middleware regression.
- Keep the original type for the django middleware settings if we change them.
- Added
register_logging_handler
. - Removed bad mixin from django's WSGI middleware
- Removed "support for extracing data from rest_framework" because this broke code.
- Corrected an issue that caused
close()
on WSGI iterables to not be correctly called. - Fixes the new Django 1.10
MIDDLEWARE_CLASSES
warning.
- Bugfix for transaction based culprits.
- Added support for extracting data from rest_framework in Django integration
- Updated CA bundle.
- Added transaction-based culprits for Celery, Django, and Flask.
- Fixed an issue where
ignore_exceptions
wasn't respected.
- Fixed potential concurrency issue with event IDs in the Flask integration.
- Added a workaround for leakage when broken WSGI middlware or servers are
used that do not call
close()
on the iterat.r
- Added various improvements for the WSGI and Django support.
- Prevent chained exception recursion
- In environments which look like AWS Lambda or Google App Engine utilize the synchronous transport.
- Added Celery config option to ignore expected exceptions
- Improved DSN handling in Flask client.
- Added support for Django 1.10.
- Added support for chained exceptions in Python 3.
- Fixed various behavior with handling template errors in Django 1.8+.
- Sentry failures now no longer log the failure data in the error message.
- Fixed template reporting not working for certain versions of Django.
- Add formatted attribute to message events
- Fill in empty filename if django fails to give one for template information on newer Django versions with disabled debug mode.
- fixed an error that could cause certain SQL queries to fail to record as breadcrumbs if no parameters were supplied.
- remove duration from SQL query breadcrumbs. This was not rendered in the UI and will come back in future versions of Sentry with a different interface.
- resolved a bug that caused crumbs to be recorded incorrectly.
- Breadcrumbs are now attempted to be deduplicated to catch some common cases where log messages just spam up the breadcrumbs.
- Improvements to the public breadcrumbs API and stabilized some.
- Automatically activate the context on calls to
merge
- if breadcrumbs fail to process due to an error they are now skipped.
- exc_info is no longer included in logger based breadcrumbs.
- log the entire logger name as category.
- added a
enable_breadcrumbs
flag to the client to allow the enabling or disabling of breadcrumbs quickly. - corrected an issue where python interpreters with bytecode writing enabled would report incorrect logging locations when breadcrumb patching for logging was enabled.
- Improve thread binding for the context. This makes the main thread never deactivate the client automatically on clear which means that more code should automatically support breadcrumbs without changes.
- Added support for reading git sha's from packed references.
- Detect disabled thread support for uwsgi.
- Added preliminary support for breadcrumbs.
Note: this version adds breadcrumbs to events. This means that if you run a Sentry version older than 8.5 you will see some warnings in the UI. Consider using an older version of the client if you do not want to see it.
- Resolved an issue where Raven would fail with an exception if the package name did not match the setuptools name in some isolated cases.
- Empty and otherwise falsy (None, False, 0) DSN values are now assumed to be equivalent to no DSN being provided.
- Added a workaround for back traceback objects passed to raven. In these cases we now wobble further along to at least log something.
- The raven client supports the stacktrace to be absent. This improves support with celery and multiprocessing.
Client.configure_logging
has been removed, and handlers will not automatically be added to 'sentry' and 'raven' namespaces.- Improved double error check
- Restored support for exc_info is True.
- Remember exceptions in flight until the context is cleared so that two reports with the same exception data do not result in two errors being logged.
- Allow logging exclusions.
- Fixed a problem where bytes as keys in dictionaries caused problems on data sanitization if those bytes were outside of the ASCII range.
- Django client no longer requires the user object to be a subclass of the base model.
- Corrected an issue with the Django log handler which would cause a recursive import.
- Restore template debug support for Django 1.9 and newer.
- Correctly handle SSL verification disabling for newer Python versions.
- Correct behavior introduced for Django 1.9.
- Support for isolated apps in Django 1.9.
- The threaded worker will now correctly handle forking.
- The 'environment' parameter is now supported (requires a Sentry 8.0 server ).
- 'tags' can now be specified as part of a LoggingHandler's constructor.
- Added support for detecting
release
on Heroku. - pkg_resources is now prioritized for default version detection.
- Updated
in_app
support to include exception frames. - Fixed support for
SENTRY_USER_ATTRS
in Flask. - Handle DSNs which are sent as unicode values in Python 2.
- Handle passing
fingerprint
through logging handler.
- Correctly handle SHAs in .git/HEAD.
- Fixed several cases of invalid Python3 syntax.
- Reverted changes to Celery which incorrectly caused some configurations to log unwanted messages.
- Improved behavior in
fetch_git_sha
. - Removed
is_authenticated
property from most integrations. - Better error handling for errors within Flask context.
- Support for new versions of Flask-Login.
- Update Tornado support for modern versions.
- Update stacktrace truncation code to match current versions of Sentry server.
- Content is no longer base64-encoded.
fingerprint
is now correctly supported.- Django: 1.9 compatibility.
- Celery: Filter
celery.redirect
logger.
- Added
sys.excepthook
handler (installed by default). - Fixed an issue where
wrap_wsgi
wasn't being respected. - Various deprecated code removed.
- Enforce string-type imports.
- Python 3 compatibility fixes.
- Remove scheme checking on transports.
- Added
SENTRY_TRANSPORT
to Flask and Django configurations.
- Fixed packaging of 5.4.0 which erronously kept the
aiohttp.py
file in the wheel only.
- Binding transports via a scheme prefix on DSNs is now deprecated.
raven.conf.load
has been removed.- Upstream-related configuration (such as url, project_id, and keys) is now contained in
RemoteConfig
attached toClient.remote
- The
aiohttp
transport has been moved toraven-aiohttp
package.
- Restored support for patching Django's BaseCommand.execute.
- The UDP transport has been removed.
- The integrated Sentry+Django client has been removed. This is now part of Sentry core.
- Server configuration must now be specified with a DSN.
- Upstream errors now have increased verbosity in logs.
- Unsent events now log to 'sentry.errors.uncaught'.
- Django management commands should now effectively autopatch (when run from the CLI).
- Flask wrapper now includes user_context, tags_context, and extra_context helpers.
- Python version is now reported with modules.
- Protocol version is now 6 (requires Sentry 7.0 or newer).
- Added
release
option to Client. - Added
fetch_git_sha
helper. - Added
fetch_package_version
helper. - Added cookie string sanitizing.
- Added threaded request transport: "threaded+requests+http(s)".
- Added aiohttp transport.
- Corrected behavior with auto_log_stacks and exceptions.
- Add support for certifi.
- Expanded Flask support.
- Expanded Django support.
- Corrected an issue where processors were not correctly applying.
- Sentry client protocol is now version 5.
- Various improvements to threaded transport.
- SSL verification is now on by default.
- Rate limits and other valid API errors are now handled more gracefully.
- Added
last_event_id
andX-Sentry-ID
header to Flask.
- Added verify_ssl option to HTTP transport (defaults to False).
- Added capture_locals option (defaults to True).
- message can now be passed to capture* functions.
- Django <1.4 is no longer supported.
- Function object serialization has been improved.
- SanitizePasswordsProcessor removes API keys.
- Sentry client protocol is now version 4.
This changelog does not attempt to account for all changes between 3.6.0 and 3.0.0, but rather focuses on recent important changes
- Transport modules paths have been refactored.
- The threaded transport is now the default.
- Client.context has changed. Please see documentation for new API.
- Client.user_context was added.
- Client.http_context was added.
- Client.extra_context was added.
- Client.tags_context was added.
- Flask support has been greatly improved.
- raven.contrib.celery.Client has been removed as it was invalid.
3.0 of Raven requires a Sentry server running at least version 5.1, as it implements version 3 of the protocol.
Support includes:
- Sending 'python' as the platform.
- The 'tags' option (on all constructors that support options).
- Updated authentication header.
Additionally, the following has changed:
- Configuring the client with an empty DSN value will disable sending of messages.
- All clients should now check
Client.is_enabled()
to verify if they should send data. Client.create_from_text
andClient.create_from_exception
have been removed.Client.message
andClient.exception
have been removed.- The
key
setting has been removed. - The
DEBUG
setting in Django no longer disables Raven. - The
register_signals
option in RAVEN_CONFIG (Django) is no longer used. - A new helper,
Client.context()
is now available for scoping options. Client.captureExceptions
is now deprecated in favor ofClient.context
.- Credit card values will now be sanitized with the default processors.
- A new eventlet+http transport exists.
- A new threaded+http transport exists.
- PyPy is now supported.
- Django 1.5 should now be supported (experimental).
- Gevent 1.0 should now be supported (experimental).
- Python 2.5 is no longer supported.
- [Django] The
skip_sentry
attribute is no longer supported. A new option config option has replaced this:SENTRY_IGNORE_EXCEPTIONS
.
- New serializers exist (and can be registered) against Raven. See
raven.utils.serializer
for more information. - You can now pass
tags
to thecapture
method. This will require a Sentry server compatible with the new tags protocol. - A new gevent+http transport exists.
- A new tornado+http transport exists.
- A new twisted+http transport exists.
- Zope integration has been added. See docs for more information.
- PasteDeploy integration has been added. See docs for more information.
- A Django endpoint now exists for proxying requests to Sentry. See
raven.contrib.django.views
for more information.
- Signatures are no longer sent with messages. This requires the server version to be at least 4.4.6.
- Several fixes and additions were added to the Django report view.
long
types are now handled in transform().- Improved integration with Celery (and django-celery) for capturing errors.
- There is now a builtin view as part of the Django integration for sending events server-side
(from the client) to Sentry. The view is currently undocumented, but is available as
{% url raven-report %}
and will use your server side credentials. To use this view you'd simply swap out the servers configuration in raven-js and point it to the given URL. - A new middleware for ZeroRPC now exists.
- A new protocol for registering transports now exists.
- Corrected some behavior in the UDP transport.
- Celery signals are now connected by default within the Django integration.
- The password sanitizer will now attempt to sanitize key=value pairs within strings (such as the querystring).
- Two new santiziers were added: RemoveStackLocalsProcessor and RemovePostDataProcessor
-
Stacks must now be passed as a list of tuples (frame, lineno) rather than a list of frames. This includes calls to logging (extra={'stack': []}), as well as explicit client calls (capture(stack=[])).
This corrects some issues (mostly in tracebacks) with the wrong lineno being reported for a frame.
- Raven now tracks the state of the Sentry server. If it receives an error, it will slow down requests to the server (by passing them into a named logger, sentry.errors), and increasingly delay the next try with repeated failures, up to about a minute.
- gunicorn is now disabled in default logging configuration
- Moved exception and message methods to capture{Exception,Message}.
- Added captureQuery method.
- Corrected duplicate DSN behavior in Django client.
- Django can now be configured by setting SENTRY_DSN.
- Improve logging for send_remote failures (and correct issue created when send_encoded was introduced).
- Renamed SantizePassworsProcessor to SanitizePassworsProcessor.
- Support sending the culprit with logging messages as part of extra.
- Added client.exception and client.message shortcuts.
- Refactored client send API to be more easily extensible.
- MOAR TESTS!
- Gracefully handle exceptions in Django client when using integrated setup.
- Added Client.error_logger as a new logger instance that points to
sentry.errors
.
- Corrected behavior with raven logging errors to send_remote
which could potentially cause a very large backlog to Sentry
when it should just log to
sentry.errors
. - Ensure the
site
argument is sent to the server.
- Made DSN a first-class citizen throughout Raven.
- Added a Pylons-specific WSGI middleware.
- Improved the generic WSGI middleware to capture HTTP information.
- Improved logging and logbook handlers.
- Corrected logging stack behavior so that it doesnt capture raven+logging extensions are part of the frames.
- Remove logging attr magic.
- Correct encoding behavior on bool and float types.
- Fix 'request' attribute on Django logging.
- Corrected logging behavior with extra data to match pre 1.x behavior.
- Handle frames that are missing f_globals and f_locals.
- Stricter conversion of int and boolean values.
- Handle invalid sources for templates in Django.
- varmap was refactored to send keys back to callbacks.
- SanitizePasswordProcessor now handles http data.
- Renaming raven2 to raven as it causes too many issues.
- Corrected a bug in setup_logging.
- Raven now sends "sentry_version" header which is the expected server version.
- Handle more edge cases on stack iteration.
- Gracefully handle invalid f_locals.
- All datetimes are assumed to be utcnow() as of Sentry 2.0.0-RC5
- Now only works with Sentry>=2.0.0 server.
- Raven is now listed as raven2 on PyPi.
- raven.contrib.celery is now useable.
- raven.contrib.django.celery is now useable.
- Fixed a bug with request.raw_post_data buffering in Django.
- Servers would stop iterating after the first successful post which was not the intended behavior.
- You can now explicitly pass a list of frame objects to the process method.
- The default logging handler (SentryHandler) will now accept a set of kwargs to instantiate a new client with (GH-10).
- Fixed a bug with checksum generation when module or function were missing (GH-9).
- Added a Django-specific WSGI middleware.
- Two minor fixes for the Django client:
- Ensure the sentry key exists in data in (GH-8).
- properly set kwargs['data'] to an empty list when its a NoneType (GH-6).
- Require
servers
on base Client. - Added support for the
site
option in Client. - Moved raven.contrib.django.logging to raven.contrib.django.handlers.
- Fixed an infinite loop in iter_tb.
- Removed the
thrashed
key inrequest.sentry
for the Django integration. - Changed the logging handler to correctly inherit old-style classes (GH-1).
- Added a
client
argument toraven.contrib.django.models.get_client()
.
- auto_log_stacks now works with create_from_text
- added Client.get_ident
- Initial version of Raven (extracted from django-sentry 1.12.1).