Sentry.AspNetCore 3.21.0
Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us, check out our open positions.
Sentry SDK for .NET
| Integrations | Downloads | NuGet Stable | NuGet Preview | Documentation |
|---|---|---|---|---|
| Sentry |  |
 |
 |
 |
| Sentry.AspNet |  |
 |
 |
|
| Sentry.AspNetCore |  |
 |
 |
|
| Sentry.AspNetCore.Grpc |  |
 |
 |
|
| Sentry.DiagnosticSource |  |
 |
 |
|
| Sentry.EntityFramework |  |
 |
 |
|
| Sentry.Extensions.Logging |  |
 |
 |
|
| Sentry.Google.Cloud.Functions |  |
 |
 |
|
| Sentry.Log4Net |  |
 |
 |
|
| Sentry.Maui |  |
 |
 |
|
| Sentry.NLog |  |
 |
 |
|
| Sentry.Serilog |  |
 |
 |
|
More Sentry .NET Integrations
Sentry offers other integrations that are not part of this repository:
- Sentry.Minidump: Capture Minidumps on Windows, macOS and Linux
- Sentry.Unity: Unity integrations
- Sentry.Xamarin: Xamarin native and Xamarin.Forms integrations
Looking for something else? Let us know by raising an issue.
Documentation
Each NuGet package in the table above has its custom view of the docs. Click on the badge to find the best documentation for your use case.
Sentry has extensive documentation for its SDKs on https://docs.sentry.io.
Additionally, our .NET API refererence docs are generated and deployed on each merge to main.
Samples
Consider taking a look at the samples directory for different types of apps and example usages of the SDK.
Looking for more samples? Check out this repository.
Compatibility
The packages target .NET Standard 2.0 and .NET Framework 4.6.1. They also include targets such as .NET 5, .NET 6 and platform-specific targets where appropriate. That means they are compatible with the following versions or newer:
- .NET 5.0
- .NET Core 2.0
- .NET Framework 4.6.1
- Mono 5.4
- Xamarin.Android 8.0
- Xamarin.iOS 10.14
- Xamarin.Mac 3.8
- Universal Windows Platform 10.0.16299
Of those, we run our unit and integration tests against the following:
- .NET 6 on Windows, macOS and Linux
- .NET 5 on Windows, macOS and Linux
- .NET Core 3.1 on Windows, macOS and Linux
- .NET Core 2.1 on Windows, macOS and Linux
- .NET Framework 4.8 on Windows
- Mono 6.12 on macOS and Linux
Sentry Protocol
For more details, please: refer to the documentation
Legacy frameworks
Sentry's Raven SDK is still available, and recommended for use with .NET Framework 3.5 to 4.6.0.
Resources
No packages depend on Sentry.AspNetCore.
Changes since version Features
Various fixes & improvements:
- Add ISentryTransactionProcessor (#1862) by @SimonCropp
- Stop using `server-os` and `server-runtime` (#1893) by @mattjohnsonpint
- Fix Sentry interfering with MAUI's focus events (#1891) by @mattjohnsonpint
- Copy context info from iOS (#1884) by @mattjohnsonpint
- Flush caching transport with main flush (#1890) by @mattjohnsonpint
- Parse "Mono Unity IL2CPP" correctly in platform runtime name (#1742) by @bitsandfoxes
- Fix detection of .NET Framework 4.8.1 (#1885) by @mattjohnsonpint
- null check HttpContext in SystemWebVersionLocator (#1881) by @SimonCropp
- Move Array option over to use List<T> (#1866) by @SimonCropp
- Apply WinUI 3 exception handler in Sentry core (#1863) by @mattjohnsonpint
- Fix environment name casing issue (#1861) by @SimonCropp
- Allow some mobile options to be modified from defaults (#1857) by @mattjohnsonpint
- Set default `Release` and `Distribution` for iOS and Android (#1856) by @mattjohnsonpint
- fix: Skip attachment if stream is empty (#1854) by @bitsandfoxes
- Add `Distribution` properties to go along with `Release` info (#1851) by @mattjohnsonpint
- Add and configure options for the iOS SDK (#1849) by @mattjohnsonpint
- Add MacCatalyst target and sample app (#1848) by @mattjohnsonpint
- Add API for deliberately crashing an app (#1842) by @mattjohnsonpint
- Serilog integration tests (#1828) by @SimonCropp
- Enable Scope Sync for iOS (#1834) by @mattjohnsonpint
- Add Native iOS Support (#1829) by @mattjohnsonpint
- Logging loop with n log sentry (#1824) by @SimonCropp
- Update Sentry Android SDK to version 6.3.0 (#1826) by @mattjohnsonpint
- feat: Added 'integrations' to SdkVersion (#1820) by @bitsandfoxes
-->
See full changelog at https://github.com/getsentry/sentry-dotnet/blob/main/CHANGELOG.md
.NET Core 3.0
- Sentry.Extensions.Logging (>= 3.21.0)
.NET 5.0
- Sentry.Extensions.Logging (>= 3.21.0)
.NET 6.0
- Sentry.Extensions.Logging (>= 3.21.0)
.NET Standard 2.0
- Sentry.DiagnosticSource (>= 3.21.0)
- Sentry.Extensions.Logging (>= 3.21.0)
- Microsoft.AspNetCore.Diagnostics.Abstractions (>= 2.1.0)
- Microsoft.AspNetCore.Hosting (>= 2.1.0)
- Microsoft.AspNetCore.Routing.Abstractions (>= 2.1.0)
- Microsoft.Extensions.Configuration.Binder (>= 2.1.0)
- Microsoft.Extensions.DependencyInjection (>= 2.1.0)
- System.Diagnostics.DiagnosticSource (>= 4.5.0)
| Version | Downloads | Last updated |
|---|---|---|
| 14.12.1-dump1 | 1 | 10/31/2024 |
| 5.0.0-alpha.1 | 0 | 11/25/2024 |
| 5.0.0-alpha.0 | 0 | 11/24/2024 |
| 4.13.0 | 2 | 11/07/2024 |
| 4.12.2 | 6 | 11/02/2024 |
| 4.12.1 | 2 | 10/11/2024 |
| 4.12.1-segv1 | 4 | 11/02/2024 |
| 4.12.0 | 1 | 10/07/2024 |
| 4.11.0 | 2 | 10/07/2024 |
| 4.10.2 | 4 | 08/22/2024 |
| 4.10.1 | 3 | 08/17/2024 |
| 4.10.0 | 6 | 08/15/2024 |
| 4.9.0 | 3 | 07/11/2024 |
| 4.9.0-sync.collection.2 | 4 | 08/02/2024 |
| 4.9.0-sync.collection.1 | 1 | 08/02/2024 |
| 4.8.1 | 8 | 07/04/2024 |
| 4.8.0 | 5 | 06/27/2024 |
| 4.7.0 | 19 | 05/27/2024 |
| 4.6.2 | 21 | 05/15/2024 |
| 4.6.1 | 4 | 05/15/2024 |
| 4.6.0 | 18 | 05/13/2024 |
| 4.5.0 | 18 | 05/01/2024 |
| 4.4.0 | 12 | 04/14/2024 |
| 4.3.0 | 11 | 04/14/2024 |
| 4.2.1 | 13 | 03/30/2024 |
| 4.2.0 | 10 | 03/30/2024 |
| 4.1.2 | 10 | 03/30/2024 |
| 4.1.1 | 4 | 02/16/2024 |
| 4.1.0 | 6 | 02/14/2024 |
| 4.0.3 | 3 | 02/14/2024 |
| 4.0.2 | 5 | 02/14/2024 |
| 4.0.1 | 3 | 02/14/2024 |
| 4.0.0 | 5 | 02/15/2024 |
| 4.0.0-beta.9 | 3 | 02/14/2024 |
| 4.0.0-beta.8 | 3 | 01/13/2024 |
| 4.0.0-beta.7 | 3 | 01/28/2024 |
| 4.0.0-beta.6 | 3 | 12/15/2023 |
| 4.0.0-beta.5 | 7 | 12/15/2023 |
| 4.0.0-beta.4 | 5 | 12/15/2023 |
| 4.0.0-beta.3 | 3 | 12/15/2023 |
| 4.0.0-beta.2 | 5 | 12/15/2023 |
| 4.0.0-beta.1 | 5 | 12/15/2023 |
| 4.0.0-beta.0 | 3 | 12/22/2023 |
| 4.0.0-alpha.0 | 7 | 12/15/2023 |
| 3.41.4 | 3 | 02/17/2024 |
| 3.41.3 | 7 | 12/15/2023 |
| 3.41.2 | 5 | 12/15/2023 |
| 3.41.1 | 5 | 12/15/2023 |
| 3.41.0 | 5 | 12/15/2023 |
| 3.40.1 | 4 | 01/13/2024 |
| 3.40.0 | 7 | 12/15/2023 |
| 3.40.0-beta.0 | 7 | 12/15/2023 |
| 3.39.1 | 7 | 12/15/2023 |
| 3.39.0 | 16 | 12/15/2023 |
| 3.38.0 | 5 | 12/15/2023 |
| 3.37.0 | 5 | 12/15/2023 |
| 3.36.0 | 7 | 12/15/2023 |
| 3.35.1 | 8 | 12/15/2023 |
| 3.35.0 | 12 | 12/15/2023 |
| 3.34.0 | 5 | 12/15/2023 |
| 3.33.1 | 8 | 12/15/2023 |
| 3.33.0 | 2 | 06/29/2024 |
| 3.32.0 | 4 | 02/17/2024 |
| 3.31.0 | 27 | 08/23/2023 |
| 3.30.0 | 9 | 12/18/2023 |
| 3.29.1 | 2 | 02/17/2024 |
| 3.29.0 | 4 | 02/17/2024 |
| 3.28.1 | 4 | 02/17/2024 |
| 3.28.0 | 3 | 02/17/2024 |
| 3.27.1 | 5 | 10/18/2023 |
| 3.27.0 | 2 | 02/17/2024 |
| 3.26.2 | 4 | 10/15/2023 |
| 3.26.1 | 6 | 10/18/2023 |
| 3.26.0 | 6 | 02/17/2024 |
| 3.25.0 | 3 | 02/17/2024 |
| 3.24.1 | 6 | 02/17/2024 |
| 3.24.0 | 3 | 02/17/2024 |
| 3.23.1 | 4 | 02/17/2024 |
| 3.23.0 | 4 | 02/17/2024 |
| 3.22.0 | 4 | 02/17/2024 |
| 3.21.0 | 6 | 02/17/2024 |
| 3.20.1 | 6 | 02/17/2024 |
| 3.20.0 | 6 | 02/17/2024 |
| 3.19.0 | 6 | 02/17/2024 |
| 3.18.0 | 8 | 02/17/2024 |
| 3.17.1 | 3 | 02/17/2024 |
| 3.17.0 | 5 | 02/17/2024 |
| 3.16.0 | 9 | 11/01/2023 |
| 3.15.0 | 2 | 02/17/2024 |
| 3.14.1 | 15 | 11/04/2023 |
| 3.14.0 | 9 | 09/09/2023 |
| 3.13.0 | 4 | 02/17/2024 |
| 3.12.3 | 4 | 02/17/2024 |
| 3.12.2 | 11 | 11/04/2023 |
| 3.12.1 | 4 | 02/17/2024 |
| 3.12.0 | 11 | 11/02/2023 |
| 3.12.0-alpha.1 | 6 | 02/17/2024 |
| 3.11.1 | 5 | 10/02/2023 |
| 3.11.0 | 19 | 09/11/2023 |
| 3.10.0 | 5 | 02/17/2024 |
| 3.9.4 | 3 | 02/17/2024 |
| 3.9.3 | 5 | 01/15/2024 |
| 3.9.2 | 17 | 11/01/2023 |
| 3.9.1 | 3 | 02/17/2024 |
| 3.9.0 | 2 | 02/17/2024 |
| 3.8.3 | 2 | 01/26/2024 |
| 3.8.2 | 4 | 02/17/2024 |
| 3.8.1 | 2 | 02/17/2024 |
| 3.8.0 | 3 | 02/17/2024 |
| 3.7.0 | 3 | 02/17/2024 |
| 3.6.1 | 2 | 02/17/2024 |
| 3.6.0 | 4 | 02/17/2024 |
| 3.6.0-alpha.2 | 4 | 02/17/2024 |
| 3.6.0-alpha.1 | 6 | 02/17/2024 |
| 3.5.0 | 2 | 02/17/2024 |
| 3.4.0 | 2 | 02/17/2024 |
| 3.4.0-beta.0 | 5 | 02/17/2024 |
| 3.3.5-beta.0 | 3 | 02/17/2024 |
| 3.3.4 | 3 | 02/17/2024 |
| 3.3.3 | 14 | 11/02/2023 |
| 3.3.2 | 2 | 02/17/2024 |
| 3.3.1 | 10 | 09/09/2023 |
| 3.3.0 | 19 | 11/17/2023 |
| 3.2.0 | 1 | 02/17/2024 |
| 3.1.0 | 5 | 02/17/2024 |
| 3.0.8 | 5 | 02/17/2024 |
| 3.0.7 | 2 | 02/17/2024 |
| 3.0.6 | 2 | 02/17/2024 |
| 3.0.5 | 3 | 02/17/2024 |
| 3.0.4 | 2 | 02/17/2024 |
| 3.0.3 | 2 | 02/17/2024 |
| 3.0.2 | 1 | 02/17/2024 |
| 3.0.1 | 2 | 02/17/2024 |
| 3.0.0 | 4 | 02/17/2024 |
| 3.0.0-beta.0 | 7 | 10/31/2023 |
| 3.0.0-alpha.11 | 5 | 02/17/2024 |
| 3.0.0-alpha.10 | 6 | 02/17/2024 |
| 3.0.0-alpha.9 | 5 | 02/17/2024 |
| 3.0.0-alpha.8 | 4 | 02/17/2024 |
| 3.0.0-alpha.7 | 8 | 02/17/2024 |
| 3.0.0-alpha.6 | 5 | 02/17/2024 |
| 3.0.0-alpha.5 | 5 | 02/17/2024 |
| 3.0.0-alpha.4 | 5 | 02/17/2024 |
| 3.0.0-alpha.3 | 6 | 02/17/2024 |
| 3.0.0-alpha.2 | 8 | 02/17/2024 |
| 3.0.0-alpha.1 | 6 | 02/17/2024 |
| 3.0.0-alpha.0 | 5 | 02/17/2024 |
| 2.2.0-alpha | 2 | 06/14/2023 |
| 2.1.8 | 21 | 12/30/2020 |
| 2.1.6 | 4 | 02/17/2024 |
| 2.1.5 | 14 | 11/04/2023 |
| 2.1.5-beta | 18 | 06/14/2023 |
| 2.1.4 | 2 | 02/17/2024 |
| 2.1.3 | 4 | 12/17/2023 |
| 2.1.2-beta5 | 2 | 02/17/2024 |
| 2.1.2-beta4 | 2 | 02/17/2024 |
| 2.1.2-beta3 | 3 | 02/17/2024 |
| 2.1.2-beta2 | 3 | 02/17/2024 |
| 2.1.2-beta | 4 | 06/14/2023 |
| 2.1.1 | 4 | 02/17/2024 |
| 2.1.0 | 3 | 02/17/2024 |
| 2.0.3 | 27 | 10/20/2023 |
| 2.0.2 | 16 | 02/13/2024 |
| 2.0.1 | 5 | 02/17/2024 |
| 2.0.0 | 7 | 02/17/2024 |
| 2.0.0-beta8 | 3 | 02/17/2024 |
| 2.0.0-beta7 | 3 | 09/02/2023 |
| 2.0.0-beta6 | 2 | 02/17/2024 |
| 2.0.0-beta5 | 7 | 11/01/2023 |
| 2.0.0-beta4 | 2 | 02/17/2024 |
| 2.0.0-beta3 | 12 | 02/17/2024 |
| 2.0.0-beta2 | 3 | 02/17/2024 |
| 2.0.0-beta | 6 | 02/17/2024 |
| 1.2.1-beta | 4 | 06/14/2023 |
| 1.2.0 | 2 | 02/17/2024 |
| 1.1.3-beta4 | 2 | 02/17/2024 |
| 1.1.3-beta3 | 5 | 02/17/2024 |
| 1.1.3-beta2 | 2 | 02/17/2024 |
| 1.1.3-beta | 3 | 06/14/2023 |
| 1.1.2 | 12 | 12/07/2023 |
| 1.1.2-beta | 3 | 06/14/2023 |
| 1.1.1 | 3 | 02/17/2024 |
| 1.1.0 | 3 | 02/17/2024 |
| 1.0.1-beta5 | 3 | 02/17/2024 |
| 1.0.1-beta4 | 4 | 02/17/2024 |
| 1.0.1-beta3 | 2 | 02/17/2024 |
| 1.0.1-beta2 | 2 | 02/17/2024 |
| 1.0.1-beta | 3 | 06/14/2023 |
| 1.0.0 | 2 | 02/17/2024 |
| 1.0.0-rc2 | 15 | 11/04/2023 |
| 1.0.0-rc | 4 | 02/17/2024 |
| 0.0.1-preview5 | 4 | 02/17/2024 |
| 0.0.1-preview4 | 7 | 02/17/2024 |
| 0.0.1-preview3 | 4 | 02/17/2024 |
| 0.0.1-preview2 | 7 | 02/17/2024 |
| 0.0.1-preview1 | 5 | 02/17/2024 |