Important

• We're making enable_logs and enable_metrics no-op with this release (#7177), and they'll be dropped in the next major.

  Previously, enable_logs also controlled automatic logs collection from the logging and Loguru integrations. These integrations now get an integration-level capture_sentry_logs boolean option to allow for more control over the auto-collection. These options are False by default, i.e., nothing is auto-collected without your explicit opt-in.

  Action Needed

  If you had enable_logs set to True:

  • If you were using the sentry_sdk.logger.X API, no action necessary, the API will just work.
  • If you were auto-collecting logs from either LoggingIntegration or LoguruIntegration, the auto-collection will be turned off in this release. You can switch auto-collection on explicitly with:

  import sentry_sdk
  from sentry_sdk.integrations.logging import LoggingIntegration
  from sentry_sdk.integrations.loguru import LoguruIntegration
  
  sentry_sdk.init(
      integrations=[
          LoggingIntegration(capture_sentry_logs=True),
          LoguruIntegration(capture_sentry_logs=True),
      ],
  )

  If you had enable_logs set to False:

  • If you were using it to gate usages of the sentry_sdk.logger.X API, you'll need to remove the calls entirely or define a before_send_log callback to filter out unwanted logs.

  If you has enable_metrics set to False:

  • Any metrics emitted using the metrics API will be emitted. You'll need to drop them in a before_send_metric or remove the calls to the API.

  Why We're Doing This

  We recognize this is a disruptive change for some folks and want to make it clear this is a one-off. We're removing the options because they were an unnecessary hurdle that one had to jump through to be able to use logs and metrics, and it was confusing why the logging API would not just work on its own. On the other hand, we wanted to give you more fine-grained control over automatic collection.

New Features ✨

Other

• Set the segment source on the scope for NoOpStreamedSpan by @alexander-alderman-webb in #7163
• Remove early return for NoOpStreamedSpan in set_transaction_name() by @alexander-alderman-webb in #7164
• Set the segment name on the scope with NoOpStreamedSpan by @alexander-alderman-webb in #7162

Bug Fixes 🐛

• (batcher) Add global flush trigger based on the span number by @alexander-alderman-webb in #7150

Internal Changes 🔧

HTTPX, HTTPX2

• Move crumbs to integrations by @sentrivana in #7149
• Split into sync/async tests by @sentrivana in #7152

Other

• (aiohttp) Move crumbs to integration by @sentrivana in #7135
• (boto3) Move crumbs to integration by @sentrivana in #7165
• (django) Remove dead code and stale markers from the Django test suite by @ericapisani in #7156
• (pyreqwest) Move crumbs to integration by @sentrivana in #7148
• (stdlib) Move crumbs to integration by @sentrivana in #7161
• Flush trace buckets when segment spans finish by @alexander-alderman-webb in #7170
• Revert global span batcher limits by @alexander-alderman-webb in #7168

Bug Fixes 🐛

• (batcher) Add global flush trigger based on the span number by @alexander-alderman-webb in #7150

New Features ✨

Batcher

• Add global flush trigger based on summed size estimates by @alexander-alderman-webb in #7144
• Add hard span limit by @alexander-alderman-webb in #7143

Integrations

• Add span for DRF authentication by @mgaligniana in #6984

Langchain

• Record reasoning token usage attribute by @alexander-alderman-webb in #7136
• Record cached token usage attributes by @alexander-alderman-webb in #7132

Openai

• Set gen_ai.tool.definitions for the Responses API by @alexander-alderman-webb in #6951
• Set gen_ai.tool.definitions for the Chat Completions API by @alexander-alderman-webb in #6950
• Add gen_ai.request.reasoning.level to OpenAI spans by @pabloDeputter in #6892

Streaming

• Support ai_track decorator by @sentrivana in #6895
• Promote before_send_span to top-level option by @sentrivana in #6885
• Make set_conversation_id API work by @sentrivana in #6866

Other

• (api) Add top-level set_attributes API by @sentrivana in #6897
• (aws-lambda) Enable Python 3.14 support to the Lambda layer by @pabloDeputter in #6916
• (openai-agents) Set the gen_ai.tool.definitions attribute by @alexander-alderman-webb in #6956
• (pydantic-ai) Record gen_ai.output.messages including ThinkingPart by @alexander-alderman-webb in #7037
• Add possibility to allowlist integrations in toxgen by @sentrivana in #6996

