2.52.0

New Features ✨

Other

• feat(integration): add gen_ai.conversation.id if available by @constantinius in #5307

Bug Fixes 🐛

Google Genai

• fix(google-genai): Token reporting by @alexander-alderman-webb in #5404
• fix(google-genai): deactivate google genai when langchain is used by @shellmayr in #5389

Mcp

• fix(mcp): Nest MCP spans under HTTP transactions by @alexander-alderman-webb in #5292
• fix(mcp): Handle all awaitable return types by @alexander-alderman-webb in #5415

Other

• fix(anthropic): Token reporting by @alexander-alderman-webb in #5403
• fix(arq): handle settings_cls passed as keyword argument by @nc9 in #5393
• fix(dramatiq): cleanup isolated scope and transaction when message is skipped by @frankie567 in #5346
• fix(openai): Token reporting by @alexander-alderman-webb in #5406
• fix(openai-agents): Inject propagation headers for HostedMCPTool when streaming by @alexander-alderman-webb in #5405
• fix: Fix list attribute type by @sentrivana in #5417
• fix: Adapt to new packaging in toxgen by @sentrivana in #5382

Internal Changes 🔧

Fastmcp

• test(fastmcp): Wrap prompt in Message by @alexander-alderman-webb in #5411
• test(fastmcp): Remove test_fastmcp_without_request_context() by @alexander-alderman-webb in #5412
• test(fastmcp): Use AsyncClient for SSE by @alexander-alderman-webb in #5400
• test(fastmcp): Use TestClient for Streamable HTTP by @alexander-alderman-webb in #5384
• test(fastmcp): Simulate stdio transport with memory streams by @alexander-alderman-webb in #5333

Mcp

• test(mcp): Use AsyncClient for SSE by @alexander-alderman-webb in #5396
• test(mcp): Use TestClient for Streamable HTTP by @alexander-alderman-webb in #5383
• test(mcp): Remove unused stdio helpers by @alexander-alderman-webb in #5409
• test(mcp): Simulate stdio transport with memory streams by @alexander-alderman-webb in #5329

Other

• ci: Fix lint step by @sentrivana in #5418
• ci: 🤖 Update test matrix with new releases (02/02) by @github-actions in #5413
• ci: Update tox and pin packaging version for tox by @alexander-alderman-webb in #5381
• ci: migration to the new codecov action by @MathurAditya724 in #5392

Other

• Revert "feat(ai): Add original input length meta attribute (#5375)" by @alexander-alderman-webb in #5419

2.52.0a2

New Features ✨

Span Streaming

• feat(span-streaming): Add spans to telemetry pipeline, add span name and attributes (3) by @sentrivana in #5399
• feat(span-streaming): Add span batcher (2) by @sentrivana in #5398

Internal Changes 🔧

• test(mcp): Simulate stdio transport with memory streams by @alexander-alderman-webb in #5329

Other

• [do not merge] feat: Span streaming & new span API by @sentrivana in #5317

2.52.0a1

New Features ✨

Openai

• feat(openai): Set system instruction attribute for Responses API by @alexander-alderman-webb in #5376
• feat(openai): Set system instruction attribute for Completions API by @alexander-alderman-webb in #5358

Other

• feat(ai): Add original input length meta attribute by @alexander-alderman-webb in #5375
• feat(openai-agents): Set system instruction attribute on gen_ai.chat spans by @alexander-alderman-webb in #5370
• feat(span-streaming): Add experimental trace_lifecycle switch (1) by @sentrivana in #5397
• feat(transport): Report 413 responses for oversized envelopes by @alexander-alderman-webb in #5380

Bug Fixes 🐛

• fix(ai): Keep single content input message by @alexander-alderman-webb in #5345
• fix(arq): handle settings_cls passed as keyword argument by @nc9 in #5393
• fix(dramatiq): cleanup isolated scope and transaction when message is skipped by @frankie567 in #5346
• fix(google-genai): deactivate google genai when langchain is used by @shellmayr in #5389

Internal Changes 🔧

