releases.shpreview
Sentry/Sentry Python

Sentry Python

$npx -y @buildinternet/releases show sentry-python
Mon
Wed
Fri
AprMayJunJulAugSepOctNovDecJanFebMarApr
Less
More
Releases18Avg6/moVersionsv2.50.0 → v2.57.0
Apr 3, 2024

New Features

  • Additional integrations will now be activated automatically if the SDK detects the respective package is installed: Ariadne, ARQ, asyncpg, Chalice, clickhouse-driver, GQL, Graphene, huey, Loguru, PyMongo, Quart, Starlite, Strawberry.
  • Added new API for custom instrumentation: new_scope, isolation_scope. See the Deprecated section to see how they map to the existing APIs.

Changed

  • The Pyramid integration will not capture errors that might happen in authenticated_userid() in a custom AuthenticationPolicy class.

  • The method need_code_loation of the MetricsAggregator was renamed to need_code_location.

  • The BackgroundWorker thread used to process events was renamed from raven-sentry.BackgroundWorker to sentry-sdk.BackgroundWorker.

  • The reraise function was moved from sentry_sdk._compat to sentry_sdk.utils.

  • The _ScopeManager was moved from sentry_sdk.hub to sentry_sdk.scope.

  • Moved the contents of tracing_utils_py3.py to tracing_utils.py. The start_child_span_decorator is now in sentry_sdk.tracing_utils.

  • The actual implementation of get_current_span was moved to sentry_sdk.tracing_utils. sentry_sdk.get_current_span is still accessible as part of the top-level API.

  • sentry_sdk.tracing_utils.add_query_source(): Removed the hub parameter. It is not necessary anymore.

  • sentry_sdk.tracing_utils.record_sql_queries(): Removed the hub parameter. It is not necessary anymore.

  • sentry_sdk.tracing_utils.get_current_span() does now take a scope instead of a hub as parameter.

  • sentry_sdk.tracing_utils.should_propagate_trace() now takes a Client instead of a Hub as first parameter.

  • sentry_sdk.utils.is_sentry_url() now takes a Client instead of a Hub as first parameter.

  • sentry_sdk.utils._get_contextvars does not return a tuple with three values, but a tuple with two values. The copy_context was removed.

  • If you create a transaction manually and later mutate the transaction in a configure_scope block this does not work anymore. Here is a recipe on how to change your code to make it work: Your existing implementation:

    transaction = sentry_sdk.transaction(...)
    
    # later in the code execution:
    
    with sentry_sdk.configure_scope() as scope:
        scope.set_transaction_name("new-transaction-name")
    

    needs to be changed to this:

    transaction = sentry_sdk.transaction(...)
    
    # later in the code execution:
    
    scope = sentry_sdk.Scope.get_current_scope()
    scope.set_transaction_name("new-transaction-name")
    
  • The classes listed in the table below are now abstract base classes. Therefore, they can no longer be instantiated. Subclasses can only be instantiated if they implement all of the abstract methods.

    <details> <summary><b>Show table</b></summary>
    ClassAbstract methods
    sentry_sdk.integrations.Integrationsetup_once
    sentry_sdk.metrics.Metricadd, serialize_value, and weight
    sentry_sdk.profiler.Schedulersetup and teardown
    sentry_sdk.transport.Transportcapture_envelope
    </details>

Removed

  • Removed support for Python 2 and Python 3.5. The SDK now requires at least Python 3.6.
  • Removed support for Celery 3.*.
  • Removed support for Django 1.8, 1.9, 1.10.
  • Removed support for Flask 0.*.
  • Removed support for gRPC < 1.39.
  • Removed support for Tornado < 6.
  • Removed last_event_id() top level API. The last event ID is still returned by capture_event(), capture_exception() and capture_message() but the top level API sentry_sdk.last_event_id() has been removed.
  • Removed support for sending events to the /store endpoint. Everything is now sent to the /envelope endpoint. If you're on SaaS you don't have to worry about this, but if you're running Sentry yourself you'll need version 20.6.0 or higher of self-hosted Sentry.
  • The deprecated with_locals configuration option was removed. Use include_local_variables instead. See https://docs.sentry.io/platforms/python/configuration/options/#include-local-variables.
  • The deprecated request_bodies configuration option was removed. Use max_request_body_size. See https://docs.sentry.io/platforms/python/configuration/options/#max-request-body-size.
  • Removed support for user.segment. It was also removed from the trace header as well as from the dynamic sampling context.
  • Removed support for the install method for custom integrations. Please use setup_once instead.
  • Removed sentry_sdk.tracing.Span.new_span. Use sentry_sdk.tracing.Span.start_child instead.
  • Removed sentry_sdk.tracing.Transaction.new_span. Use sentry_sdk.tracing.Transaction.start_child instead.
  • Removed support for creating transactions via sentry_sdk.tracing.Span(transaction=...). To create a transaction, please use sentry_sdk.tracing.Transaction(name=...).
  • Removed sentry_sdk.utils.Auth.store_api_url.
  • sentry_sdk.utils.Auth.get_api_url's now accepts a sentry_sdk.consts.EndpointType enum instead of a string as its only parameter. We recommend omitting this argument when calling the function, since the parameter's default value is the only possible sentry_sdk.consts.EndpointType value. The parameter exists for future compatibility.
  • Removed tracing_utils_py2.py. The start_child_span_decorator is now in sentry_sdk.tracing_utils.
  • Removed the sentry_sdk.profiler.Scheduler.stop_profiling method. Any calls to this method can simply be removed, since this was a no-op method.