Bug Fixes 🐛

Openai Agents

• Patch correct run_single_turn_streamed reference by @alexander-alderman-webb in #7032
• Stop destructively wrapping tools by @alexander-alderman-webb in #6961

Tests

• Adapt to new exception propagation behavior in Quart by @sentrivana in #6995
• Remove redundant type filters after capture_items with args by @sentrivana in #6867

Other

• (aws-lambda) Fix flake in aws lambda tests by @pabloDeputter in #6937
• (langchain) Stop double-counting usage in multi-candidate responses by @alexander-alderman-webb in #7064
• (mcp) Stop adding the prompt name to arguments by @alexander-alderman-webb in #6765
• (pydantic-ai) Stop recording duplicate spans by @alexander-alderman-webb in #7056
• (sampling) sentry-trace should take precedence over baggage by @sentrivana in #6863
• (streaming) Set segment source if unset by @sentrivana in #6791
• Do not let exceptions in before_breadcrumb bubble up by @sentrivana in #7133
• Correct typo in test function name by @TheGreatApollyon in #6967
• Include query string and fragment in url.full span attribute by @sentrivana in #6861

Documentation 📚

• Remove AI commit attribution requirement from AGENTS.md by @ericapisani in #6828

Internal Changes 🔧

Fastmcp

• Skip SSE test for fastmcp>=4 by @alexander-alderman-webb in #6923
• Remove assertions on RootModel instances by @alexander-alderman-webb in #6909
• Replace broad try...except with skipif by @alexander-alderman-webb in #6922

Mcp

• Replace instance patches with middleware by @alexander-alderman-webb in #6764
• Remove redundant mcp.tool.result.is_error by @alexander-alderman-webb in #6915
• Use mcp_types package by @alexander-alderman-webb in #6763
• Inline _set_span_output_data() by @alexander-alderman-webb in #6762
• Inline _get_span_config() by @alexander-alderman-webb in #6761
• Inline _prepare_handler_data() by @alexander-alderman-webb in #6758
• Separate tool, prompt and resource patches by @alexander-alderman-webb in #6726

Openai Agents

• Stop setting gen_ai.response.model on Invoke Agent spans by @alexander-alderman-webb in #7028
• Use first class tool hooks when available by @alexander-alderman-webb in #6994
• Assert subset of expected dictionary is in gen_ai.response.tool_calls by @alexander-alderman-webb in #6973
• Stop setting gen_ai.request.available_tools on Invoke Agent spans by @alexander-alderman-webb in #6955
• Stop setting gen_ai.request.available_tools on Execute Tool spans by @alexander-alderman-webb in #6954

Other

• (ai) Route AI integration tests through OpenRouter by @sentry-junior in #6979
• (arq) Avoid race between the exception and transaction events by @alexander-alderman-webb in #7052
• (aws_lambda) Add ARM64 architecture support for local Lambda testing by @ericapisani in #7053
• (deps) Lock file maintenance by @renovate in #6734
• (django) Use iscoroutinefunction shim in patch_views() by @alexander-alderman-webb in #7024
• (httpx) Replace deprecated asyncio.iscoroutinefunction by @alexander-alderman-webb in #7023
• (huggingface-hub) Fix chat completion stream type by @alexander-alderman-webb in #7070
• (langchain) Remove on_agent_finish() hook by @alexander-alderman-webb in #7059
• (pydantic-ai) Use FunctionModel for testing output data transformations by @alexander-alderman-webb in #7036
• (serializer) Avoid copying the whole Mapping before trimming to MAX_DATABAG_BREADTH by @Malkiz223 in #6783
• (tests) Replace _transport_works_cases loop with explicit case list by @ericapisani in #6978
• 🤖 Update test matrix with new releases (08/10) by @github-actions in #7142
• Pin litellm<=1.96 for generating test suites by @alexander-alderman-webb in #7147
• Unpin Django version for generating test suites by @alexander-alderman-webb in #7146
• Move Redis breadcrumbs to integration by @sentrivana in #7129
• Move subprocess breadcrumbs to integration by @sentrivana in #7128
• Avoid scanning installed packages when MCP SDK is not installed by @mangodxd in #6865
• Remove test-lambda-locally by @alexander-alderman-webb in #7069
• Add pydantic-ai-slim to uv typing group by @alexander-alderman-webb in #7025
• Add langchain-base to uv typing group by @alexander-alderman-webb in #7016
• 🤖 Update test matrix with new releases (08/03) by @github-actions in #6985
• Mock attributes in redis cluster tests by @sentrivana in #7022
• Deprecate ai_track() by @alexander-alderman-webb in #7005
• Reduce common test suite while not reducing coverage by @ericapisani in #6972
• Use top-level options if available by @sentrivana in #6959
• Restore wrapped functions in functions_to_trace tes...