• ci: migration to the new codecov action by @MathurAditya724 in #5392
• ref: Replace set_data_normalized() with Span.set_data() for system instructions by @alexander-alderman-webb in #5374

Other

• [do not merge] feat: Span streaming & new span API by @sentrivana in #5317
• Update CHANGELOG.md by @alexander-alderman-webb in 8517eb0a
• release: 2.51.0 by @alexander-alderman-webb in 93e89e4c

2.51.0

New Features ✨

Openai

• feat(openai): Set system instruction attribute for Responses API by @alexander-alderman-webb in #5376
• feat(openai): Set system instruction attribute for Completions API by @alexander-alderman-webb in #5358
• feat(integrations): OpenAI/OpenAI Agents detect and report the time to first token metric (TTFT) as gen_ai.response.time_to_first_token by @constantinius in #5348

Openai Agents

• feat(openai-agents): Set system instruction attribute on gen_ai.chat spans by @alexander-alderman-webb in #5370
• feat(openai-agents): Set system instruction attribute by @alexander-alderman-webb in #5355
• feat(integrations): openai-agents streaming support by @constantinius in #5291

Other

• feat(ai): Add original input length meta attribute by @alexander-alderman-webb in #5375
• feat(anthropic): Set system instruction attribute by @alexander-alderman-webb in #5353
• feat(asyncio): Allow to turn task spans off by @sentrivana in #5367
• feat(gen_ai): add function set_conversation_id and managing functions on the Scope and apply it on the Span on .finish() by @constantinius in #5362
• feat(google-genai): Set system instruction attribute by @alexander-alderman-webb in #5354
• feat(langchain): Set system instruction attribute by @alexander-alderman-webb in #5357
• feat(pydantic-ai): Set system instruction attribute by @alexander-alderman-webb in #5356
• feat(transport): Report 413 responses for oversized envelopes by @alexander-alderman-webb in #5380

Bug Fixes 🐛

• fix(ai): Keep single content input message by @alexander-alderman-webb in #5345

Internal Changes 🔧

• ci(release): Fix changelog-preview permissions by @BYK in #5368
• ref: Replace set_data_normalized() with Span.set_data() for system instructions by @alexander-alderman-webb in #5374
• ci: Fix path in AI integration tests by @alexander-alderman-webb in #5347

2.51.0a1

New Features ✨

Integrations

• feat(integrations): OpenAI/OpenAI Agents detect and report the time to first token metric (TTFT) as gen_ai.response.time_to_first_token by @constantinius in #5348
• feat(integrations): openai-agents streaming support by @constantinius in #5291

Other

• feat(anthropic): Set system instruction attribute by @alexander-alderman-webb in #5353
• feat(asyncio): Allow to turn task spans off by @sentrivana in #5367
• feat(gen_ai): add function set_conversation_id and managing functions on the Scope and apply it on the Span on .finish() by @constantinius in #5362
• feat(google-genai): Set system instruction attribute by @alexander-alderman-webb in #5354
• feat(langchain): Set system instruction attribute by @alexander-alderman-webb in #5357
• feat(openai-agents): Set system instruction attribute by @alexander-alderman-webb in #5355
• feat(pydantic-ai): Set system instruction attribute by @alexander-alderman-webb in #5356

Internal Changes 🔧

• ci(release): Fix changelog-preview permissions by @BYK in #5368
• ci: Fix path in AI integration tests by @alexander-alderman-webb in #5347

Other

• [do not merge] feat: Span streaming & new span API by @sentrivana in #5317

2.50.0

New Features ✨

Ai

• feat(ai): add cache writes for gen_ai by @shellmayr in #5319
• feat(ai): add parse_data_uri function to parse a data URI by @constantinius in #5311

Other

• feat(asyncio): Add on-demand way to enable AsyncioIntegration by @sentrivana in #5288

  You can now enable the AsyncioIntegration on demand, after calling sentry_sdk.init(). This is useful in scenarios where you don't have
  the event loop running early on, or when you need to instrument multiple event loops.

import sentry_sdk
from sentry_sdk.integrations.asyncio import enable_asyncio_integration

