API Changes

• Removed net6.0 and net7.0 TFMs as Microsoft has stopped supporting both of these now. If you need to target net6.0 or net7.0 then we recommend using version 4.x of the .NET SDK for Sentry. (#3807)
• Sentry's Experimental Metrics feature has been deprecated and removed from the SDK. (#3718)
• SentryOptions.EnableTracing has been removed. Instead, tracing should be enabled or disabled by setting the SentryOptions.TracesSampleRate or by using SentryOptions.TracesSampler to configure a sampling function (#3569)
• Temporarily removed experimental Session Replay support (#3827)
• You should no longer pass AndroidContext as an argument to SentrySdk.Init (#3562)
• The SentryUser.Segment property has been deprecated. Consider sending this as a tag or additional data instead (#3563)
• The ITraceContext now includes an Origin, which is set automatically and is primarily used internally by the Sentry server (#3564)
• Device.BatteryLevel and Device.ProcessorFrequency are now stored as floats rather than ints, to align with the Cocoa and Java SDKs (#3567)
• The FailedRequestTargets, TagFilters and TracePropagationTargets options have all been changed from SubstringOrRegexPattern to IList<StringOrRegex> (#3566)
• Scope.Transaction is now always stored as an AsyncLocal also in Global Mode, to prevent auto-instrumented spans from the UI ending up parented to transactions from a background task (or vice versa). (#3596)

Features

• Added support for .NET 9 (#3699)
• Heap dumps can be captured automatically when memory usage exceeds a configurable threshold. Note that this API is still experimental and may change based on user feedback. (#3667)
• libsentrysupplemental.so now supports 16 KB page sizes on Android (#3723)
• Added SentryOptions extension for profiling: options.AddProfilingIntegration() (#3660)

Fixes

• Address Trim warnings to enable AOT support, including support for MAUI specifically. (#3841)
• Fixed JNI Error when accessing Android device data from multiple threads (#3802)
• Android - fix bug that prevents logcat.log from getting attached to unhandled events (SIGSEGV Segfault) (#3694)
• Fixed ArgumentNullException in FormRequestPayloadExtractor when handling invalid form data on ASP.NET (#3734)
• Fixed NullReferenceException in SentryTraceHeader when parsing null or empty values (#3757)
• Fix "System.ArgumentOutOfRangeException: Specified argument was out of the range of valid values. (Parameter 'idData')" error propagating OpenTelemetry span ids (#3850)
• ArgumentNullException in FormRequestPayloadExtractor when handling invalid form data on ASP.NET (#3734)
• Fixed crash when using NLog with FailedRequestStatusCodes options in a Maui app with Trimming enabled (#3743)

Dependencies

• Bump CLI from v2.38.2 to v2.39.1 (#3782) (#3799)
  • changelog
  • diff
• Bump Java SDK from v7.16.0 to v7.19.0 (#3749, #3771) (#3805, #3844)
  • changelog
  • diff
• Bump Cocoa SDK from v8.36.0 to v8.39.0 (#3727)
  • changelog
  • diff
• Bump Native SDK from v0.7.11 to v0.7.16 (#3731, #3770, #3775, #3779) (#3825)
  • changelog
  • diff

API Changes

• You should no longer pass AndroidContext as an argument to SentrySdk.Init (#3562)
• The SentryUser.Segment property has been deprecated. Consider sending this as a tag or additional data instead (#3563)
• The ITraceContext now includes an Origin, which is set automatically and is primarily used internally by the Sentry server (#3564)
• Device.BatteryLevel and Device.ProcessorFrequency are now stored as floats rather than ints, to align with the Cocoa and Java SDKs (#3567)
• SentryOptions.EnableTracing has been removed. Instead, tracing should be enabled or disabled by setting the SentryOptions.TracesSampleRate or by using SentryOptions.TracesSampler to configure a sampling function (#3569)
• The FailedRequestTargets, TagFilters and TracePropagationTargets options have all been changed from SubstringOrRegexPattern to IList<StringOrRegex> (#3566)
• Scope.Transaction is now always stored as an AsyncLocal also in Global Mode, to prevent auto-instrumented spans from the UI ending up parented to transactions from a background task (or vice versa). (#3596)
• Heap dumps can be captured automatically when memory usage exceeds a configurable threshold (#3667)
• Sentry's Experimental Metrics feature has been deprecated and removed from the SDK. (#3718)

Features

• Added support for .NET 9 (preview) (#3699)
• libsentrysupplemental.so now supports 16 KB page sizes on Android (#3723)
• Added SentryOptions extension for profiling: options.AddProfilingIntegration() (#3660)

Fixes

• Fixed NullReferenceException in SentryTraceHeader when parsing null or empty values (#3757)
• ArgumentNullException in FormRequestPayloadExtractor when handling invalid form data on ASP.NET (#3734)
• Crash when using NLog with FailedRequestStatusCodes options in a Maui app with Trimming enabled (#3743)

Dependencies

• Bump Cocoa SDK from v8.36.0 to v8.39.0 (#3727)
  • changelog
  • diff
• Bump Java SDK from v7.16.0 to v7.18.0 (#3749, #3771)
  • changelog
  • diff
• Bump Native SDK from v0.7.11 to v0.7.15 (#3731, #3770, #3775, #3779)
  • changelog
  • diff
• Bump CLI from v2.38.2 to v2.39.0 (#3782)
  • changelog
  • diff

Features

• Limited experimental support for Session Replay Recording on Android (#3552)

Fixes

• When using OTel and ASP.NET Core the SDK could try to process OTel spans after the SDK had been closed (#3726)

Dependencies

• Bump CLI from v2.38.1 to v2.38.2 (#3728)
  • changelog
  • diff

Features

• Android - allow logcat attachments to be previewed in Sentry (#3711)
• Added a SetBeforeScreenshotCapture callback to the options: allowing the user to set an action before the screenshot is taken (#3661)
• Make Sentry.AspNetCore.Blazor.WebAssembly generally available. (#3674)

Fixes

• Events from NDK on Android will report sdk.name sentry.native.android.dotnet (#3682)

Dependencies

• Bump Java SDK from v7.14.0 to v7.16.0 (#3670, #3707)
  • changelog
  • diff
• Bump CLI from v2.37.0 to v2.38.1 (#3702, #3720)
  • changelog
  • diff
• Bumped System.Text.Json from v6.0.8 to v6.0.10 (#3704)
• Bump Native SDK from v0.7.10 to v0.7.11 (#3715)
  • changelog
  • diff

Fixes

• Android - fix bug that prevents logcat.log from getting attached to unhandled event (SIGSEGV Segfault) (#3694)
• Events from NDK on Android will report sdk.name sentry.native.android.dotnet (#3682)

Features

• Added a SetBeforeScreenshotCapture callback to the options: allowing the user to set an action before the screenshot is taken (#3661)
• Make Sentry.AspNetCore.Blazor.WebAssembly generally available. (#3674)

Dependencies

• Bump Java SDK from v7.14.0 to v7.16.0 (#3670, #3707)
  • changelog
  • diff
• Bump CLI from v2.37.0 to v2.38.0 (#3702)
  • changelog
  • diff
• Bumped System.Text.Json from v6.0.8 to v6.0.10 (#3704)

Fixes

• Fixed "Failed to persist session" error on iOS (#3655)

Dependencies

• Bump CLI from v2.36.5 to v2.37.0 (#3647, #3664)
  • changelog
  • diff

Support for Xcode 16.0 (BREAKING CHANGE)

If you are using Xcode 16.0, you will need to update the SDK to this version (4.12.0) or later.
If you are still using Xcode 15.4 or earlier, you need to continue to use the previous version (4.11.0) or earlier.

Using Xcode 16 to build .NET applications targeting iOS and Mac Catalyst requires .NET workload for iOS SDK version 18.0.8303. We built the SDK version 4.12.0 using Xcode 16 in order to support this scenario. That, unfortunately, breaks folks using older version of Xcode.

As such, if you are using SDK version 4.12.x and targeting iOS or Mac Catalyst, you will need to install and use Xcode 16 and workload iOS SDK 18.0.8303

Note that .NET 9 will also support Xcode 16, when it is released next month (Nov 2024).

API Changes

• The SentrySdk.Metrics module is deprecated and will be removed in the next major release.
  Sentry will reject all metrics sent after October 7, 2024.
  Learn more: https://sentry.zendesk.com/hc/en-us/articles/26369339769883-Upcoming-API-Changes-to-Metrics (#3619)

Fixes

• Fixed duplicate key exception for Hangfire jobs with AutomaticRetry (#3631)

Features

• Added a flag to options DisableFileWrite to allow users to opt-out of all file writing operations. Note that toggling this will affect features such as offline caching and auto-session tracking and release health as these rely on some file persistency (#3614, #3641)

Dependencies

• Bump Native SDK from v0.7.9 to v0.7.10 (#3623)
  • changelog
  • diff
• Bump CLI from v2.36.1 to v2.36.5 (#3624, #3634, #3642, #3644)
  • changelog
  • diff
• Update Perfview/TraceEvent to e343a0c (#3492)

Features

• All exceptions are now added as breadcrumbs on future events. Previously this was only the case for exceptions captured via the Sentry.SeriLog or Sentry.Extensions.Logging integrations. (#3584)

Fixes

• On mobile devices, the SDK no longer throws a FormatException for ProcessorFrequency when trying to report native events (#3541)
• Add missing org parameter to the CLI release operations (#3600)

API Changes

• When the Sentry SDK is disabled, SentrySdk.StartTransaction() now returns a NoOpTransaction, which avoids unnecessary memory allocations (#3581)

Dependencies

• Bump Cocoa SDK from v8.35.0 to v8.36.0 (#3570, #3575)
  • changelog
  • diff
• Bump CLI from v2.33.1 to v2.36.1 (#3578, #3599, #3603, #3606)
  • changelog
  • diff
• Bump Native SDK from v0.7.8 to v0.7.9 (#3577)
  • changelog
  • diff

Various fixes & improvements

• fix: Prevent deadlock in Hub.Dispose (#3539) by @bitsandfoxes
• build(deps): bump github/codeql-action from 3.26.0 to 3.26.2 (#3543) by @dependabot

Fixes

• Unfinished spans are now correctly stored and retrieved by the CachingTransport (#3533)

Dependencies

• Bump Cocoa SDK from v8.33.0 to v8.34.0 (#3535)
  • changelog
  • diff