Deprecated

  • Using the Hub directly as well as using hub-based APIs has been deprecated. Where available, use the top-level API instead; otherwise use the scope API or the client API.

    Before:

    with hub.start_span(...):
        # do something
    

    After:

    import sentry_sdk
    
    with sentry_sdk.start_span(...):
        # do something
    
  • Hub cloning is deprecated.

    Before:

    with Hub(Hub.current) as hub:
        # do something with the cloned hub
    

    After:

    import sentry_sdk
    
    with sentry_sdk.isolation_scope() as scope:
        # do something with the forked scope
    
  • configure_scope is deprecated. Use the new isolation scope directly via Scope.get_isolation_scope() instead.

    Before:

    with configure_scope() as scope:
        # do something with `scope`
    

    After:

    from sentry_sdk.scope import Scope
    
    scope = Scope.get_isolation_scope()
    # do something with `scope`
    
  • push_scope is deprecated. Use the new new_scope context manager to fork the necessary scopes.

    Before:

    with push_scope() as scope:
        # do something with `scope`
    

    After:

    import sentry_sdk
    
    with sentry_sdk.new_scope() as scope:
        # do something with `scope`
    
  • Accessing the client via the hub has been deprecated. Use the top-level sentry_sdk.get_client() to get the current client.

  • profiler_mode and profiles_sample_rate have been deprecated as _experiments options. Use them as top level options instead:

    sentry_sdk.init(
        ...,
        profiler_mode="thread",
        profiles_sample_rate=1.0,
    )
    
  • Deprecated sentry_sdk.transport.Transport.capture_event. Please use sentry_sdk.transport.Transport.capture_envelope, instead.

  • Passing a function to sentry_sdk.init's transport keyword argument has been deprecated. If you wish to provide a custom transport, please pass a sentry_sdk.transport.Transport instance or a subclass.

  • The parameter propagate_hub in ThreadingIntegration() was deprecated and renamed to propagate_scope.

Mar 28, 2024