# Initializing the SDK as early as possible, when there is no event loop yet
sentry_sdk.init(
    ...
    # No AsyncioIntegration in explicitly provided `integrations`
)

async def main():
    enable_asyncio_integration()  # instruments the current event loop
    # ...your code...

• feat(openai-agents): Inject propagation headers for HostedMCPTool by @alexander-alderman-webb in #5297
• feat(stdlib): Handle proxy tunnels in httlib integration by @sl0thentr0py in #5303
• feat: Support array types for logs and metrics attributes by @alexander-alderman-webb in #5314

Bug Fixes 🐛

Integrations

• fix(integrations): google genai report image inputs by @constantinius in #5337
• fix(integrations): google-genai: reworked gen_ai.request.messages extraction from parameters by @constantinius in #5275
• fix(integrations): pydantic-ai: properly format binary input message parts to be conformant with the gen_ai.request.messages structure by @constantinius in #5251
• fix(integrations): Anthropic: add content transformation for images and documents by @constantinius in #5276
• fix(integrations): langchain add multimodal content transformation functions for images, audio, and files by @constantinius in #5278

Litellm

• fix(litellm): fix gen_ai.request.messages to be as expected by @constantinius in #5255
• fix(litellm): Guard against module shadowing by @alexander-alderman-webb in #5249

Other

• fix(ai): redact message parts content of type blob by @constantinius in #5243
• fix(clickhouse): Guard against module shadowing by @alexander-alderman-webb in #5250
• fix(gql): Revert signature change of patched gql.Client.execute by @alexander-alderman-webb in #5289
• fix(grpc): Derive interception state from channel fields by @alexander-alderman-webb in #5302
• fix(pure-eval): Guard against module shadowing by @alexander-alderman-webb in #5252
• fix(ray): Guard against module shadowing by @alexander-alderman-webb in #5254
• fix(threading): Handle channels shadowing by @sentrivana in #5299
• fix(typer): Guard against module shadowing by @alexander-alderman-webb in #5253
• fix: Stop suppressing exception chains in AI integrations by @alexander-alderman-webb in #5309
• fix: Send client reports for span recorder overflow by @sentrivana in #5310

Documentation 📚

• docs(metrics): Remove experimental notice by @alexander-alderman-webb in #5304
• docs: Update Python versions banner in README by @sentrivana in #5287

Internal Changes 🔧

Fastmcp

• test(fastmcp): Narrow AttributeError try-except by @alexander-alderman-webb in #5339
• test(fastmcp): Stop accessing non-existent attribute by @alexander-alderman-webb in #5338

Release

• ci(release): Bump Craft version to fix issues by @BYK in #5305
• ci(release): Switch from action-prepare-release to Craft by @BYK in #5290

Other

• chore(gen_ai): add auto-enablement for google genai by @shellmayr in #5295
• chore(repo): Add Claude Code settings with basic permissions by @philipphofmann in #5342
• ci: 🤖 Update test matrix with new releases (01/19) by @github-actions in #5330
• ci: Add periodic AI integration tests by @alexander-alderman-webb in #5313
• chore: Use pull_request_target for changelog preview by @BYK in #5323
• chore: add unlabeled trigger to changelog-preview by @BYK in #5315
• chore: Add type for metric units by @sentrivana in #5312
• ci: Update tox and handle generic classifiers by @sentrivana in #5306

2.49.0

New Features ✨

• feat(api): Add Scope.set_attribute by @sentrivana in #5256

Bug Fixes 🐛

• fix(grpc): Gate third-party imports by @alexander-alderman-webb in #5246
• fix(opentelemetry): Gate third-party imports by @alexander-alderman-webb in #5247
• fix(ray): Keep variadic kwargs last in signatures by @alexander-alderman-webb in #5244
• fix(trytond): Gate third-party imports by @alexander-alderman-webb in #5245
• Fix openai count_tokens by @sl0thentr0py in #5281

Documentation 📚

• docs: Fix typo in comment by @sentrivana in #5280
• docs: Fix middleware_spans docstring by @sentrivana in #5279

Internal Changes 🔧

