BREAKING CHANGES

• This release adds support for .NET 10 and drops support for net8.0-android, net8.0-ios, net8.0-maccatalyst and net8.0-windows10.0.19041.0 (#4461)
• Backpressure handling is now enabled by default, meaning that the SDK will monitor system health and reduce the sampling rate of events and transactions when the system is under load. When the system is determined to be healthy again, the sampling rates are returned to their original levels. (#4615)
• Remove SentryLoggingOptions.ExperimentalLogging.MinimumLogLevel. Structured Logs can now be configured via the "Sentry" logging provider (e.g. in appsettings.json and appsettings.{HostEnvironment}.json) (#4700)
• All logging provider types are internal now in order to ensure configuration as intended (#4700)
• Rename SentryLog.ParentSpanId to SentryLog.SpanId reflecting the protocol change (#4778)
• QOL improvement: Spans and Transactions now implement IDisposable so that they can be used with using statements/declarations that will automatically finish the span with a status of OK when it passes out of scope, if it has not already been finished, to be consistent with Activity classes when using OpenTelemetry (#4627)
• SpanTracer and TransactionTracer are still public but these are now sealed (see also #4627)
• The Structured Logs APIs are now stable: removed Experimental from SentryOptions (#4699)
• Added support for v3 of the Android AssemblyStore format that is used in .NET 10 and dropped support for v1 that was used in .NET 8 (#4583)
• CaptureFeedback now returns a SentryId and a CaptureFeedbackResult out parameter that indicate whether feedback was captured successfully and what the reason for failure was otherwise (#4613)
• Deprecated Sentry.Azure.Functions.Worker as very few people were using it and the functionality can easily be replaced with OpenTelemetry. We've replaced our integration with a sample showing how to do this using our OpenTelemetry package instead. (#4693)
• UWP support has been dropped. Future efforts will likely focus on WinUI 3, in line with Microsoft's recommendations for building Windows UI apps. (#4686)
• BreadcrumbLevel.Critical has been renamed to BreadcrumbLevel.Fatal for consistency with the other Sentry SDKs (#4605)
• SentryOptions.IsEnvironmentUser now defaults to false on MAUI. The means the User.Name will no longer be set, by default, to the name of the device (#4606)
• Removed obsolete APIs (#4619)
  • Removed the unusual constructor from Sentry.Maui.BreadcrumbEvent that had been marked as obsolete. That constructor expected a IEnumerable<(string Key, string Value)>[] argument (i.e. an array of IEnumerable of tuples). If you were using this constructor, you should instead use the alternate constructor that expects just an IEnumerable of tuples: IEnumerable<(string Key, string Value)>.
  • Removed SentrySdk.CaptureUserFeedback and all associated members. Use the newer SentrySdk.CaptureFeedback instead.
• ScopeExtensions.Populate is now internal (#4611)

Features

• Support for .NET 10 (#4461)
• Added a new SDK Sentry.Extensions.AI which allows LLM usage instrumentation via Microsoft.Extensions.AI (#4657)
• Added experimental support for Session Replay on iOS (#4664)
• Add support for Structured Logs in Sentry.Google.Cloud.Functions (#4700)
• QOL features for Unity
  • The SDK now provides a IsSessionActive to allow checking the session state (#4662)
  • The SDK now makes use of the new SessionEndStatus Unhandled when capturing an unhandled but non-terminal exception, i.e. through the UnobservedTaskExceptionIntegration (#4633, #4653)
• Extended the App context by app_memory that can hold the amount of memory used by the application in bytes. (#4707)
• Add support for W3C traceparent header for outgoing requests (#4661)
  • This feature is disabled by default. Set PropagateTraceparent = true when initializing the SDK if to include the W3C traceparent header on outgoing requests.
  • See https://develop.sentry.dev/sdk/telemetry/traces/distributed-tracing/#w3c-trace-context-header for more details.

Fixes

• Memory leak when finishing an unsampled Transaction that has started unsampled Spans (#4717)
• Sentry Tracing middleware crashed ASP.NET Core in .NET 10 in 6.0.0-rc.1 and earlier (#4747)
• Captured Http Client Errors on .NET 5+ now include a full stack trace in order to improve Issue grouping (#4724)
• Deliver system breadcrumbs in the main thread on Android (#4671)
• The Serilog integration captures Structured Logs (when enabled) independently of captured Events and added Breadcrumbs (#4691)
• Minimum Log-Level for Structured Logs, Breadcrumbs and Events in all Logging-Integrations (#4700)
  • for Sentry.Extensions.Logging, Sentry.AspNetCore, Sentry.Maui and Sentry.Google.Cloud.Functions
  • the Logger-Provider for Breadcrumbs and Events ignores Logging-Configuration (e.g. via appsettings.json)
    • use the intended SentryLoggingOptions.MinimumBreadcrumbLevel, SentryLoggingOptions.MinimumEventLevel, or add filter functions via SentryLoggingOptionsExtensions.AddLogEntryFilter
  • the Logger-Provider for Structured Logs respects Logging-Configuration (e.g. via appsettings.json)
    • when enabled by SentryOptions.EnableLogs
• Avoid appending /NODEFAULTLIB:MSVCRT to NativeAOT linker arguments on Windows when targetting non-Windows platforms (Android, Browser) (#4760)
• The SDK avoids redundant scope sync after transaction finish (#4623)
• sentry-native is now automatically disabled for WASM applications (#4631)
• Remove unnecessary files from SentryCocoaFramework before packing (#4602)

Dependencies

• Bump Java SDK from v8.24.0 to v8.28.0 (#4728, #4761, #4791)
  • changelog
  • diff
• Bump Native SDK from v0.12.0 to v0.12.2 (#4690, #4737, #4780)
  • changelog
  • diff
• Bump Cocoa SDK from v8.57.1 to v8.57.3 (#4704, #4738)
  • changelog
  • diff
• Bump CLI from v2.57.0 to v2.58.2 (#4705, #4727, #4732)
  • changelog
  • diff

Fixes

• Captured Http Client Errors on .NET 5+ now include a full stack trace in order to improve Issue grouping (#4724)
• Sentry Tracing middleware crashed ASP.NET Core in .NET 10 in 6.0.0-rc.1 and earlier (#4747)

Dependencies

• Bump Java SDK from v8.24.0 to v8.26.0 (#4728)
  • changelog
  • diff

BREAKING CHANGES

• This release adds support for .NET 10 and drops support for net8.0-android, net8.0-ios, net8.0-maccatalyst and net8.0-windows10.0.19041.0 (#4461)

• Backpressure handling is now enabled by default, meaning that the SDK will monitor system health and reduce the sampling rate of events and transactions when the system is under load. When the system is determined to be healthy again, the sampling rates are returned to their original levels. (#4615)

• QOL improvement: Spans and Transactions now implement IDisposable so that they can be used with using statements/declarations that will automatically finish the span with a status of OK when it passes out of scope, if it has not already been finished, to be consistent with Activity classes when using OpenTelemetry (#4627)

• Add support for W3C traceparent header for outgoing requests (#4661)
  This feature is disabled by default. Set PropagateTraceparent = true when initializing the SDK if to include the W3C traceparent header on outgoing requests.

• The Structured Logs APIs are now stable: removed Experimental from SentryOptions (#4699)

• Added support for v3 of the Android AssemblyStore format that is used in .NET 10 and dropped support for v1 that was used in .NET 8 (#4583)

• CaptureFeedback now returns a SentryId and a CaptureFeedbackResult out parameter that indicate whether feedback was captured successfully and what the reason for failure was otherwise (#4613)

• Deprecated Sentry.Azure.Functions.Worker as very few people were using it and the functionality can easily be replaced with OpenTelemetry. We've replaced our integration with a sample showing how to do this using our OpenTelemetry package instead. (#4693)

• UWP support has been dropped. Future efforts will likely focus on WinUI 3, in line with Microsoft's recommendations for building Windows UI apps. (#4686)

• BreadcrumbLevel.Critical has been renamed to BreadcrumbLevel.Fatal for consistency with the other Sentry SDKs (#4605)

• SentryOptions.IsEnvironmentUser now defaults to false on MAUI. The means the User.Name will no longer be set, by default, to the name of the device (#4606)

• Remove unnecessary files from SentryCocoaFramework before packing (#4602)

• Removed obsolete APIs (#4619)

  • Removed the unusual constructor from Sentry.Maui.BreadcrumbEvent that had been marked as obsolete. That constructor expected a IEnumerable<(string Key, string Value)>[] argument (i.e. an array of IEnumerable of tuples). If you were using this constructor, you should instead use the alternate constructor that expects just an IEnumerable of tuples: IEnumerable<(string Key, string Value)>.
  • Removed SentrySdk.CaptureUserFeedback and all associated members. Use the newer SentrySdk.CaptureFeedback instead.

• SpanTracer and TransactionTracer are still public but these are now sealed (see also #4627)

• ScopeExtensions.Populate is now internal (#4611)

  See https://develop.sentry.dev/sdk/telemetry/traces/distributed-tracing/#w3c-trace-context-header for more details.

Features

• Support for .NET 10 (#4461)
• Added experimental support for Session Replay on iOS (#4664)
• QOL features for Unity
  • The SDK now provides a IsSessionActive to allow checking the session state (#4662)
  • The SDK now makes use of the new SessionEndStatus Unhandled when capturing an unhandled but non-terminal exception, i.e. through the UnobservedTaskExceptionIntegration (#4633, #4653)
• Implemented instance isolation so that multiple instances of the Sentry SDK can be instantiated inside the same process when using the Caching Transport (#4498)
• Extended the App context by app_memory that can hold the amount of memory used by the application in bytes. (#4707)

Fixes

• Memory leak when finishing an unsampled Transaction that has started unsampled Spans (#4717)
• Deliver system breadcrumbs in the main thread on Android (#4671)
• The Serilog integration captures Structured Logs (when enabled) independently of captured Events and added Breadcrumbs (#4691)
• The SDK avoids redundant scope sync after transaction finish (#4623)
• sentry-native is now automatically disabled for WASM applications (#4631)

Dependencies

• Bump Java SDK from v8.24.0 to v8.25.0 (#4679)
  • changelog
  • diff
• Bump Native SDK from v0.12.0 to v0.12.1 (#4690, #4737)
  • changelog
  • diff
• Bump Cocoa SDK from v8.57.1 to v8.57.2 (#4704)
  • changelog
  • diff
• Bump CLI from v2.57.0 to v2.58.2 (#4705, #4727, #4732)
  • changelog
  • diff

Fixes

• Do not allow multiple sentry.proguard-uuid metadata to be set in Android manifest (#4647)

Dependencies

• Bump Cocoa SDK from v8.56.2 to v8.57.1 (#4637, #4680)
  • changelog
  • diff
• Bump Native SDK from v0.11.2 to v0.12.0 (#4636, #4678)
  • changelog
  • diff
• Bump Java SDK from v8.23.0 to v8.24.0 (#4667)
  • changelog
  • diff
• Bump CLI from v2.56.1 to v2.57.0 (#4668)
  • changelog
  • diff

BREAKING CHANGES

• BreadcrumbLevel.Critical has been renamed to BreadcrumbLevel.Fatal for consistency with the other Sentry SDKs (#4605)

• SentryOptions.IsEnvironmentUser now defaults to false on MAUI. The means the User.Name will no longer be set, by default, to the name of the device (#4606)

• Remove unnecessary files from SentryCocoaFramework before packing (#4602)

• Removed obsolete APIs (#4619)

  • Removed the unusual constructor from Sentry.Maui.BreadcrumbEvent that had been marked as obsolete. That constructor expected a IEnumerable<(string Key, string Value)>[] argument (i.e. an array of IEnumerable of tuples). If you were using this constructor, you should instead use the alternate constructor that expects just an IEnumerable of tuples: IEnumerable<(string Key, string Value)>.
  • Removed SentrySdk.CaptureUserFeedback and all associated members. Use the newer SentrySdk.CaptureFeedback instead.

• Backpressure handling is now enabled by default, meaning that the SDK will monitor system health and reduce the sampling rate of events and transactions when the system is under load. When the system is determined to be healthy again, the sampling rates are returned to their original levels. (#4615)

• ScopeExtensions.Populate is now internal (#4611)

• Add support for W3C traceparent header for outgoing requests (#4661)
  This feature is disabled by default. When enabled, outgoing requests will include the W3C traceparent header.

  SentrySdk.Init(options =>
  {
      // ...
      options.PropagateTraceparent = true;
  });

  See https://develop.sentry.dev/sdk/telemetry/traces/distributed-tracing/#w3c-trace-context-header for more details.

Fixes

• The SDK avoids redundant scope sync after transaction finish (#4623)
• sentry-native is now automatically disabled for WASM applications (#4631)

Fixes

• Structured Logs now have a sentry.origin attribute to so it's clearer where these come from (#4566)

Dependencies

• Bump Java SDK from v8.22.0 to v8.23.0 (#4586)
  • changelog
  • diff
• Bump Native SDK from v0.11.1 to v0.11.2 (#4590)
  • changelog
  • diff
• Bump CLI from v2.56.0 to v2.56.1 (#4625)
  • changelog
  • diff

BREAKING CHANGES

• This release adds support for .NET 10 and drops support for net8.0-android, net8.0-ios, net8.0-maccatalyst and net8.0-windows10.0.19041.0 (#4461)
• Added support for v3 of the Android AssemblyStore format that is used in .NET 10 and dropped support for v1 that was used in .NET 8 (#4583)

Features

• Added EnableBackpressureHandling option for Automatic backpressure handling. When enabled this automatically reduces the sample rate when the SDK detects events being dropped. (#4452)
• Add (experimental) Structured Logs integration for Serilog (#4462)

Fixes

• Templates are no longer sent with Structured Logs that have no parameters (#4544)
• Parent-Span-IDs are no longer sent with Structured Logs when recorded without an active Span (#4565)
• Upload linked PDBs to fix non-IL-stripped symbolication for iOS (#4527)
• In MAUI Android apps, generate and inject UUID to APK and upload ProGuard mapping to Sentry with the UUID (#4532)
• Fixed WASM0001 warning when building Blazor WebAssembly projects (#4519)

API Changes

• Remove ExperimentalAttribute from all Structured Logs APIs, and remove Experimental property from SentrySdk, but keep Experimental property on SentryOptions (#4567)

Dependencies

• Bump Cocoa SDK from v8.56.0 to v8.56.2 (#4555, #4572)
  • changelog
  • diff
• Bump Native SDK from v0.11.0 to v0.11.1 (#4557)
  • changelog
  • diff
• Bump CLI from v2.54.0 to v2.56.0 (#4556, #4577)
  • changelog
  • diff
• Bump Java SDK from v8.21.1 to v8.22.0 (#4552)
  • changelog
  • diff

Fixes

• Fail when building Blazor WASM with Profiling. We don't support profiling in Blazor WebAssembly projects. (#4512)
• Do not overwrite user IP if it is set manually in ASP.NET sdk (#4513)
• Fix SentryOptions.Native.SuppressSignalAborts and SuppressExcBadAccess on iOS (#4521)

Dependencies

• Bump Cocoa SDK from v8.55.1 to v8.56.0 (#4528)
  • changelog
  • diff
• Bump CLI from v2.53.0 to v2.54.0 (#4541)
  • changelog
  • diff
• Bump Native SDK from v0.10.1 to v0.11.0 (#4542)
  • changelog
  • diff

Fixes

• Fail when building Blazor WASM with Profiling. We don't support profiling in Blazor WebAssembly projects. (#4512)
• Do not overwrite user IP if it is set manually in ASP.NET sdk (#4513)
• Fix SentryOptions.Native.SuppressSignalAborts and SuppressExcBadAccess on iOS (#4521)
• Partial workaround for MAX_PATH issues when building iOS applications from Windows (#4533)

Dependencies

• Bump Cocoa SDK from v8.55.1 to v8.56.0 (#4528)
  • changelog
  • diff