Various fixes & improvements

  • ref: Define types at runtime (#2914) by @szokeasaurusrex
  • Explicit reexport of types (#2866) (#2913) by @szokeasaurusrex
  • feat(profiling): Add thread data to spans (#2843) by @Zylphrex
Mar 21, 2024

Various fixes & improvements

  • Use new scopes API default integrations. (#2856) by @antonpirker
  • Use new scopes API in openai integration (#2853) by @antonpirker
  • Use new scopes API in Celery integration. (#2851) by @antonpirker
  • Use new scopes API in Django, SQLAlchemy, and asyncpg integration. (#2845) by @antonpirker
  • Use new scopes API in Redis (#2854) by @sentrivana
  • Use new scopes API in GQL Integration (#2838) by @szokeasaurusrex
  • Use new scopes API in LoggingIntegration (#2861, #2855) by @sentrivana
  • Use new scopes API in FastAPI integration (#2836) by @szokeasaurusrex
  • Use new scopes API in Ariadne (#2850) by @szokeasaurusrex
  • Add optional keep_alive (#2842) by @sentrivana
  • Add support for celery-redbeat cron tasks (#2643) by @kwigley
  • AWS Lambda: aws_event can be an empty list (#2849) by @sentrivana
  • GQL: Remove problematic tests (#2835) by @szokeasaurusrex
  • Moved should_send_default_pii into client (#2840) by @antonpirker
  • should_send_default_pii shortcut (#2844) by @szokeasaurusrex
  • Use scope.should_send_default_pii in FastAPI integration (#2846) by @szokeasaurusrex
  • Patched functions decorator for integrations (#2454) by @szokeasaurusrex
  • Small APIdocs improvement (#2828) by @antonpirker
  • Bump checkouts/data-schemas from ed078ed to 8232f17 (#2832) by @dependabot
  • Update CHANGELOG.md (970c5779) by @sentrivana
  • Updated migration guide (#2859) by @antonpirker

Plus 2 more

Mar 20, 2024

Various fixes & improvements

  • Add optional keep_alive (#2842) by @sentrivana

    If you're experiencing frequent network issues between the SDK and Sentry, you can try turning on TCP keep-alive:

    import sentry_sdk
    
    sentry_sdk.init(
        # ...your usual settings...
        keep_alive=True,
    )
    
  • Add support for Celery Redbeat cron tasks (#2643) by @kwigley

    The SDK now supports the Redbeat scheduler in addition to the default Celery Beat scheduler for auto instrumenting crons. See the docs for more information about how to set this up.

  • aws_event can be an empty list (#2849) by @sentrivana

  • Re-export Event in types.py (#2829) by @szokeasaurusrex

  • Small API docs improvement (#2828) by @antonpirker

  • Fixed OpenAI tests (#2834) by @antonpirker

  • Bump checkouts/data-schemas from ed078ed to 8232f17 (#2832) by @dependabot

Mar 13, 2024

New Features

  • Additional integrations will now be activated automatically if the SDK detects the respective package is installed: Ariadne, ARQ, asyncpg, Chalice, clickhouse-driver, GQL, Graphene, huey, Loguru, PyMongo, Quart, Starlite, Strawberry.

Changed

  • The Pyramid integration will not capture errors that might happen in authenticated_userid() in a custom AuthenticationPolicy class.

  • The method need_code_loation of the MetricsAggregator was renamed to need_code_location.

  • The BackgroundWorker thread used to process events was renamed from raven-sentry.BackgroundWorker to sentry-sdk.BackgroundWorker.

  • The reraise function was moved from sentry_sdk._compat to sentry_sdk.utils.

  • The _ScopeManager was moved from sentry_sdk.hub to sentry_sdk.scope.

  • Moved the contents of tracing_utils_py3.py to tracing_utils.py. The start_child_span_decorator is now in sentry_sdk.tracing_utils.

  • The actual implementation of get_current_span was moved to sentry_sdk.tracing_utils. sentry_sdk.get_current_span is still accessible as part of the top-level API.

  • sentry_sdk.tracing_utils.get_current_span() does now take a scope instead of a hub as parameter.

  • sentry_sdk.utils._get_contextvars does not return a tuple with three values, but a tuple with two values. The copy_context was removed.

  • If you create a transaction manually and later mutate the transaction in a configure_scope block this does not work anymore. Here is a recipe on how to change your code to make it work: Your existing implementation:

    transaction = sentry_sdk.transaction(...)
    
    # later in the code execution:
    
    with sentry_sdk.configure_scope() as scope:
        scope.set_transaction_name("new-transaction-name")
    

    needs to be changed to this:

    transaction = sentry_sdk.transaction(...)
    
    # later in the code execution:
    
    scope = sentry_sdk.Scope.get_current_scope()
    scope.set_transaction_name("new-transaction-name")
    
  • The classes listed in the table below are now abstract base classes. Therefore, they can no longer be instantiated. Subclasses can only be instantiated if they implement all of the abstract methods.

    <details> <summary><b>Show table</b></summary>
    ClassAbstract methods
    sentry_sdk.integrations.Integrationsetup_once
    sentry_sdk.metrics.Metricadd, serialize_value, and weight
    sentry_sdk.profiler.Schedulersetup and teardown
    sentry_sdk.transport.Transportcapture_envelope
    </details>

Removed

  • Removed support for Python 2 and Python 3.5. The SDK now requires at least Python 3.6.
  • Removed support for Celery 3.*.
  • Removed support for Django 1.8, 1.9, 1.10.
  • Removed support for Flask 0.*.
  • Removed support for gRPC < 1.39.
  • Removed last_event_id() top level API. The last event ID is still returned by capture_event(), capture_exception() and capture_message() but the top level API sentry_sdk.last_event_id() has been removed.
  • Removed support for sending events to the /store endpoint. Everything is now sent to the /envelope endpoint. If you're on SaaS you don't have to worry about this, but if you're running Sentry yourself you'll need version 20.6.0 or higher of self-hosted Sentry.
  • The deprecated with_locals configuration option was removed. Use include_local_variables instead. See https://docs.sentry.io/platforms/python/configuration/options/#include-local-variables.
  • The deprecated request_bodies configuration option was removed. Use max_request_body_size. See https://docs.sentry.io/platforms/python/configuration/options/#max-request-body-size.
  • Removed support for user.segment. It was also removed from the trace header as well as from the dynamic sampling context.
  • Removed support for the install method for custom integrations. Please use setup_once instead.
  • Removed sentry_sdk.tracing.Span.new_span. Use sentry_sdk.tracing.Span.start_child instead.
  • Removed sentry_sdk.tracing.Transaction.new_span. Use sentry_sdk.tracing.Transaction.start_child instead.
  • Removed sentry_sdk.utils.Auth.store_api_url.
  • sentry_sdk.utils.Auth.get_api_url's now accepts a sentry_sdk.consts.EndpointType enum instead of a string as its only parameter. We recommend omitting this argument when calling the function, since the parameter's default value is the only possible sentry_sdk.consts.EndpointType value. The parameter exists for future compatibility.
  • Removed tracing_utils_py2.py. The start_child_span_decorator is now in sentry_sdk.tracing_utils.
  • Removed the sentry_sdk.profiler.Scheduler.stop_profiling method. Any calls to this method can simply be removed, since this was a no-op method.

Deprecated

  • profiler_mode and profiles_sample_rate have been deprecated as _experiments options. Use them as top level options instead:
    sentry_sdk.init(
        ...,
        profiler_mode="thread",
        profiles_sample_rate=1.0,
    )
    
  • Deprecated sentry_sdk.transport.Transport.capture_event. Please use sentry_sdk.transport.Transport.capture_envelope, instead.
  • Passing a function to sentry_sdk.init's transport keyword argument has been deprecated. If you wish to provide a custom transport, please pass a sentry_sdk.transport.Transport instance or a subclass.
  • The parameter propagate_hub in ThreadingIntegration() was deprecated and renamed to propagate_scope.

Various fixes & improvements

  • New integration: OpenAI integration (#2791) by @colin-sentry

    We added an integration for OpenAI to capture errors and also performance data when using the OpenAI Python SDK.

    Useage:

    This integrations is auto-enabling, so if you have the openai package in your project it will be enabled. Just initialize Sentry before you create your OpenAI client.

    from openai import OpenAI
    
    import sentry_sdk
    
    sentry_sdk.init(
        dsn="___PUBLIC_DSN___",
        enable_tracing=True,
        traces_sample_rate=1.0,
    )
    
    client = OpenAI()
    

    For more information, see the documentation for OpenAI integration.

  • Discard open OpenTelemetry spans after 10 minutes (#2801) by @antonpirker

  • Propagate sentry-trace and baggage headers to Huey tasks (#2792) by @cnschn

  • Added Event type (#2753) by @szokeasaurusrex

  • Improve scrub_dict typing (#2768) by @szokeasaurusrex

  • Dependencies: bump types-protobuf from 4.24.0.20240302 to 4.24.0.20240311 (#2797) by @dependabot

Mar 11, 2024

New Features

  • Additional integrations will now be activated automatically if the SDK detects the respective package is installed: Ariadne, ARQ, asyncpg, Chalice, clickhouse-driver, GQL, Graphene, huey, Loguru, PyMongo, Quart, Starlite, Strawberry.

Changed

  • The Pyramid integration will not capture errors that might happen in authenticated_userid() in a custom AuthenticationPolicy class.

  • The method need_code_loation of the MetricsAggregator was renamed to need_code_location.

  • The BackgroundWorker thread used to process events was renamed from raven-sentry.BackgroundWorker to sentry-sdk.BackgroundWorker.

  • The reraise function was moved from sentry_sdk._compat to sentry_sdk.utils.

  • The _ScopeManager was moved from sentry_sdk.hub to sentry_sdk.scope.

  • Moved the contents of tracing_utils_py3.py to tracing_utils.py. The start_child_span_decorator is now in sentry_sdk.tracing_utils.

  • The actual implementation of get_current_span was moved to sentry_sdk.tracing_utils. sentry_sdk.get_current_span is still accessible as part of the top-level API.

  • sentry_sdk.tracing_utils.get_current_span() does now take a scope instead of a hub as parameter.

  • sentry_sdk.utils._get_contextvars does not return a tuple with three values, but a tuple with two values. The copy_context was removed.

  • If you create a transaction manually and later mutate the transaction in a configure_scope block this does not work anymore. Here is a recipe on how to change your code to make it work: Your existing implementation:

    transaction = sentry_sdk.transaction(...)
    
    # later in the code execution:
    
    with sentry_sdk.configure_scope() as scope:
        scope.set_transaction_name("new-transaction-name")
    

    needs to be changed to this:

    transaction = sentry_sdk.transaction(...)
    
    # later in the code execution:
    
    scope = sentry_sdk.Scope.get_current_scope()
    scope.set_transaction_name("new-transaction-name")
    
  • The classes listed in the table below are now abstract base classes. Therefore, they can no longer be instantiated. Subclasses can only be instantiated if they implement all of the abstract methods.

    <details> <summary><b>Show table</b></summary>
    ClassAbstract methods
    sentry_sdk.integrations.Integrationsetup_once
    sentry_sdk.metrics.Metricadd, serialize_value, and weight
    sentry_sdk.profiler.Schedulersetup and teardown
    sentry_sdk.transport.Transportcapture_envelope
    </details>

Removed

  • Removed support for Python 2 and Python 3.5. The SDK now requires at least Python 3.6.
  • Removed support for Celery 3.*.
  • Removed support for Django 1.8, 1.9, 1.10.
  • Removed support for Flask 0.*.
  • Removed last_event_id() top level API. The last event ID is still returned by capture_event(), capture_exception() and capture_message() but the top level API sentry_sdk.last_event_id() has been removed.
  • Removed support for sending events to the /store endpoint. Everything is now sent to the /envelope endpoint. If you're on SaaS you don't have to worry about this, but if you're running Sentry yourself you'll need version 20.6.0 or higher of self-hosted Sentry.
  • The deprecated with_locals configuration option was removed. Use include_local_variables instead. See https://docs.sentry.io/platforms/python/configuration/options/#include-local-variables.
  • The deprecated request_bodies configuration option was removed. Use max_request_body_size. See https://docs.sentry.io/platforms/python/configuration/options/#max-request-body-size.
  • Removed support for user.segment. It was also removed from the trace header as well as from the dynamic sampling context.
  • Removed support for the install method for custom integrations. Please use setup_once instead.
  • Removed sentry_sdk.tracing.Span.new_span. Use sentry_sdk.tracing.Span.start_child instead.
  • Removed sentry_sdk.tracing.Transaction.new_span. Use sentry_sdk.tracing.Transaction.start_child instead.
  • Removed sentry_sdk.utils.Auth.store_api_url.
  • sentry_sdk.utils.Auth.get_api_url's now accepts a sentry_sdk.consts.EndpointType enum instead of a string as its only parameter. We recommend omitting this argument when calling the function, since the parameter's default value is the only possible sentry_sdk.consts.EndpointType value. The parameter exists for future compatibility.
  • Removed tracing_utils_py2.py. The start_child_span_decorator is now in sentry_sdk.tracing_utils.
  • Removed the sentry_sdk.profiler.Scheduler.stop_profiling method. Any calls to this method can simply be removed, since this was a no-op method.

Deprecated

  • profiler_mode and profiles_sample_rate have been deprecated as _experiments options. Use them as top level options instead:
    sentry_sdk.init(
        ...,
        profiler_mode="thread",
        profiles_sample_rate=1.0,
    )
    
  • Deprecated sentry_sdk.transport.Transport.capture_event. Please use sentry_sdk.transport.Transport.capture_envelope, instead.
  • Passing a function to sentry_sdk.init's transport keyword argument has been deprecated. If you wish to provide a custom transport, please pass a sentry_sdk.transport.Transport instance or a subclass.
  • The parameter propagate_hub in ThreadingIntegration() was deprecated and renamed to propagate_scope.
Mar 7, 2024

Various fixes & improvements

  • Add recursive scrubbing to EventScrubber (#2755) by @Cheapshot003

    By default, the EventScrubber will not search your events for potential PII recursively. With this release, you can enable this behavior with:

    import sentry_sdk
    from sentry_sdk.scrubber import EventScrubber
    
    sentry_sdk.init(
        # ...your usual settings...
        event_scrubber=EventScrubber(recursive=True),
    )
    
  • Expose socket_options (#2786) by @sentrivana

    If the SDK is experiencing connection issues (connection resets, server closing connection without response, etc.) while sending events to Sentry, tweaking the default urllib3 socket options to the following can help:

    import socket
    from urllib3.connection import HTTPConnection
    import sentry_sdk
    
    sentry_sdk.init(
        # ...your usual settings...
        socket_options=HTTPConnection.default_socket_options + [
            (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1),
            # note: skip the following line if you're on MacOS since TCP_KEEPIDLE doesn't exist there
            (socket.SOL_TCP, socket.TCP_KEEPIDLE, 45),
            (socket.SOL_TCP, socket.TCP_KEEPINTVL, 10),
            (socket.SOL_TCP, socket.TCP_KEEPCNT, 6),
        ],
    )
    
  • Allow to configure merge target for releases (#2777) by @sentrivana

  • Allow empty character in metric tags values (#2775) by @viglia

  • Replace invalid tag values with an empty string instead of _ (#2773) by @markushi

  • Add documentation comment to scrub_list (#2769) by @szokeasaurusrex

  • Fixed regex to parse version in lambda package file (#2767) by @antonpirker

  • xfail broken AWS Lambda tests for now (#2794) by @sentrivana

  • Removed print statements because it messes with the tests (#2789) by @antonpirker

  • Bump types-protobuf from 4.24.0.20240129 to 4.24.0.20240302 (#2782) by @dependabot

  • Bump checkouts/data-schemas from eb941c2 to ed078ed (#2781) by @dependabot

Feb 29, 2024

Sentry SDK 2.0.0a2 is alpha software and not yet ready for production!

Please give it a spin and test it with your project. If you have any questions or feedback please contact us on Discord in the #python channel or create a GitHub Issue or start a GitHub Discussion.

Thanks!

New Features

  • Additional integrations will now be activated automatically if the SDK detects the respective package is installed: Ariadne, ARQ, asyncpg, Chalice, clickhouse-driver, GQL, Graphene, huey, Loguru, PyMongo, Quart, Starlite, Strawberry.

Changed

  • The Pyramid integration will not capture errors that might happen in authenticated_userid() in a custom AuthenticationPolicy class.

  • The method need_code_loation of the MetricsAggregator was renamed to need_code_location.

  • The BackgroundWorker thread used to process events was renamed from raven-sentry.BackgroundWorker to sentry-sdk.BackgroundWorker.

  • The reraise function was moved from sentry_sdk._compat to sentry_sdk.utils.

  • The _ScopeManager was moved from sentry_sdk.hub to sentry_sdk.scope.

  • Moved the contents of tracing_utils_py3.py to tracing_utils.py. The start_child_span_decorator is now in sentry_sdk.tracing_utils.

  • The actual implementation of get_current_span was moved to sentry_sdk.tracing_utils. sentry_sdk.get_current_span is still accessible as part of the top-level API.

  • sentry_sdk.tracing_utils.get_current_span() does now take a scope instead of a hub as parameter.

  • sentry_sdk.utils._get_contextvars does not return a tuple with three values, but a tuple with two values. The copy_context was removed.

  • If you create a transaction manually and later mutate the transaction in a configure_scope block this does not work anymore. Here is a recipe on how to change your code to make it work: Your existing implementation:

    transaction = sentry_sdk.transaction(...)
    
    # later in the code execution:
    
    with sentry_sdk.configure_scope() as scope:
        scope.set_transaction_name("new-transaction-name")
    

    needs to be changed to this:

    transaction = sentry_sdk.transaction(...)
    
    # later in the code execution:
    
    scope = sentry_sdk.Scope.get_current_scope()
    scope.set_transaction_name("new-transaction-name")
    
  • The classes listed in the table below are now abstract base classes. Therefore, they can no longer be instantiated. Subclasses can only be instantiated if they implement all of the abstract methods.

    <details> <summary><b>Show table</b></summary>
    ClassAbstract methods
    sentry_sdk.integrations.Integrationsetup_once
    sentry_sdk.metrics.Metricadd, serialize_value, and weight
    sentry_sdk.profiler.Schedulersetup and teardown
    sentry_sdk.transport.Transportcapture_envelope
    </details>

Removed

  • Removed support for Python 2 and Python 3.5. The SDK now requires at least Python 3.6.
  • Removed support for Celery 3.*.
  • Removed support for Django 1.8, 1.9, 1.10.
  • Removed support for Flask 0.*.
  • Removed last_event_id() top level API. The last event ID is still returned by capture_event(), capture_exception() and capture_message() but the top level API sentry_sdk.last_event_id() has been removed.
  • Removed support for sending events to the /store endpoint. Everything is now sent to the /envelope endpoint. If you're on SaaS you don't have to worry about this, but if you're running Sentry yourself you'll need version 20.6.0 or higher of self-hosted Sentry.
  • The deprecated with_locals configuration option was removed. Use include_local_variables instead. See https://docs.sentry.io/platforms/python/configuration/options/#include-local-variables.
  • The deprecated request_bodies configuration option was removed. Use max_request_body_size. See https://docs.sentry.io/platforms/python/configuration/options/#max-request-body-size.
  • Removed support for user.segment. It was also removed from the trace header as well as from the dynamic sampling context.
  • Removed support for the install method for custom integrations. Please use setup_once instead.
  • Removed sentry_sdk.tracing.Span.new_span. Use sentry_sdk.tracing.Span.start_child instead.
  • Removed sentry_sdk.tracing.Transaction.new_span. Use sentry_sdk.tracing.Transaction.start_child instead.
  • Removed sentry_sdk.utils.Auth.store_api_url.
  • sentry_sdk.utils.Auth.get_api_url's now accepts a sentry_sdk.consts.EndpointType enum instead of a string as its only parameter. We recommend omitting this argument when calling the function, since the parameter's default value is the only possible sentry_sdk.consts.EndpointType value. The parameter exists for future compatibility.
  • Removed tracing_utils_py2.py. The start_child_span_decorator is now in sentry_sdk.tracing_utils.
  • Removed the sentry_sdk.profiler.Scheduler.stop_profiling method. Any calls to this method can simply be removed, since this was a no-op method.

Deprecated

  • profiler_mode and profiles_sample_rate have been deprecated as _experiments options. Use them as top level options instead:
    sentry_sdk.init(
        ...,
        profiler_mode="thread",
        profiles_sample_rate=1.0,
    )
    
  • Deprecated sentry_sdk.transport.Transport.capture_event. Please use sentry_sdk.transport.Transport.capture_envelope, instead.
  • Passing a function to sentry_sdk.init's transport keyword argument has been deprecated. If you wish to provide a custom transport, please pass a sentry_sdk.transport.Transport instance or a subclass.
  • The parameter propagate_hub in ThreadingIntegration() was deprecated and renamed to propagate_scope.
Feb 27, 2024

Various fixes & improvements

  • Fix compatibility with greenlet/gevent (#2756) by @sentrivana
  • Fix query source relative filepath (#2717) by @gggritso
  • Support clickhouse-driver==0.2.7 (#2752) by @sentrivana
  • Bump checkouts/data-schemas from 6121fd3 to eb941c2 (#2747) by @dependabot
Feb 26, 2024

Sentry SDK 2.0a1 is alpha software and not yet ready for production!

Please give it a spin and test it with your project. If you have any questions or feedback please contact us on Discord in the #python channel or create a GitHub Issue or start a GitHub Discussion.

Thanks!

New Features

  • Additional integrations will now be activated automatically if the SDK detects the respective package is installed: Ariadne, ARQ, asyncpg, Chalice, clickhouse-driver, GQL, Graphene, huey, Loguru, PyMongo, Quart, Starlite, Strawberry.

Changed

  • The Pyramid integration will not capture errors that might happen in authenticated_userid() in a custom AuthenticationPolicy class.

  • The method need_code_loation of the MetricsAggregator was renamed to need_code_location.

  • The BackgroundWorker thread used to process events was renamed from raven-sentry.BackgroundWorker to sentry-sdk.BackgroundWorker.

  • The reraise function was moved from sentry_sdk._compat to sentry_sdk.utils.

  • The _ScopeManager was moved from sentry_sdk.hub to sentry_sdk.scope.

  • Moved the contents of tracing_utils_py3.py to tracing_utils.py. The start_child_span_decorator is now in sentry_sdk.tracing_utils.

  • The actual implementation of get_current_span was moved to sentry_sdk.tracing_utils. sentry_sdk.get_current_span is still accessible as part of the top-level API.

  • sentry_sdk.tracing_utils.get_current_span() does now take a scope instead of a hub as parameter.

  • sentry_sdk.utils._get_contextvars does not return a tuple with three values, but a tuple with two values. The copy_context was removed.

  • If you create a transaction manually and later mutate the transaction in a configure_scope block this does not work anymore. Here is a recipe on how to change your code to make it work: Your existing implementation:

    transaction = sentry_sdk.transaction(...)
    
    # later in the code execution:
    
    with sentry_sdk.configure_scope() as scope:
        scope.set_transaction_name("new-transaction-name")
    

    needs to be changed to this:

    transaction = sentry_sdk.transaction(...)
    
    # later in the code execution:
    
    scope = sentry_sdk.Scope.get_current_scope()
    scope.set_transaction_name("new-transaction-name")
    
  • The classes listed in the table below are now abstract base classes. Therefore, they can no longer be instantiated. Subclasses can only be instantiated if they implement all of the abstract methods.

    <details> <summary><b>Show table</b></summary>
    ClassAbstract methods
    sentry_sdk.integrations.Integrationsetup_once
    sentry_sdk.metrics.Metricadd, serialize_value, and weight
    sentry_sdk.profiler.Schedulersetup and teardown
    sentry_sdk.transport.Transportcapture_envelope
    </details>

Removed

  • Removed support for Python 2 and Python 3.5. The SDK now requires at least Python 3.6.
  • Removed support for Celery 3.*.
  • Removed support for Django 1.8, 1.9, 1.10.
  • Removed support for Flask 0.*.
  • Removed last_event_id() top level API. The last event ID is still returned by capture_event(), capture_exception() and capture_message() but the top level API sentry_sdk.last_event_id() has been removed.
  • Removed support for sending events to the /store endpoint. Everything is now sent to the /envelope endpoint. If you're on SaaS you don't have to worry about this, but if you're running Sentry yourself you'll need version 20.6.0 or higher of self-hosted Sentry.
  • The deprecated with_locals configuration option was removed. Use include_local_variables instead. See https://docs.sentry.io/platforms/python/configuration/options/#include-local-variables.
  • The deprecated request_bodies configuration option was removed. Use max_request_body_size. See https://docs.sentry.io/platforms/python/configuration/options/#max-request-body-size.
  • Removed support for user.segment. It was also removed from the trace header as well as from the dynamic sampling context.
  • Removed support for the install method for custom integrations. Please use setup_once instead.
  • Removed sentry_sdk.tracing.Span.new_span. Use sentry_sdk.tracing.Span.start_child instead.
  • Removed sentry_sdk.tracing.Transaction.new_span. Use sentry_sdk.tracing.Transaction.start_child instead.
  • Removed sentry_sdk.utils.Auth.store_api_url.
  • sentry_sdk.utils.Auth.get_api_url's now accepts a sentry_sdk.consts.EndpointType enum instead of a string as its only parameter. We recommend omitting this argument when calling the function, since the parameter's default value is the only possible sentry_sdk.consts.EndpointType value. The parameter exists for future compatibility.
  • Removed tracing_utils_py2.py. The start_child_span_decorator is now in sentry_sdk.tracing_utils.
  • Removed the sentry_sdk.profiler.Scheduler.stop_profiling method. Any calls to this method can simply be removed, since this was a no-op method.

Deprecated

  • profiler_mode and profiles_sample_rate have been deprecated as _experiments options. Use them as top level options instead:
    sentry_sdk.init(
        ...,
        profiler_mode="thread",
        profiles_sample_rate=1.0,
    )
    
  • Deprecated sentry_sdk.transport.Transport.capture_event. Please use sentry_sdk.transport.Transport.capture_envelope, instead.
  • Passing a function to sentry_sdk.init's transport keyword argument has been deprecated. If you wish to provide a custom transport, please pass a sentry_sdk.transport.Transport instance or a subclass.
  • The parameter propagate_hub in ThreadingIntegration() was deprecated and renamed to propagate_scope.
Feb 19, 2024

Various fixes & improvements

  • Deprecate last_event_id(). (#2749) by @antonpirker

  • Warn if uWSGI is set up without proper thread support (#2738) by @sentrivana

    uWSGI has to be run in threaded mode for the SDK to run properly. If this is not the case, the consequences could range from features not working unexpectedly to uWSGI workers crashing.

    Please make sure to run uWSGI with both --enable-threads and --py-call-uwsgi-fork-hooks.

  • parsed_url can be None (#2734) by @sentrivana

  • Python 3.7 is not supported anymore by Lambda, so removed it and added 3.12 (#2729) by @antonpirker

Feb 13, 2024

Various fixes & improvements

  • Only start metrics flusher thread on demand (#2727) by @sentrivana
  • Bump checkouts/data-schemas from aa7058c to 6121fd3 (#2724) by @dependabot
Feb 9, 2024

Various fixes & improvements

  • Turn off metrics for uWSGI (#2720) by @sentrivana
  • Minor improvements (#2714) by @antonpirker
Feb 7, 2024

Various fixes & improvements

  • test: Fix pytest error (#2712) by @szokeasaurusrex
  • build(deps): bump types-protobuf from 4.24.0.4 to 4.24.0.20240129 (#2691) by @dependabot
Feb 6, 2024

Various fixes & improvements

  • Fix uWSGI workers hanging (#2694) by @sentrivana
  • Make metrics work with gevent (#2694) by @sentrivana
  • Guard against engine.url being None (#2708) by @sentrivana
  • Fix performance regression in sentry_sdk.utils._generate_installed_modules (#2703) by @GlenWalker
  • Guard against Sentry initialization mid SQLAlchemy cursor (#2702) by @apmorton
  • Fix yaml generation script (#2695) by @sentrivana
  • Fix AWS Lambda workflow (#2710) by @sentrivana
  • Bump codecov/codecov-action from 3 to 4 (#2706) by @dependabot
  • Bump actions/cache from 3 to 4 (#2661) by @dependabot
  • Bump actions/checkout from 3.1.0 to 4.1.1 (#2561) by @dependabot
  • Bump github/codeql-action from 2 to 3 (#2603) by @dependabot
  • Bump actions/setup-python from 4 to 5 (#2577) by @dependabot
Jan 30, 2024

Various fixes & improvements

  • Enable metrics related settings by default (#2685) by @iambriccardo
  • Fix UnicodeDecodeError on Python 2 (#2657) by @sentrivana
  • Enable DB query source by default (#2629) by @sentrivana
  • Fix query source duration check (#2675) by @sentrivana
  • Reformat with black==24.1.0 (#2680) by @sentrivana
  • Cleaning up existing code to prepare for new Scopes API (#2611) by @antonpirker
  • Moved redis related tests to databases (#2674) by @antonpirker
  • Improve sentry_sdk.trace type hints (#2633) by @szokeasaurusrex
  • Bump checkouts/data-schemas from e9f7d58 to aa7058c (#2639) by @dependabot
Jan 10, 2024

Various fixes & improvements

  • Fix timestamp in transaction created by OTel (#2627) by @antonpirker
  • Fix relative path in DB query source (#2624) by @antonpirker
  • Run more CI checks on 2.0 branch (#2625) by @sentrivana
  • Fix tracing TypeError for static and class methods (#2559) by @szokeasaurusrex
  • Fix missing ctx in Arq integration (#2600) by @ivanovart
  • Change data_category from check_in to monitor (#2598) by @sentrivana
Dec 14, 2023

Various fixes & improvements

  • Fix psycopg2 detection in the Django integration (#2593) by @sentrivana
  • Filter out empty string releases (#2591) by @sentrivana
  • Fixed local var not present when there is an error in a user's error_sampler function (#2511) by @antonpirker
  • Fixed typing in aiohttp (#2590) by @antonpirker
Dec 12, 2023

Various fixes & improvements

  • Add support for cluster clients from Redis SDK (#2394) by @md384
  • Improve location reporting for timer metrics (#2552) by @mitsuhiko
  • Fix Celery TypeError with no-argument apply_async (#2575) by @szokeasaurusrex
  • Fix Lambda integration with EventBridge source (#2546) by @davidcroda
  • Add max tries to Spotlight (#2571) by @hazAT
  • Handle os.path.devnull access issues (#2579) by @sentrivana
  • Change code.filepath frame picking logic (#2568) by @sentrivana
  • Trigger AWS Lambda tests on label (#2538) by @sentrivana
  • Run permissions step on pull_request_target but not push (#2548) by @sentrivana
  • Hash AWS Lambda test functions based on current revision (#2557) by @sentrivana
  • Update Django version in tests (#2562) by @sentrivana
  • Make metrics tests non-flaky (#2572) by @antonpirker
Latest
2.58.0
Tracking Since
Jul 6, 2021
Last checked Apr 20, 2026