• ref(scope): Set global attrs on global scope by @sentrivana in #5259
• chore: Ignore type migration for scripts/ and tests/ in blame by @alexander-alderman-webb in #5284
• ref: Properly override parent func by @sentrivana in #5283
• ci: Allow to use Craft's new auto-versioning by @sentrivana in #5218
• ref: Deduplicate batchers by @sentrivana in #5263
• tests: Add dedicated transport format test for metrics, logs by @sentrivana in #5264
• ci: 🤖 Update test matrix with new releases (01/05) by @github-actions in #5273
• tests: General logs tests should use Sentry logs API by @sentrivana in #5262
• tests: Test preserialization of attributes by @sentrivana in #5260
• ci: Unpin Pydantic 1.x version in tests by @alexander-alderman-webb in #5261
• ref: Make logs, metrics go via scope by @sentrivana in #5213
• ci: Fix failing arq, fastapi tests on 3.7; update test matrix by @sentrivana in #5258

2.48.0

Middleware spans are now disabled by default in Django, Starlette and FastAPI integrations. Set the middleware_spans integration-level
option to capture individual spans per middleware layer. To record Django middleware spans, for example, configure as follows

  import sentry_sdk
  from sentry_sdk.integrations.django import DjangoIntegration

  sentry_sdk.init(
      dsn="<your-dsn>",
      integrations=[
          DjangoIntegration(middleware_spans=True),
      ],
  )

New Features ✨

• feat(ai): add single message truncation by @shellmayr in #5079

• feat(django): Add span around Task.enqueue by @sentrivana in #5209

• feat(starlette): Set transaction name when middleware spans are disabled by @alexander-alderman-webb in #5223

• feat: Add "K_REVISION" to environment variable release check (exposed by cloud run) by @rpradal in #5222

Langgraph

• feat(langgraph): Response model attribute on invocation spans by @alexander-alderman-webb in #5212
• feat(langgraph): Usage attributes on invocation spans by @alexander-alderman-webb in #5211

OTLP

• feat(otlp): Optionally capture exceptions from otel's Span.record_exception api by @sl0thentr0py in #5235
• feat(otlp): Implement new Propagator.inject for OTLPIntegration by @sl0thentr0py in #5221

Bug Fixes 🐛

Integrations

• fix(django): Set active thread ID when middleware spans are disabled by @alexander-alderman-webb in #5220

• fix(integrations): openai-agents fixing the input messages structure which was wrapped too much in some cases by @constantinius in #5203

• fix(integrations): openai-agents fix multi-patching of get_model function by @constantinius in #5195

• fix(integrations): add values for pydantic-ai and openai-agents to _INTEGRATION_DEACTIVATES to prohibit double span creation by @constantinius in #5196

• fix(logs): Set span_id instead of sentry.trace.parent_span_id attribute by @sentrivana in #5241

• fix(logs, metrics): Gate metrics, logs user attributes behind send_default_pii by @sentrivana in #5240

• fix(pydantic-ai): Stop capturing internal exceptions by @alexander-alderman-webb in #5237

• fix(ray): Actor class decorator with arguments by @alexander-alderman-webb in #5230

• fix: Don't log internal exception for tornado user auth by @sl0thentr0py in #5208

• fix: Fix changelog config by @sentrivana in #5192

Internal Changes 🔧

• chore(django): Disable middleware spans by default by @alexander-alderman-webb in #5219

• chore(starlette): Disable middleware spans by default by @alexander-alderman-webb in #5224

• ci: Unpin Python version for LiteLLM tests by @alexander-alderman-webb in #5238

• ci: 🤖 Update test matrix with new releases (12/15) by @github-actions in #5229

• chore: Ignore type annotation migration in blame by @alexander-alderman-webb in #5234

• ref: Clean up get_active_propagation_context by @sl0thentr0py in #5217

• ref: Cleanup outgoing propagation_context logic by @sl0thentr0py in #5215

• ci: Pin Python version to at least 3.10 for LiteLLM by @alexander-alderman-webb in #5202

• test: Remove skipped test by @sentrivana in #5197

• Convert all remaining type annotations into the modern format by @zsol in #5239

