Sentry.AspNetCore

Features

• Extended the SDK's CheckIn support by adding Release, Environment and Trace ID to the event. CheckIns created via the Hangfire integration now also automatically report their duration (#3320)
• The SDK's performance API now works in conjunction with OpenTelemetry's instrumentation. This means that SentrySpans and OTel spans now show up in the same span-tree. (#3288)

Fixes

• HttpResponse.Content is no longer disposed by when using SentryHttpFailedRequestHandler on .NET Framework, which was causing an ObjectDisposedException when using Sentry with NSwag (#3306)
• Fix BackgroundWorker exiting when OperationCanceledException is not from shutdown request (3284)
• Envelopes with large attachments no longer get stuck in the queue when using CacheDirectoryPath (#3328)

Dependencies

• Bump Cocoa SDK from v8.21.0 to v8.25.0 (#3339)
  • changelog
  • diff

Features

• Metrics now honor any Rate Limits set in HTTP headers returned by Sentry (#3276)

Fixes

• Fixed normalization for metric tag values for carriage return, line feed and tab characters (#3281)

Dependencies

• Bump Java SDK from v7.7.0 to v7.8.0 (#3275)
  • changelog
  • diff

Features

• EnableNetworkEventBreadcrumbs can now be set on the Native Android options (#3267)
• Update normalization of metrics keys, tags and values (#3271)

Fixes

• Fix missing exception StackTraces in some situations (#3215)
• Scopes now get applied to OTEL spans in ASP.NET Core (#3221)
• Fixed InvalidCastException when setting the SampleRate on Android (#3258)
• Fixed MAUI iOS build issue related to SentryVersionNumber and SentryVersionString (#3278)

API changes

• Removed SentryOptionsExtensions class - all the public methods moved directly to SentryOptions (#3195)

Dependencies

• Bump CLI from v2.30.0 to v2.31.0 (#3214, #3218, #3242, #3247)
  • changelog
  • diff
• Bump Native SDK from v0.7.0 to v0.7.2 (#3237, #3256)
  • changelog
  • diff
• Bump Java SDK from v7.6.0 to v7.7.0 (#3268)
  • changelog
  • diff

Fixes

• Dynamic Sampling Context not propagated correctly for HttpClient spans (#3208)

Features

• ASP.NET Core: Blocking call detection. An event with the stack trace of the blocking call will be captured as event. (#2709)
  • IMPORTANT: Verify this in test/staging before prod! Blocking calls in hot paths could create a lot of events for your Sentry project.
  • Opt-in via options.CaptureBlockingCalls = true
  • Disabled for specific code blocks with using (new SuppressBlockingDetection())
  • Doesn't detect everything. See original Caveats described by Ben Adams.
• Added Crons support via SentrySdk.CaptureCheckIn and an integration with Hangfire (#3128)
• Common tags set automatically for metrics and metrics summaries are attached to Spans (#3191)

API changes

• Removed ScopeExtensions class - all the public methods moved directly to Scope (#3186)

Fixes

• The Sentry Middleware on ASP.NET Core no longer throws an exception after having been initialized multiple times (#3185)
• Empty strings are used instead of underscores to replace invalid metric tag values (#3176)
• Filtered OpenTelemetry spans are garbage collected correctly (#3198)

Dependencies

• Bump Java SDK from v7.3.0 to v7.6.0 (#3164, #3204)
  • changelog
  • diff
• Bump Cocoa SDK from v8.20.0 to v8.21.0 (#3194)
  • changelog
  • diff
• Bump CLI from v2.28.6 to v2.30.0 (#3193, #3203)
  • changelog
  • diff

Fixes

• Metric unit names are now sanitized correctly. This was preventing some built in metrics from showing in the Sentry dashboard (#3151)
• The Sentry OpenTelemetry integration no longer throws an exception with the SDK disabled (#3156)

Fixes

• The SDK can be disabled by setting options.Dsn = ""; By convention, the SDK allows the DSN set to string.Empty to be overwritten by the environment. (#3147)

Dependencies

• Bump CLI from v2.28.0 to v2.28.6 (#3145, #3148)
  • changelog
  • diff

Features

• The SDK now automatically collects metrics coming from OpenTelemetry.Instrumentation.Runtime (#3133)

Fixes

• "No service for type 'Sentry.IHub' has been registered" exception when using OpenTelemetry and initializing Sentry via SentrySdk.Init (#3129)

Fixes

• To resolve conflicting types due to the SDK adding itself to the global usings:
  • The class Sentry.Constants has been renamed to Sentry.SentryConstants (#3125)

Fixes

• To resolve conflicting types due to the SDK adding itself to the global usings:
  • The class Sentry.Context has been renamed to Sentry.SentryContext (#3121)
  • The class Sentry.Package has been renamed to Sentry.SentryPackage (#3121)
  • The class Sentry.Request has been renamed to Sentry.SentryRequest (#3121)

Dependencies

• Bump CLI from v2.27.0 to v2.28.0 (#3119)
  • changelog
  • diff

Fixes

• To resolve conflicting types due to the SDK adding itself to the global usings:
  • The interface Sentry.ISession has been renamed to Sentry.ISentrySession (#3110)
  • The interface Sentry.IJsonSerializable has been renamed to Sentry.ISentryJsonSerializable (#3116)
  • The class Sentry.Session has been renamed to Sentry.SentrySession (#3110)
  • The class Sentry.Attachment has been renamed to Sentry.SentryAttachment (#3116)
  • The class Sentry.Hint has been renamed to Sentry.SentryHint (#3116)

Dependencies

• Bump Cocoa SDK from v8.19.0 to v8.20.0 (#3107)
  • changelog
  • diff

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://d4d82fc1c2c4032a83f3a29aa3a3aff@fake-sentry.io: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() removed, this shouldn't have been public in the past and has no replacement. (#2856)

• Obsolete SentryException.Data removed, use SentryException.Mechanism.Data instead. (#2856)

• Obsolete AssemblyExtensions removed, this shouldn't have been public in the past and has no replacement. (#2856)

• Obsolete SentryDatabaseLogging.UseBreadcrumbs() removed, it is called automatically and has no replacement. (#2856)

• Obsolete Scope.GetSpan() removed, use Span property instead. (#2856)

• Obsolete IUserFactory removed, use ISentryUserFactory instead. (#2856, #2840)

• IHasMeasurements has been removed, use ISpanData instead. (#2659)

• IHasBreadcrumbs has been removed, use IEventLike instead. (#2670)

• ISpanContext has been removed, use ITraceContext instead. (#2668)

• IHasTransactionNameSource has been removed, use ITransactionContext instead. (#2654)

• (#2694)

• The unused StackFrame.InstructionOffset has been removed. (#2691)

• The unused Scope.Platform property has been removed. (#2695)

• The obsolete setter Sentry.PlatformAbstractions.Runtime.Identifier has been removed (2764)

• Sentry.Values<T> is now internal as it is never exposed in the public API (#2771)

• The TracePropagationTarget class has been removed, use the SubstringOrRegexPattern class instead. (#2763)

• The WithScope and WithScopeAsync methods have been removed. We have discovered that these methods didn't work correctly in certain desktop contexts, especially when using a global scope. (#2717)

  Replace your usage of WithScope with overloads of Capture* methods:

  • SentrySdk.CaptureEvent(SentryEvent @event, Action<Scope> scopeCallback)
  • SentrySdk.CaptureMessage(string message, Action<Scope> scopeCallback)
  • SentrySdk.CaptureException(Exception exception, Action<Scope> scopeCallback)

  // Before
  SentrySdk.WithScope(scope =>
  {
    scope.SetTag("key", "value");
    SentrySdk.CaptureEvent(new SentryEvent());
  });
  
  // After
  SentrySdk.CaptureEvent(new SentryEvent(), scope =>
  {
    // Configure your scope here
    scope.SetTag("key", "value");
  });
  

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)
  • SentrySdk.Metrics.Set now additionally accepts string as value (#3092)
  • Timing metrics can now be captured with SentrySdk.Metrics.StartTimer (#3075)
  • Added support for capturing built-in metrics from the System.Diagnostics.Metrics API (#3052)
• Sentry.Profiling is now available as a package on nuget. Be aware that profiling is in alpha and on servers the overhead could be high. Improving the experience for ASP.NET Core is tracked on this issue (#2800)
  • iOS profiling support (alpha). (#2930)
• Native crash reporting on NativeAOT published apps (Windows, Linux, macOS). (#2887)
• Support for Spotlight, a debug tool for local development. (#2961)
  • Enable it with the option EnableSpotlight
  • Optionally configure the URL to connect via SpotlightUrl. Defaults to http://localhost:8969/stream.

MAUI

• Added screenshot capture support for errors. You can opt-in via SentryMauiOptions.AttachScreenshots (#2965)
  • Supports Android and iOS only. Windows is not supported.
• App context now has in_foreground, indicating whether the app was in the foreground or the background. (#2983)
• Android: When capturing unhandled exceptions, the SDK now can automatically attach LogCat to the event. You can opt-in via SentryOptions.Android.LogCatIntegration and configure SentryOptions.Android.LogCatMaxLines. (#2926)
  • Available when targeting net7.0-android or later, on API level 23 or later.

Native AOT

Native AOT publishing support for .NET 8 has been added to Sentry for the following platforms:

• Windows
• Linux
• macOS
• Mac Catalyst
• iOS

There are some functional differences when publishing Native AOT:

• StackTraceMode.Enhanced is ignored because it's not available when publishing Native AOT. The mechanism to generate these enhanced stack traces relies heavily on reflection which isn't compatible with trimming.
• Reflection cannot be leveraged for JSON Serialization and you may need to use SentryOptions.AddJsonSerializerContext to supply a serialization context for types that you'd like to send to Sentry (e.g. in the Span.Context). (#2732, #2793)
• Ben.Demystifier is not available as it only runs in JIT mode.
• WinUI applications: When publishing Native AOT, Sentry isn't able to automatically register an unhandled exception handler because that relies on reflection. You'll need to register the unhandled event handler manually instead.
• For Azure Functions Workers, when AOT/Trimming is enabled we can't use reflection to read route data from the HttpTrigger so the route name will always be /api/<FUNCTION_NAME> (#2920)

Fixes

• Native integration logging on macOS (#3079)
• The scope transaction is now correctly set for Otel transactions (#3072)
• 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)
• Stop Sentry for MacCatalyst from creating default.profraw in the app bundle using xcodebuild archive to build sentry-cocoa (#2960)
• Workaround a .NET 8 NativeAOT crash on transaction finish. (#2943)
• Reworked automatic breadcrumb creation for MAUI. (#2900)
  • The SDK no longer uses 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 number of bindings created in VisualElement, Window, Shell, Page, and Button.
• Fixed Sentry SDK has not been initialized when using ASP.NET Core, Serilog, and OpenTelemetry (#2911)
• Android native symbol upload (#2876)
• Sentry.Serilog no longer throws if a disabled DSN is provided when initializing Sentry via the Serilog integration (#2883)
• Don't add WinUI exception integration on mobile platforms (#2821)
• Transactions are now getting enriched by the client instead of the hub (#2838)
• Fixed an issue when using the SDK together with OpenTelemetry 1.5.0 and newer where the SDK would create transactions for itself. The fix is backward compatible. (#3001)

Dependencies

• Upgraded to NLog version 5. (#2697)

• Integrate sentry-native as a static library in Native AOT builds to enable symbolication. (#2704)

• Bump Cocoa SDK from v8.16.1 to v8.19.0 (#2910, #2936, #2972, #3005, #3084)

  • changelog
  • diff

• Bump Java SDK from v6.34.0 to v7.3.0 (#2932, #2979, #3049, (https://github.com/getsentry/sentry-dotnet/pull/3098))

  • changelog
  • diff

• Bump Native SDK from v0.6.5 to v0.6.7 (#2914, #3029)

  • changelog
  • diff

• Bump CLI from v2.21.5 to v2.27.0 (#2901, #2915, #2956, #2985, #2999, #3012, #3030, #3059, #3062, #3073, #3099)

  • changelog
  • diff

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 backward compatible. (#3001)

Fixes

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

Fixes

• The SDK no longer fails to finish sessions while capturing an event. This fixes broken crash-free rates (#2895)
• Ignore UnobservedTaskException for QUIC exceptions. See: https://github.com/dotnet/runtime/issues/80111 (#2894)

Dependencies

• Bump Cocoa SDK from v8.16.0 to v8.16.1 (#2891)
  • changelog
  • diff

Fixes

• CaptureFailedRequests and FailedRequestStatusCodes are now getting respected by the Cocoa SDK. This is relevant for MAUI apps where requests are getting handled natively. (#2826)
• Added SentryOptions.AutoRegisterTracing for users who need to control registration of Sentry's tracing middleware (#2871)

Dependencies

• Bump Cocoa SDK from v8.15.0 to v8.16.0 (#2812, #2816, #2882)
  • changelog
  • diff
• Bump CLI from v2.21.2 to v2.21.5 (#2811, #2834, #2851)
  • changelog
  • diff
• Bump Java SDK from v6.33.1 to v6.34.0 (#2874)
  • changelog
  • diff

Features

• Speed up SDK init (#2784)

Fixes

• Fixed chaining on the IApplicationBuilder for methods like UseRouting and UseEndpoints (#2726)

Dependencies

• Bump Cocoa SDK from v8.13.0 to v8.15.0 (#2722, #2740, #2746, #2801)
  • changelog
  • diff
• Bump Java SDK from v6.30.0 to v6.33.1 (#2723, #2741, #2783, #2803)
  • changelog
  • diff

Fixes

• ISentryUserFactory is now public so users can register their own implementations via DI (#2719)

Obsoletion

• WithScope and WithScopeAsync have been proven to not work correctly in desktop contexts when using a global scope. They are now deprecated in favor of the overloads of CaptureEvent, CaptureMessage, and CaptureException. Those methods provide a callback to a configurable scope. (#2677)
• StackFrame.InstructionOffset has not been used in the SDK and has been ignored on the server for years. (#2689)

Features

• Release of Azure Functions (Isolated Worker/Out-of-Process) support (#2686)

Fixes

• Scope is now correctly applied to Transactions when using OpenTelemetry on ASP.NET Core (#2690)

Dependencies

• Bump CLI from v2.20.7 to v2.21.2 (#2645, #2647, #2698)
  • changelog
  • diff
• Bump Cocoa SDK from v8.12.0 to v8.13.0 (#2653)
  • changelog
  • diff
• Bump Java SDK from v6.29.0 to v6.30.0 (#2685)
  • changelog
  • diff

Fixes

• Added Sentry.AspNet.csproj back to Sentry-CI-Build-macOS.slnf (#2612)

Features

• Added additional DB attributes to automatically generated spans like name and provider (#2583)
• Hints now accept attachments provided as a file path via AddAttachment method (#2585)

Fixes

• Resolved an issue where the SDK would throw an exception while attempting to set the DynamicSamplingContext but the context exists already. (#2592)

Dependencies

• Bump CLI from v2.20.5 to v2.20.6 (#2590)
  • changelog
  • diff
• Bump Cocoa SDK from v8.10.0 to v8.11.0 (#2594)
  • changelog
  • diff
• Bump Java SDK from v6.28.0 to v6.29.0 (#2599)
  • changelog
  • diff

Features

• Graphql client (#2538)

Fixes

• Android: Fix proguard/r8 mapping file upload (#2574)

Dependencies

• Bump Cocoa SDK from v8.9.5 to v8.10.0 (#2546, #2550)
  • changelog
  • diff
• Bump gradle/gradle-build-action from 2.7.0 to 2.7.1 (#2564)
  • diff

Fixes

• The SDK no longer creates transactions with their start date set to Jan 01, 001 (#2544)

Dependencies

• Bump CLI from v2.20.4 to v2.20.5 (#2539)
  • changelog
  • diff
• Bump Cocoa SDK from v8.9.4 to v8.9.5 (#2542)
  • changelog
  • diff

Features

• Distributed tracing now works independently of the performance feature. This allows you to connect errors to other Sentry instrumented applications (#2493)
• Added Sampling Decision to Trace Envelope Header (#2495)
• Add MinimumEventLevel to Sentry.Log4Net and convert events below it to breadcrumbs (#2505)
• Support transaction finishing automatically with 'idle timeout' (#2452)

Fixes

• Fixed baggage propagation when an exception is thrown from middleware (#2487)
• Fix Durable Functions preventing orchestrators from completing (#2491)
• Re-enable HubTests.FlushOnDispose_SendsEnvelope (#2492)
• Fixed SDK not sending exceptions via Blazor WebAssembly due to a PlatformNotSupportedException (#2506)
• Align SDK with docs regarding session update for dropped events (#2496)
• Introduced HttpMessageHandler in favor of the now deprecated HttpClientHandler on the options. This allows the SDK to support NSUrlSessionHandler on iOS (#2503)
• Using Activity.RecordException now correctly updates the error status of OpenTelemetry Spans (#2515)
• Fixed Transaction name not reporting correctly when using UseExceptionHandler (#2511)
• log4net logging Level.All now maps to SentryLevel.Debug (#2522)

Dependencies

• Bump Java SDK from v6.25.1 to v6.28.0 (#2484, #2498, #2517, #2533)
  • changelog
  • diff
• Bump CLI from v2.19.4 to v2.20.4 (#2509, #2518, #2527, #2530)
  • changelog
  • diff
• Bump Cocoa SDK from v8.8.0 to v8.9.4 (#2479, #2483, #2500, #2510, #2531)
  • changelog
  • diff

Features

• OpenTelemetry Support (#2453)
• Added a MSBuild property SentryUploadAndroidProguardMapping to automatically upload the Proguard mapping file when targeting Android (#2455)
• Symbolication for Single File Apps (#2425)
• Add binding to SwiftAsyncStacktraces on iOS (#2436)

Fixes

• Builds targeting Android with r8 enabled no longer crash during SDK init. The package now contains the required proguard rules (#2450)
• Fix Sentry logger options for MAUI and Azure Functions (#2423)

Dependencies

• Bump Cocoa SDK from v8.7.3 to v8.8.0 (#2427, #2430)
  • changelog
  • diff
• Bump CLI from v2.18.1 to v2.19.4 (#2428, #2431, #2451, #2454)
  • changelog
  • diff
• Bump Java SDK from v6.22.0 to v6.25.1 (#2429, #2440, #2458, #2476)
  • changelog
  • diff

Fixes

• SentryHttpMessageHandler added when AddHttpClient is before UseSentry (#2390)
• Set the native sdk name for Android (#2389)
• Fix db connection spans not finishing (#2398)
• Various .NET MAUI fixes / improvements (#2403)
  • The battery level was being reported incorrectly due to percentage multiplier.
  • The device architecture (x64, arm64, etc.) is now reported
  • On Windows, the OS type is now reported as "Windows" instead of "WinUI". Additionally, the OS display version (ex, "22H2") is now included.
  • UIKit, ABI.Microsoft and WinRT frames are now marked "system" instead of "in app".
• Reduce debug files uploaded (#2404)
• Fix system frames being marked as "in-app" (#2408)
  • NOTE: This important fix corrects a value that is used during issue grouping, so you may receive new alerts for existing issues after deploying this update.
• DB Connection spans presented poorly (#2409)
• Populate scope's Cookies property (#2411)
• Fix UWP GateKeeper errors (#2415)
• Fix sql client db name (#2418)

Dependencies

• Bump Cocoa SDK from v8.7.2 to v8.7.3 (#2394)
  • changelog
  • diff
• Bump Java SDK from v6.19.1 to v6.22.0 (#2395, #2405, #2417)
  • changelog
  • diff

Features

• .NET SDK changes for exception groups (#2287)
  • This changes how AggregateException is handled. Instead of filtering them out client-side, the SDK marks them as an "exception group", and adds includes data that represents the hierarchical structure of inner exceptions. Sentry now recognizes this server-side, improving the accuracy of the issue detail page.
  • Accordingly, the KeepAggregateException option is now obsolete and does nothing. Please remove any usages of KeepAggregateException.
  • NOTE: If running Self-Hosted Sentry, you should wait to adopt this SDK update until after updating to the 23.6.0 (est. June 2023) release of Sentry. The effect of updating the SDK early will be as if KeepAggregateException = true was set. That will not break anything, but may affect issue grouping and alerts.

Fixes

• Status messages when uploading symbols or sources are improved. (#2307)

Dependencies

• Bump CLI from v2.18.0 to v2.18.1 (#2386)
  • changelog
  • diff

Features

• Azure Functions (Isolated Worker/Out-of-Process) support (#2346)

  • Initial beta.1 release. Please give it a try and let us know how it goes!
  • Documentation is TBD. For now, see /samples/Sentry.Samples.Azure.Functions.Worker.

• Add Hint support (#2351)

  • Currently, this allows you to manipulate attachments in the various "before" event delegates.
  • Hints can also be used in event and transaction processors by implementing ISentryEventProcessorWithHint or ISentryTransactionProcessorWithHint, instead of ISentryEventProcessor or ISentryTransactionProcessor.
  • Note: Obsoletes the BeforeSend, BeforeSendTransaction, and BeforeBreadcrumb properties on the SentryOptions class. They have been replaced with SetBeforeSend, SetBeforeSendTransaction, and SetBeforeBreadcrumb respectively. Each one provides overloads both with and without a Hint object.

• Allow setting the active span on the scope (#2364)

  • Note: Obsoletes the Scope.GetSpan method in favor of a Scope.Span property (which now has a setter as well).

• Remove authority from URLs sent to Sentry (#2365)

• Add tag filters to SentryOptions (#2367)

Fixes

• Fix EnableTracing option conflict with TracesSampleRate (#2368)

  • NOTE: This is a potentially breaking change, as the TracesSampleRate property has been made nullable. Though extremely uncommon, if you are retrieving the TracesSampleRate property for some reason, you will need to account for nulls. However, there is no change to the behavior or typical usage of either of these properties.

• CachedTransport gracefully handles malformed envelopes during processing (#2371)

• Remove extraneous iOS simulator resources when building MAUI apps using Visual Studio "Hot Restart" mode, to avoid hitting Windows max path (#2384)

Dependencies

• Bump Cocoa SDK from v8.6.0 to v8.7.1 (#2359, #2370)
  • changelog
  • diff
• Bump Java SDK from v6.18.1 to v6.19.1 (#2374, #2381)
  • changelog
  • diff
• Bump Cocoa SDK from v8.6.0 to v8.7.2 (#2359, #2370, #2375)
  • changelog
  • diff
• Bump CLI from v2.17.5 to v2.18.0 (#2380)
  • changelog
  • diff

Features

• Initial work to support profiling in a future release. (#2206)
• Create a Sentry event for failed HTTP requests (#2320)
• Improve WithScope and add WithScopeAsync (#2303) (#2309)
• Build .NET Standard 2.1 for Unity (#2328)
• Add RemoveExceptionFilter, RemoveEventProcessor and RemoveTransactionProcessor extension methods on SentryOptions (#2331)
• Include Dynamic Sampling Context with error events, when there's a transaction (#2332)

Fixes

• Buffer payloads asynchronously when appropriate (#2297)
• Restore System.Reflection.Metadata dependency for .NET Core 3 (#2302)
• Capture open transactions on disabled hubs (#2319)
• Remove session breadcrumbs (#2333)
• Support synchronous HttpClient.Send in SentryHttpMessageHandler (#2336)
• Fix ASP.NET Core issue with missing context when using capture methods that configure scope (#2339)
• Improve debug file upload handling (#2349)

Dependencies

• Bump CLI from v2.17.0 to v2.17.5 (#2298, #2318, #2321, #2345)
  • changelog
  • diff
• Bump Cocoa SDK from v8.4.0 to v8.6.0 (#2310, #2344)
  • changelog
  • diff
• Bump Java SDK from v6.17.0 to v6.18.1 (#2338, #2343)
  • changelog
  • diff

Features

• Add FileDiagnosticLogger to assist with debugging the SDK (#2242)
• Attach stack trace when events have captured an exception without a stack trace (#2266)
• Add Scope.Clear and Scope.ClearBreadcrumbs methods (#2284)
• Improvements to exception mechanism data (#2294)

Fixes

• Normalize StackFrame in-app resolution for modules & function prefixes (#2234)
• Calling AddAspNet more than once should not block all errors from being sent (#2253)
• Fix Sentry CLI arguments when using custom URL or auth token parameters (#2259)
• Sentry.AspNetCore fix transaction name when path base is used and route starts with a slash (#2265)
• Fix Baggage header parsing in ASP.NET (Framework) (#2293)

Dependencies

• Bump Cocoa SDK from v8.3.0 to v8.4.0 (#2237, #2248, #2251, #2285)

  • changelog
  • diff

• Bump CLI from v2.14.4 to v2.17.0 (#2238, #2244, #2252, #2264, #2292)

  • changelog
  • diff

• Bump Java SDK from v6.15.0 to v6.17.0 (#2243, #2277)

  • changelog
  • diff

Fixes

• Get debug image for Full PDB format on Windows (#2222)
• Fix debug files not uploading for packages.config nuget (#2224)

Dependencies

• Bump Cocoa SDK from v8.2.0 to v8.3.0 (#2220)
  • changelog
  • diff

Notice: The <SentryUploadSymbols> MSBuild property previously defaulted to true for projects compiled in Release configuration. It is now false by default. To continue uploading symbols, you must opt-in by setting it to true. See the MSBuild Setup docs for further details.

Features

• Added basic functionality to support View Hierarchy (#2163)
• Allow SentryUploadSources to work even when not uploading symbols (#2197)
• Add support for BeforeSendTransaction (#2188)
• Add EnableTracing option to simplify enabling tracing (#2201)
• Make SentryUploadSymbols strictly opt-in (#2216)

Fixes

• Fix assembly not found on Android in Debug configuration (#2175)
• Fix context object with circular reference prevents event from being sent (#2210)

Dependencies

• Bump Java SDK from v6.13.1 to v6.15.0 (#2185, #2207)
  • changelog
  • diff
• Bump CLI from v2.12.0 to v2.14.4 (#2187, #2215)
  • changelog
  • diff
• Bump Java SDK from v6.13.1 to v6.14.0 (#2185)
  • changelog
  • diff
• Bump CLI from v2.12.0 to v2.14.3 (#2187, #2208)
  • changelog
  • diff
• Bump Cocoa SDK from v7.31.5 to v8.2.0 (#2203)
  • changelog
  • diff

Fixes

• Fix MAUI missing breadcrumbs for lifecycle and UI events (#2170)
• Fix hybrid sdk names (#2171)
• Fix ASP.NET sdk name (#2172)

Features

• Added instruction_addr_adjustment attribute to SentryStackTrace (#2151)

Fixes

• Workaround Visual Studio "Pair to Mac" issue (on Windows), and Update bundled Cocoa SDK to version 7.31.5 (#2164)
• Sentry SDK assemblies no longer have PDBs embedded. Debug symbols are uploaded to nuget.org as snupkg packages (#2166)

Dependencies

• Bump Java SDK from v6.13.0 to v6.13.1 (#2168)
  • changelog
  • diff

Fixes

• Fix Sentry CLI MSBuild for Xamarin and NetFX (#2154)
• Log aborted HTTP requests as debug instead of error (#2155)

Features

• Publish Sentry.Android.AssemblyReader as a separate nuget package (for reuse by Sentry.Xamarin) (#2127)
• Improvements for Sentry CLI integration (#2145)
• Update bundled Android SDK to version 6.13.0 (#2147)

Fixes

• Fix Sentry CLI integration on Windows (#2123) (#2124)

Fixes

• Fix issue with Sentry CLI msbuild properties (#2119)

Features

• Use Sentry CLI after build to upload symbols (#2107)

Fixes

• Logging info instead of warning when skipping debug images (#2101)
• Fix unhandled exception not captured when hub disabled (#2103)
• Fix Android support for Portable PDB format when app uses split APKs (#2108)
• Fix session ending as crashed for unobserved task exceptions (#2112)
• Set absolute path when stripping project path on stack frame (#2117)

Features

• Add support for Portable PDB format (#2050)
• Update bundled Android SDK to version 6.10.0(#2095)
• Update bundled Cocoa SDK to version 7.31.4 (#2096)

Fixes

• Fix db warnings caused by transaction sampled out (#2097)

Fixes

• Fix missing stack trace on UnobservedTaskException (#2067)
• Fix warning caused by db connection span closed prematurely (#2068)
• Attach db connections to child spans correctly (#2071)
• Improve MAUI event bindings (#2089)

Features

• Simplify API for flushing events (#2030)
• Update bundled Cocoa SDK to version 7.31.1 (#2053)
• Update bundled Android SDK to version 6.7.1 (#2058)

Fixes

• Update unobserved task exception integration (#2034)
• Fix trace propagation targets setter (#2035)
• Fix DiagnosticSource integration disabled incorrectly with TracesSampler (#2039)
• Update transitive dependencies to resolve security warnings (#2045)
• Fix issue with Hot Restart for iOS (#2047)
• Fix CacheDirectoryPath option on MAUI (#2055)

Fixes

• Fix concurrency bug in caching transport (#2026)

Features

• Update bundled Android SDK to version 6.5.0 (#1984)
• Update bundled Cocoa SDK to version 7.28.0 (#1988)
• Allow custom processors to be added as a scoped dependency (#1979)
• Support DI for custom transaction processors (#1993)
• Mark Transaction as aborted when unhandled exception occurs (#1996)
• Build Windows and Tizen targets for Sentry.Maui (#2005)
• Add Custom Measurements API (#2013)
• Add ISpan.GetTransaction convenience method (#2014)

Fixes

• Split Android and Cocoa bindings into separate projects (#1983)
  • NuGet package Sentry now depends on Sentry.Bindings.Android for net6.0-android targets.
  • NuGet package Sentry now depends on Sentry.Bindings.Cocoa for net6.0-ios and net6.0-maccatalyst targets.
• Exclude EF error message from logging (#1980)
• Ensure logs with lower levels are captured by Sentry.Extensions.Logging (#1992)
• Fix bug with pre-formatted strings passed to diagnostic loggers (#2004)
• Fix DI issue by binding to MAUI using lifecycle events (#2006)
• Unhide SentryEvent.Exception (#2011)
• Bump Google.Cloud.Functions.Hosting to version 1.1.0 (#2015)
• Fix default host issue for the Sentry Tunnel middleware (#2019)

Features

• SentryOptions.AttachStackTrace is now enabled by default. (#1907)
• Update Sentry Android SDK to version 6.4.1 (#1911)
• Update Sentry Cocoa SDK to version 7.24.1 (#1912)
• Add TransactionNameSource annotation (#1910)
• Use URL path in transaction names instead of "Unknown Route" (#1919)
  • NOTE: This change effectively ungroups transactions that were previously grouped together under "Unkown Route".
• Add User.Segment property (#1920)
• Add support for custom JsonConverters (#1934)
• Support more types for message template tags in SentryLogger (#1945)
• Support Dynamic Sampling (#1953)

Fixes

• Reduce lock contention when sampling (#1915)
• Dont send transaction for OPTIONS web request (#1921)
• Fix missing details when aggregate exception is filtered out (#1922)
• Exception filters should consider child exceptions of an AggregateException (#1924)
• Add Blazor WASM detection to set IsGlobalModeEnabled to true (#1931)
• Respect Transaction.IsSampled in SqlListener (#1933)
• Ignore null Context values (#1942)
• Tags should not differ based on current culture (#1949)
• Always recalculate payload length (#1957)
• Fix issues with envelope deserialization (#1965)
• Set default trace status to ok instead of unknown_error (#1970)
• Fix reported error count on a crashed session update (#1972)

Includes Sentry.Maui Preview 3

Features

• Add ISentryTransactionProcessor (#1862)
• Added 'integrations' to SdkVersion (#1820)
• Updated Sentry Android SDK to version 6.3.0 (#1826)
• Add the Sentry iOS SDK (#1829)
• Enable Scope Sync for iOS (#1834)
• Add API for deliberately crashing an app (#1842)
• Add Mac Catalyst target (#1848)
• Add Distribution properties (#1851)
• Add and configure options for the iOS SDK (#1849)
• Set default Release and Distribution for iOS and Android (#1856)
• Apply WinUI 3 exception handler in Sentry core (#1863)
• Copy context info from iOS (#1884)

Fixes

• Parse "Mono Unity IL2CPP" correctly in platform runtime name (#1742)
• Fix logging loop with NLog sentry (#1824)
• Fix logging loop with Serilog sentry (#1828)
• Skip attachment if stream is empty (#1854)
• Allow some mobile options to be modified from defaults (#1857)
• Fix environment name casing issue (#1861)
• Null check HttpContext in SystemWebVersionLocator (#1881)
• Fix detection of .NET Framework 4.8.1 (#1885)
• Flush caching transport with main flush (#1890)
• Fix Sentry interfering with MAUI's focus events (#1891)
• Stop using server-os and server-runtime (#1893)

Fixes

• URGENT: Fix events rejected due to duplicate sent_at header when offline caching is enabled through CacheDirectoryPath (#1818)
• Fix null ref in aspnet TryGetTraceHeader (#1807)

Features

• Use sent_at instead of sentry_timestamp to reduce clock skew (#1690)
• Send project root path with events (#1739)

Fixes

• Detect MVC versioning in route (#1731)
• Fix error with ConcurrentHashMap on Android <= 9 (#1761)
• Minor improvements to BackgroundWorker (#1773)
• Make GzipRequestBodyHandler respect async (#1776)
• Fix race condition in handling of InitCacheFlushTimeout (#1784)
• Fix exceptions on background thread not reported in Unity (#1794)

Includes Sentry.Maui Preview 2

Features

• Expose EnumerateChainedExceptions (#1733)
• Android Scope Sync (#1737)
• Enable logging in MAUI (#1738)
• Support IntPtr and UIntPtr serialization (#1746)
• Log Warning when secret is detected in DSN (#1749)
• Catch permission exceptions on Android (#1750)
• Enable offline caching in MAUI (#1753)
• Send client report when flushing queue (#1757)

Fixes

• Set MAUI minimum version (#1728)
• Don't allow SentryDiagnosticListenerIntegration to be added multiple times (#1748)
• Catch permission exceptions for MAUI (#1750)
• Don't allow newlines in diagnostic logger messages (#1756)

Includes Sentry.Maui Preview 1

Features

• Move tunnel functionality into Sentry.AspNetCore (#1645)
• Make HttpContext available for sampling decisions (#1682)
• Send the .NET Runtime Identifier to Sentry (#1708)
• Added a new net6.0-android target for the Sentry core library, which bundles the Sentry Android SDK:
  • Initial .NET 6 Android support (#1288)
  • Update Android Support (#1669)
  • Update Sentry-Android to 6.0.0-rc.1 (#1686)
  • Update Sentry-Android to 6.0.0 (#1697)
  • Set Java/Android SDK options (#1694)
  • Refactor and update Android options (#1705)
  • Add Android OS information to the event context (#1716)
• Added a new Sentry.Maui integration library for the .NET MAUI platform:
  • Initial MAUI support (#1663)
  • Continue with adding MAUI support (#1670)
  • MAUI events become extra context in Sentry events (#1706)
  • Add options for PII breadcrumbs from MAUI events (#1709)
  • Add device information to the event context (#1713)
  • Add platform OS information to the event context (#1717)

Fixes

• Remove IInternalSdkIntegration (#1656)
• On async Main, dont unregister unhandled exception before capturing crash (#321)
• Handle BadHttpRequestException from Kestrel inside SentryTunnelMiddleware (#1673)
• Improve timestamp precision of transactions and spans (#1680)
• Flatten AggregateException (#1672)
  • NOTE: This can affect grouping. You can keep the original behavior by setting the option KeepAggregateException to true.
• Serialize stack frame addresses as strings. (#1692)
• Improve serialization perf and fix memory leak in SentryEvent (#1693)
• Add type checking in contexts TryGetValue (#1700)
• Restore serialization of the Platform name (#1702)

Fixes

• Rework how the InitCacheFlushTimeout option is implemented. (#1644)
• Add retry logic to the caching transport when moving files back from the processing folder. (#1649)

Notice: If you are using self-hosted Sentry, this version and forward requires either Sentry version >= 21.9.0, or you must manually disable sending client reports via the SendClientReports option.

Features

• Collect and send Client Reports to Sentry, which contain counts of discarded events. (#1556)
• Expose ITransport and SentryOptions.Transport public, to support using custom transports (#1602)
• Android native crash support (#1288)

Fixes

• Workaround System.Text.Json issue with Unity IL2CPP. (#1583)
• Demystify stack traces for exceptions that fire in a BeforeSend callback. (#1587)
• Obsolete Platform and always write csharp (#1610)
• Fix a minor issue in the caching transport related to recovery of files from previous session. (#1617)
• Better DisableAppDomainProcessExitFlush docs (#1634)

Features

• Use a default value of 60 seconds if a Retry-After header is not present. (#1537)
• Add new Protocol definitions for DebugImages and AddressMode (#1513)
• Add HttpTransport extensibility and synchronous serialization support (#1560)
• Add UseAsyncFileIO to Sentry options (enabled by default) (#1564)

Fixes

• Fix event dropped by bad attachment when no logger is set. (#1557)
• Ignore zero properties for MemoryInfo (#1531)
• Cleanup diagnostic source (#1529)
• Remove confusing message Successfully sent cached envelope (#1542)
• Fix infinite loop in SentryDatabaseLogging.UseBreadcrumbs (#1543)
• GetFromRuntimeInformation() in try-catch (#1554)
• Make Contexts properties more thread-safe (#1571)
• Fix PlatformNotSupportedException exception on net6.0-maccatalyst targets (#1567)
• In ASP.Net Core, make sure that SentrySdk.LastEventId is accessible from exception handler pages (#1573)

Features

• Expose ConfigureAppFrame as a public static function. (#1493)

Fixes

• Make SentryDiagnosticSubscriber._disposableListeners thread safe (#1506)
• Adjust database span names by replacing _ to .. db.query_compiler becomes db.query.compile. (#1502)

Fixes

• Fix caching transport with attachments (#1489)
• Revert Sentry in implicit usings (#1490)

Features

• Add the delegate TransactionNameProvider to allow the name definition from Unknown transactions on ASP.NET Core (#1421)
• SentrySDK.WithScope is now obsolete in favour of overloads of CaptureEvent, CaptureMessage, CaptureException (#1412)
• Add Sentry to global usings when ImplicitUsings is enabled (<ImplicitUsings>true</ImplicitUsings>) (#1398)
• The implementation of the background worker can now be changed (#1450)
• Map reg key 528449 to net48 (#1465)
• Improve logging for failed JSON serialization (#1473)

Fixes

• Handle exception from crashedLastRun callback (#1328)
• Reduced the logger noise from EF when not using Performance Monitoring (#1441)
• Create CachingTransport directories in constructor to avoid DirectoryNotFoundException (#1432)
• UnobservedTaskException is now considered as Unhandled (#1447)
• Avoid calls the Thread.CurrentThread where possible (#1466)
• Rename thread pool protocol keys to snake case (#1472)
• Treat IOException as a network issue (#1476)
• Fix incorrect sdk name in envelope header (#1474)
• Use Trace.WriteLine for TraceDiagnosticLogger (#1475)
• Remove Exception filters to work around Unity bug on 2019.4.35f IL2CPP (#1486)

Features

• Add CaptureLastError as an extension method to the Server class on ASP.NET (#1411)
• Add IsDynamicCode* to events (#1418)

Fixes

• Dispose of client should only flush (#1354)