Bug Fixes 🐛

Tracing

• Handle exceptions raised within traces_sampler and other callbacks by @ericapisani in #6853

Internal Changes 🔧

• Fix flaky decorator test by @sl0thentr0py in #6830

New Features ✨

• (tracing) Promote trace_lifecycle and ignore_spans to top-level options by @ericapisani in #6821

Bug Fixes 🐛

Tracing

• Skip child span creation in streaming path when no current span (HTTP clients) by @sentrivana in #6811
• Skip child span creation in streaming path when no current span (task queues) by @sentrivana in #6814
• Skip child span creation in streaming path when no current span (misc) by @sentrivana in #6815
• Skip child span creation in streaming path when no current span (databases) by @sentrivana in #6808
• Skip child span creation in streaming path when no current span (web frameworks) by @sentrivana in #6810
• Skip child span creation in streaming path when no current span (django) by @sentrivana in #6809

Internal Changes 🔧

• (logging) Fix flaky test_logging_captured_warnings by @ericapisani in #6824
• Remove flaky no cyclic garbage test by @alexander-alderman-webb in #6817
• Remove Claude permission settings by @cleptric in #6806
• Move nullcontext to sentry_sdk.utils by @sentrivana in #6805

New Features ✨

Huey

• Set messaging.destination.name on consumer spans by @alexander-alderman-webb in #6779
• Set messaging.destination.name on producer spans by @alexander-alderman-webb in #6778

Other

• (arq) Set messaging.destination.name on consumer spans by @alexander-alderman-webb in #6767
• (dramatiq) Set messaging.destination.name on consumer spans by @alexander-alderman-webb in #6776
• (rq) Set messaging.destination.name on consumer spans by @alexander-alderman-webb in #6774

Bug Fixes 🐛

Tracing

• Take first sentry-trace header in case multiple are supplied by @sl0thentr0py in #6722

Other

• (django) Avoid ValueError in async middleware process_* hooks by @r0ro in #6698
• (scope) Drop None user attribute values in set_user by @ericapisani in #6692
• (starlette) Don't overwrite user set during request in AuthenticationMiddleware by @ericapisani in #6760

Internal Changes 🔧

• (mcp) Add package to the typing group by @alexander-alderman-webb in #6727
• (starlette) Add package to typing group by @alexander-alderman-webb in #6728
• Add required cache_write_tokens field by @alexander-alderman-webb in #6804
• Pin extra test dependencies for generated test suites by @alexander-alderman-webb in #6696
• Add pydantic to the typing group by @alexander-alderman-webb in #6730
• Add python_multipart to the typing group by @alexander-alderman-webb in #6729
• 🤖 Update test matrix with new releases (07/06) by @github-actions in #6753
• Remove dependabot by @alexander-alderman-webb in #6720
• Update Renovate config by @alexander-alderman-webb in #6716
• Stop inheriting secrets for changelog-preview by @alexander-alderman-webb in #6723
• Stop inheriting secrets in tests by @alexander-alderman-webb in #6721
• Configure Renovate by @renovate in #6701
• Move conversation ID tests to their own file by @sentrivana in #6699
• Replace requirements-testing.txt with a uv dependency group by @alexander-alderman-webb in #6693

The SDK now extracts all gen_ai spans out of a transaction and sends them as v2 envelope items by default. This prevents gen_ai spans from being dropped when the transaction payload exceeds size limits. Because they are no longer constrained by transaction size limits, AI message data is also no longer truncated. To keep the previous behavior, set stream_gen_ai_spans=False.

Self-hosted Sentry users should opt out with stream_gen_ai_spans=False, since streamed gen_ai spans may not be ingested by their Sentry instance.

