4.0.0

This major release includes many exciting new features including support for Profiling and Metrics(preview), AOT with Native Crash Reporting, Spotlight, Screenshots on MAUI and much more. Details about these features and other changes are below.

.NET target framework changes

We're dropping support for some of the old target frameworks, please check this GitHub Discussion for details on why.

• Replace support for .NET Framework 4.6.1 with 4.6.2 (#2786)

  .NET Framework 4.6.1 was announced on Nov 30, 2015. And went out of support over a year ago, on Apr 26, 2022.

• Drop .NET Core 3.1 and .NET 5 support (#2787)

• Dropped netstandard2.0 support for Sentry.AspNetCore (#2807)

• Replace support for .NET 6 on mobile (e.g: net6.0-android) with .NET 7 (#2624)

  .NET 6 on mobile has been out of support since May 2023 and with .NET 8, it's no longer possible to build .NET 6 Mobile specific targets.
  For that reason, we're moving the mobile-specific TFMs from net6.0-platform to net7.0-platform.

  Mobile apps still work on .NET 6 will pull the Sentry .NET 6, which offers the .NET-only features,
  without native/platform-specific bindings and SDKs. See this ticket for more details.

• MAUI dropped Tizen support (#2734)

Sentry Self-hosted Compatibility

If you're using sentry.io this change does not affect you.
This SDK version is compatible with a self-hosted version of Sentry 22.12.0 or higher. If you are using an older version of self-hosted Sentry (aka on-premise), you will need to upgrade.

Significant change in behavior

• Transaction names for ASP.NET Core are now consistently named HTTP-VERB /path (e.g. GET /home). Previously, the leading forward slash was missing for some endpoints. (#2808)
• Setting SentryOptions.Dsn to null now throws ArgumentNullException during initialization. (#2655)
• Enable CaptureFailedRequests by default (#2688)
• Added Sentry namespace to global usings when ImplicitUsings is enabled (#3043)
  If you have conflicts, you can opt out by adding the following to your csproj:

<PropertyGroup>
  <SentryImplicitUsings>false</SentryImplicitUsings>
</PropertyGroup>

• Transactions' spans are no longer automatically finished with the status deadline_exceeded by the transaction. This is now handled by the Relay.
  • Customers self hosting Sentry must use verion 22.12.0 or later (#3013)
• The User.IpAddress is now set to {{auto}} by default, even when sendDefaultPII is disabled (#2981)
  • The "Prevent Storing of IP Addresses" option in the "Security & Privacy" project settings on sentry.io can be used to control this instead
• The DiagnosticLogger signature for LogWarning changed to take the exception as the first parameter. That way it no longer gets mixed up with the TArgs. (#2987)

API breaking Changes

If you have compilation errors you can find the affected types or overloads missing in the changelog entries below.

Changed APIs

• Class renamed Sentry.User to Sentry.SentryUser (#3015)
• Class renamed Sentry.Runtime to Sentry.SentryRuntime (#3016)
• Class renamed Sentry.Span to Sentry.SentrySpan (#3021)
• Class renamed Sentry.Transaction to Sentry.SentryTransaction (#3023)
• Rename iOS and MacCatalyst platform-specific options from Cocoa to Native (#2940)
• Rename iOS platform-specific options EnableCocoaSdkTracing to EnableTracing (#2940)
• Rename Android platform-specific options from Android to Native (#2940)
• Rename Android platform-specific options EnableAndroidSdkTracing and EnableAndroidSdkBeforeSend to EnableTracing and EnableBeforeSend respectively (#2940)
• Rename iOS and MacCatalyst platform-specific options from iOS to Cocoa (#2929)
• ITransaction has been renamed to ITransactionTracer. You will need to update any references to these interfaces in your code to use the new interface names (#2731, #2870)
• DebugImage and DebugMeta moved to Sentry.Protocol namespace. (#2815)
• SentryClient.Dispose is no longer obsolete (#2842)
• ISentryClient.CaptureEvent overloads have been replaced by a single method accepting optional Hint and Scope parameters. You will need to pass hint as a named parameter from code that calls CaptureEvent without passing a scope argument. (#2749)
• TransactionContext and SpanContext constructors were updated. If you're constructing instances of these classes, you will need to adjust the order in which you pass parameters to these. (#2694, #2696)
• The DiagnosticLogger signature for LogError and LogFatal changed to take the exception as the first parameter. That way it no longer gets mixed up with the TArgs. The DiagnosticLogger now also receives an overload for LogError and LogFatal that accepts a message only. (#2715)
• Distribution added to IEventLike. (#2660)
• StackFrame's ImageAddress, InstructionAddress, and FunctionId changed to long?. (#2691)
• DebugImage.ImageAddress changed to long?. (#2725)
• Contexts now inherit from IDictionary rather than ConcurrentDictionary. The specific dictionary being used is an implementation detail. (#2729)
• The method used to configure a Sentry Sink for Serilog now has an additional overload. Calling WriteTo.Sentry() with no arguments will no longer attempt to initialize the SDK (it has optional arguments to configure the behavior of the Sink only). If you want to initialize Sentry at the same time you configure the Sentry Sink then you will need to use the overload of this method that accepts a DSN as the first parameter (e.g. WriteTo.Sentry("https://[email protected]:65535/2147483647")). (#2928)

Removed APIs

• SentrySinkExtensions.ConfigureSentrySerilogOptions is now internal. If you were using this method, please use one of the SentrySinkExtensions.Sentry extension methods instead. (#2902)
• A number of [Obsolete] options have been removed (#2841)
  • BeforeSend - use SetBeforeSend instead.
  • BeforeSendTransaction - use SetBeforeSendTransaction instead.
  • BeforeBreadcrumb - use SetBeforeBreadcrumb instead.
  • CreateHttpClientHandler - use CreateHttpMessageHandler instead.
  • ReportAssemblies - use ReportAssembliesMode instead.
  • KeepAggregateException - this property is no longer used and has no replacement.
  • DisableTaskUnobservedTaskExceptionCapture method has been renamed to DisableUnobservedTaskExceptionCapture.
  • DebugDiagnosticLogger - use TraceDiagnosticLogger instead.
• A number of iOS/Android-specific [Obsolete] options have been removed (#2856)
  • Distribution - use SentryOptions.Distribution instead.
  • EnableAutoPerformanceTracking - use SetBeforeSendTransaction instead.
  • EnableCoreDataTracking - use EnableCoreDataTracing instead.
  • EnableFileIOTracking - use EnableFileIOTracing instead.
  • EnableOutOfMemoryTracking - use EnableWatchdogTerminationTracking instead.
  • EnableUIViewControllerTracking - use EnableUIViewControllerTracing instead.
  • StitchAsyncCode - no longer available.
  • ProfilingTracesInterval - no longer available.
  • ProfilingEnabled - use ProfilesSampleRate instead.
• Obsolete SystemClock constructor removed, use SystemClock.Clock instead. (#2856)
• Obsolete `Runtime.Clone...

4.0.0-beta.9

Features

• Added support for capturing built in metrics from the System.Diagnostics.Metrics API (#3052)

Significant change in behavior

• Added Sentry namespace to global usings when ImplicitUsings is enabled (#3043)
  If you have conflicts, you can opt-out by adding the following to your csproj:

<PropertyGroup>
  <SentryImplicitUsings>false</SentryImplicitUsings>
</PropertyGroup>

Features

• SentrySdk.Metrics.Set now additionally accepts string as value (#3092)
• Timing metrics can now be captured with SentrySdk.Metrics.StartTimer (#3075)

Fixes

• Fixed an issue with tag values in metrics not being properly serialized (#3065)
• Moved the binding to MAUI events for breadcrumb creation from WillFinishLaunching to FinishedLaunching. This delays the initial instantiation of app. (#3057)
• The SDK no longer adds the WinUIUnhandledExceptionIntegration on non Windows platforms (#3055)
• The scope transaction is now correctly set for Otel transactions (#3072)
• Native integration logging on macOS (#3079)
• Native linking of cURL library when targeting platform-specific TFMs (e.g. net8.0-macos) (#3080)

Dependencies

• Bump Java SDK from v7.1.0 to v7.2.0 (#3049)
  • changelog
  • diff
• Bump CLI from v2.25.0 to v2.26.0 (#3059, #3062, #3073)
  • changelog
  • diff
• Bump Cocoa SDK from v8.18.0 to v8.19.0 (#3084)
  • changelog
  • diff

3.41.4

Fixes

• Fixed an issue when using the SDK together with Open Telemetry 1.5.0 and newer where the SDK would create transactions for itself. The fix is backwards compatible. (#3001)

4.0.0-beta.8

Features

• Experimental pre-release availability of Metrics. We're exploring the use of Metrics in Sentry. The API will very likely change and we don't yet have any documentation. (#2949)

Significant change in behavior

• Transactions' spans are no longer automatically finished with status deadline_exceeded by the transaction. This is now handled by the Relay.
  • Customers self hosting Sentry must use verion 22.12.0 or later (#3013)

API breaking Changes

Changed APIs

• Class renamed Sentry.User to Sentry.SentryUser (#3015)
• Class renamed Sentry.Runtime to Sentry.SentryRuntime (#3016)
• Class renamed Sentry.Span to Sentry.SentrySpan (#3021)
• Class renamed Sentry.Transaction to Sentry.SentryTransaction (#3023)

Dependencies

• Bump CLI from v2.23.2 to v2.25.0 (#3012, #3030)
  • changelog
  • diff
• Bump Native SDK from v0.6.7 to v0.7.0 (#3029)
  • changelog
  • diff

4.0.0-beta.7

Features

• MAUI Screenshot support. You can opt-in via SentryMauiOptions.AttachScreenshots (#2965)
  • Supports Android and iOS only. Windows is not supported.
• MAUI: App context has in_foreground indicating whether app was on the background or foreground. (#2983)

Fixes

• Fixed an issue when using the SDK together with Open Telemetry 1.5.0 and newer where the SDK would create transactions for itself. The fix is backwards compatible. (#3001)

Significant change in behavior

• The User.IpAddress is now set to {{auto}} by default, even when sendDefaultPII is disabled (#2981)
  • The "Prevent Storing of IP Addresses" option in the "Security & Privacy" project settings on sentry.io can be used to control this instead
• The DiagnosticLogger signature for LogWarning changed to take the exception as the first parameter. That way it does no longer get mixed up with the TArgs. (#2987)

Dependencies

• Bump Cocoa SDK from v8.17.1 to v8.17.2 (#2972)
  • changelog
  • diff
• Bump Java SDK from v7.0.0 to v7.1.0 (#2979)
  • changelog
  • diff
• Bump CLI from v2.23.0 to v2.23.1 (#2985)
  • changelog
  • diff

4.0.0-beta.6

Feature

• Support for Spotlight. Debug tool for local development. (#2961)
  • Enable it with option EnableSpotlight
  • Optionally configure the URL to connect via SpotlightUrl. Defaults to http://localhost:8969/stream.

4.0.0-beta.5

Features

• iOS profiling support (alpha). (#2930)

Fixes

• Stop Sentry for MacCatalyst from creating default.profraw in the app bundle using xcodebuild archive to build sentry-cocoa (#2960)

Dependencies

• Bump CLI from v2.22.3 to v2.23.0 (#2956)
  • changelog
  • diff

4.0.0-beta.4

Fixes

• Workaround a .NET 8 NativeAOT crash on transaction finish. (#2943)

API breaking Changes

Changed APIs

• Rename iOS and MacCatalyst platform specific options from Cocoa to Native (#2940)
• Rename iOS platform specific options EnableCocoaSdkTracing to EnableTracing (#2940)
• Rename Android platform specific options from Android to Native (#2940)
• Rename Android platform specific options EnableAndroidSdkTracing and EnableAndroidSdkBeforeSend to EnableTracing and EnableBeforeSend respectively (#2940)

Dependencies

• Bump Cocoa SDK from v8.17.0 to v8.17.1 (#2936)
  • changelog
  • diff

4.0.0-beta.3

Fixes

• Reworked automatic breadcrumb creation for MAUI. (#2900)
  • The SDK no longer uses on reflection to bind to all public element events. This also fixes issues where the SDK would consume third-party events.
  • Added CreateElementEventsBreadcrumbs to the SentryMauiOptions to allow users to opt-in automatic breadcrumb creation for BindingContextChanged, ChildAdded, ChildRemoved and ParentChanged on Element.
  • Reduced amount of automatic breadcrumbs by limiting the amount of bindings created in VisualElement, Window, Shell, Page and Button.
• Fixed Sentry SDK has not been initialised when using ASP.NET Core, Serilog and OpenTelemetry (#2911)

Features

• Native crash reporting on NativeAOT published apps (Windows, Linux, macOS). (#2887)
• Android: By default attaches LogCat logs to unhandled exceptions. Configurable via SentryOptions.Android.LogCatIntegration and SentryOptions.Android.LogCatMaxLines. Available when targeting net7.0-android or later, on API level 23 or later. (#2926)

API breaking Changes

Removed APIs

• SentrySinkExtensions.ConfigureSentrySerilogOptions is now internal. If you were using this method, please use one of the SentrySinkExtensions.Sentry extension methods instead. (#2902)

Changed APIs

• AssemblyExtensions have been made public again. (#2917)
• Rename iOS and MacCatalyst platform specific options from iOS to Cocoa (#2929)

Dependencies

• Bump Cocoa SDK from v8.16.1 to v8.17.0 (#2910)
  • changelog
  • diff
• Bump CLI from v2.22.2 to v2.22.3 (#2915)
  • changelog
  • diff
• Bump Native SDK from v0.6.5 to v0.6.7 (#2914)
  • changelog
  • diff
• Bump Java SDK from v6.34.0 to v7.0.0 (#2932)
  • changelog
  • diff

3.41.3

Fixes

• Fixed Sentry SDK has not been initialised when using ASP.NET Core, Serilog and OpenTelemetry (#2918)