• Convert sentry_sdk type annotations into the modern format by @zsol in #5206

2.47.0

Bug Fixes 🐛

• fix: Make PropagationContext.from_incoming_data always return a PropagationContext by @sl0thentr0py in #5186
• fix(integrations): anthropic set GEN_AI_OPERATION_NAME by @constantinius in #5185
• fix(spotlight): align behavior with SDK spec by @BYK in #5169
• fix(integrations): do not exit early when config is not passed as it is not required and prohibits setting gen_ai.request.messages by @constantinius in #5167
• fix(langchain): add gen_ai.response.model to chat spans by @shellmayr in #5159
• fix(integrations): add the system prompt to the gen_ai.request.messages attribute by @constantinius in #5161
• fix(ai): Handle Pydantic model classes in _normalize_data by @skalinchuk in #5143
• fix(openai-agents): Avoid double span exit on exception by @alexander-alderman-webb in #5174
• fix(openai-agents): Store invoke_agent span on agents.RunContextWrapper by @alexander-alderman-webb in #5165
• Add back span status by @sl0thentr0py in #5147

New Features ✨

• feat(integrations): openai-agents: add usage and response model reporting for chat and invoke_agent spans by @constantinius in #5157
• feat: Implement strict_trace_continuation by @sl0thentr0py in #5178
• feat(integration): pydantic-ai: properly report token usage and response model for invoke_agent spans by @constantinius in #5153
• feat(integrations): add support for embed_content methods in GoogleGenAI integration by @constantinius in #5128
• feat(logs): Record discarded log bytes by @alexander-alderman-webb in #5144
• feat: Add an initial changelog config by @sentrivana in #5145
• feat(django): Instrument database rollbacks by @alexander-alderman-webb in #5115
• feat(django): Instrument database commits by @alexander-alderman-webb in #5100
• feat(openai-agents): Truncate long messages by @alexander-alderman-webb in #5141
• Add org_id support by @sl0thentr0py in #5166

Deprecations

• Deprecate continue_from_headers by @sl0thentr0py in #5160

Build / dependencies / internal 🔧

• Remove unsupported SPANSTATUS.(ERROR|UNSET) by @sl0thentr0py in #5146
• Rename setup_otlp_exporter to setup_otlp_traces_exporter by @sl0thentr0py in #5142
• Simplify continue_trace to reuse propagation_context values by @sl0thentr0py in #5158
• Make PropagationContext hold baggage instead of dynamic_sampling_context by @sl0thentr0py in #5156
• Cleanup PropagationContext.from_incoming_data by @sl0thentr0py in #5155
• chore: Add commit_patterns to changelog config, remove auto-labeler by @sentrivana in #5176
• build(deps): bump actions/github-script from 7 to 8 by @dependabot in #5171
• build(deps): bump supercharge/redis-github-action from 1.8.1 to 2 by @dependabot in #5172
• ci: 🤖 Update test matrix with new releases (12/01) by @github-actions in #5173
• ci: Add auto-label GH action by @sentrivana in #5163
• ci: Split up Test AI workflow by @alexander-alderman-webb in #5148
• ci: Update test matrix with new releases (11/24) by @alexander-alderman-webb in #5139
• test: Import integrations with empty shadow modules by @alexander-alderman-webb in #5150
• Add deprecations to changelog categories by @sentrivana in #5162

2.46.0

Various fixes & improvements

• Preserve metadata on wrapped coroutines (#5105) by @alexander-alderman-webb
• Make imports defensive to avoid ModuleNotFoundError in Pydantic AI integration (#5135) by @alexander-alderman-webb
• Fix OpenAI agents integration mistakenly enabling itself (#5132) by @sentrivana
• Add instrumentation to embedding functions for various backends (#5120) by @constantinius
• Improve embeddings support for OpenAI (#5121) by @constantinius
• Enhance input handling for embeddings in LiteLLM integration (#5127) by @constantinius
• Expect exceptions when re-raised (#5125) by @alexander-alderman-webb
• Remove MagicMock from mocked ModelResponse (#5126) by @alexander-alderman-webb