Bug Fixes 🐛

• (asyncpg) Use distinct span ops for cursor iteration and fetch to prevent N+1 false positives by @ericapisani in #6609
• (aiohttp) Gate url.full, url.path, url.query on send_default_pii by @ericapisani in #6650
• (asgi) Add url.path to ASGI request span attributes by @ericapisani in #6652
• (boto3) Gate url.full, url.query, url.fragment behind send_default_pii by @ericapisani in #6674
• (httpx) Gate url.full, url.query, and url.fragment behind send_default_pii by @ericapisani in #6668
• (httpx2) Gate url.full, url.query on send_default_pii by @ericapisani in #6670
• (langgraph) Ignore GraphBubbleUp exceptions by @alexander-alderman-webb in #6608
• (litellm) Store span off-band, not in forwarded metadata by @jgreer013 in #6598
• (mcp) Support MCP SDK v2 handler signature and removed request_ctx by @ericapisani in #6583
• (pydantic-ai) Stop truncating in the streaming trace lifecycle by @alexander-alderman-webb in #6659
• (pymongo) Add db.query.text to streamed query spans by @ericapisani in #6637
• (pyreqwest) Gate url.full, url.query, url.fragment on send_default_pii by @ericapisani in #6673
• (sanic) Gate url.full, url.path, and http.query behind send_default_pii by @ericapisani in #6663
• (starlette) Stop duplicating scope["root_path"] in URLs by @alexander-alderman-webb in #6579
• (stdlib) Gate url.full and http.query behind send_default_pii by @ericapisani in #6666
• (tests) Fix flaky OTel propagator entry point test by @ericapisani in #6655
• (tornado) Gate url.full, url.path, url.query on send_default_pii by @ericapisani in #6664
• (wsgi) Gate url.full, url.path, and http.query behind send_default_pii by @ericapisani in #6654
• Stop unconditionally importing contextvars by @alexander-alderman-webb in #6625
• (.agents) Update project agent lockfiles by @ericapisani in #6662

Documentation 📚

• Add light/dark logos by @hwhsu1231 in #6627
• Fix typos by @juliosuas in #6602

Internal Changes 🔧

• (mcp) Pin mcp package to <2.0.0 while alphas are in flight by @ericapisani in #6687
• 🤖 Update test matrix with new releases (06/29) by @github-actions in #6682
• Make stream_gen_ai_spans opt out by @alexander-alderman-webb in #6658
• Remove setuptools from requirements-testing.txt by @alexander-alderman-webb in #6618
• Remove executing from requirements-testing.txt by @alexander-alderman-webb in #6619
• Remove asttokens from requirements-testing.txt by @alexander-alderman-webb in #6615
• Remove responses from requirements-testing.txt by @alexander-alderman-webb in #6621
• Remove pytest-forked from requirements-testing.txt by @alexander-alderman-webb in #6611
• Remove docker from requirements-testing.txt by @alexander-alderman-webb in #6616
• Add --skip-version-update option to populate_tox.py by @alexander-alderman-webb in #6675
• Remove httpcore from requirements-testing.txt by @alexander-alderman-webb in #6622
• Remove pytest-timeout from requirements-testing.txt by @alexander-alderman-webb in #6613
• Remove pytest-localserver from requirements-testing.txt by @alexander-alderman-webb in #6612
• Remove jsonschema from requirements-testing.txt by @alexander-alderman-webb in #6620
• Remove socksio from requirements-testing.txt by @alexander-alderman-webb in #6617
• Remove pysocks from requirements-testing.txt by @alexander-alderman-webb in #6623
• Remove brotli from requirements-testing.txt by @alexander-alderman-webb in #6614
• Remove tomli from requirements-testing.txt by @alexander-alderman-webb in #6630
• Remove pytest-watch from requirements-testing.txt by @alexander-alderman-webb in #6624
• Remove pip from requirements-testing.txt by @alexander-alderman-webb in #6629
• 🤖 Update test matrix with new releases (06/22) by @github-actions in #6610
• Pin test dependencies including package extras by @alexander-alderman-webb in #6607
• 🤖 Update test matrix with new releases (06/15) by @github-actions in #6567
• Bump deps for test-lambda-locally by @sl0thentr0py in #6594
• Catch pkg_resource warning by @sl0thentr0py in #6595

Other

• (test): exclude django 6.1 alphas and betas from tox by @ericapisani in #6690
• (test): need to include the alpha tag for mcp package inclusion by @ericapisani in #6688

Bug Fixes 🐛

Fastapi

• Prevent double wrapping of sync handlers on FastAPI >= 0.137 by @jhonny-on in #6569
• Use effective_route_context path for prefixed routers by @ericapisani in #6572

Other

• (asgi) Gate query string and client IP behind send_default_pii by @ericapisani in #6501
• (serializer) Avoid creating reference cycles on every call by @Malkiz223 in #6563
• (user) Set user.ip_address on telemetry if present by @sentrivana in #6555
• Remove 0000 trace_id fallbacks by @sl0thentr0py in #6570
• MANIFEST.in: Graft tests directory. by @charlesroelli in #6237

Internal Changes 🔧

• (fastapi) Verify request info capture with POST endpoints by @alexander-alderman-webb in #6287
• (starlette) Verify request info capture with POST endpoints by @alexander-alderman-webb in #6269

New Features ✨

• Add integration for aiomysql by @tonal in #4703

  We're adding support for the aiomysql package. To enable the integration, add it to your integrations list:

  import sentry_sdk
  from sentry_sdk.integrations.aiomysql import AioMySQLIntegration
  
  sentry_sdk.init(
      traces_sample_rate=1.0,
      integrations=[AioMySQLIntegration()],
  )

• Support HTTPX2 by @sentrivana in #6463

  We're adding out-of-the-box support for HTTPX2. As long as use the package, the Sentry integration
  will be enabled automatically and you should see your requests instrumented in Sentry.

  import httpx2
  import sentry_sdk
  
  sentry_sdk.init(...)
  
  with sentry_sdk.start_transaction(name="testing_sentry"):
      httpx2.get("https://sentry.io/")

Bug Fixes 🐛

• (arq) Never capture control flow exceptions by @alexander-alderman-webb in #6507
• (client) Guard against dotless qualified_name in _setup_instrumentation by @devteamaegis in #6452
• (pydantic-ai) Only use hooks when ModelRequestContext.model exists by @alexander-alderman-webb in #6480
• (rq) Restore functools.wraps() for patched functions by @alexander-alderman-webb in #6532
• (tracing_utils) Handle baggage values containing '=' in from_incoming_header by @devteamaegis in #6450
• (utils) Handle image_url string shorthand in _is_image_type_with_blob_content by @devteamaegis in #6478

Internal Changes 🔧

• (arq) Only pin fakeredis<2.36.0 in tests by @alexander-alderman-webb in #6444
• (flaky) Change env for flaky test detector by @sl0thentr0py in #6492
• (pydantic-ai) Create event loop before invoking sync methods by @alexander-alderman-webb in #6475
• Use package-ecosystem: uv in dependabot by @sentrivana in #6522
• 🤖 Update test matrix with new releases (06/08) by @github-actions in #6519
• Raise minimum supported aiomysql version and update text matrix by @alexander-alderman-webb in #6496
• Deprecate OpenTelemetryIntegration in favor of OTLPIntegration and no-op for span first by @sl0thentr0py in #6494
• 🤖 Update test matrix with new releases (06/03) by @github-actions in #6489
• Raise update-tox timeout to 20 minutes by @alexander-alderman-webb in #6488
• Prevent grpcio-tools source builds when generating test matrices by @alexander-alderman-webb in #6487
• Add weekly flaky test detector workflow by @sl0thentr0py in #6484
• Pin transitive dependencies for tests on Python>=3.8 by @alexander-alderman-webb in #6437
• Install uv in update-tox job by @alexander-alderman-webb in #6453
• Only pin setuptools in relevant tests by @alexander-alderman-webb in #6467

Internal Changes 🔧

Rq

• Pin fakeredis<2.36.0 in tests by @alexander-alderman-webb in #6454
• Unpin redis and fakeredis for tests by @alexander-alderman-webb in #6443

Other

• (aiohttp) Unfurl spans explicitly instead of using pop() by @sentrivana in #6435
• (tox) Migrate from pip to uv via tox-uv by @sentry-junior in #6390
• Pin redis<8 for rq by @sl0thentr0py in #6438