Sentry 3.18.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
Showing the top 20 packages that depend on Sentry.
| Packages | Downloads |
|---|---|
|
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
|
33 |
|
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
|
34 |
|
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
|
35 |
|
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
|
36 |
|
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
|
37 |
|
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
|
38 |
|
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
|
39 |
|
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
|
49 |
|
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
|
64 |
Changes since version 3.17.1
Fixes:
- Improve timestamp precision of transactions and spans ([#1680](https://github.com/getsentry/sentry-dotnet/pull/1680))
- Flatten AggregateException ([#1672](https://github.com/getsentry/sentry-dotnet/pull/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](https://github.com/getsentry/sentry-dotnet/pull/1692))
- Improve serialization perf and fix memory leak in `SentryEvent` ([#1693](https://github.com/getsentry/sentry-dotnet/pull/1693))
- Add type checking in contexts TryGetValue ([#1700](https://github.com/getsentry/sentry-dotnet/pull/1700))
- Restore serialization of the `Platform` name ([#1702](https://github.com/getsentry/sentry-dotnet/pull/1702))
Features:
- Move tunnel functionality into Sentry.AspNetCore ([#1645](https://github.com/getsentry/sentry-dotnet/pull/1645))
- Make `HttpContext` available for sampling decisions ([#1682](https://github.com/getsentry/sentry-dotnet/pull/1682))
- Send the .NET Runtime Identifier to Sentry ([#1708](https://github.com/getsentry/sentry-dotnet/pull/1708))
- Added a new `Sentry.Maui` integration library for the [.NET MAUI](https://dotnet.microsoft.com/apps/maui) platform:
- Initial MAUI support ([#1663](https://github.com/getsentry/sentry-dotnet/pull/1663))
- Continue with adding MAUI support ([#1670](https://github.com/getsentry/sentry-dotnet/pull/1670))
- MAUI events become extra context in Sentry events ([#1706](https://github.com/getsentry/sentry-dotnet/pull/1706))
- Add options for PII breadcrumbs from MAUI events ([#1709](https://github.com/getsentry/sentry-dotnet/pull/1709))
- Add device information to the event context ([#1713](https://github.com/getsentry/sentry-dotnet/pull/1713))
- Add platform OS information to the event context ([#1717](https://github.com/getsentry/sentry-dotnet/pull/1717))
- Added a new `net6.0-android` target for the `Sentry` core library, which bundles the [Sentry Android SDK](https://docs.sentry.io/platforms/android/):
- Initial .NET 6 Android support ([#1288](https://github.com/getsentry/sentry-dotnet/pull/1288))
- Update Android Support ([#1669](https://github.com/getsentry/sentry-dotnet/pull/1669))
- Update Sentry-Android to 6.0.0-rc.1 ([#1686](https://github.com/getsentry/sentry-dotnet/pull/1686))
- Update Sentry-Android to 6.0.0 ([#1697](https://github.com/getsentry/sentry-dotnet/pull/1697))
- Set Java/Android SDK options ([#1694](https://github.com/getsentry/sentry-dotnet/pull/1694))
- Refactor and update Android options ([#1705](https://github.com/getsentry/sentry-dotnet/pull/1705))
- Add Android OS information to the event context ([#1716](https://github.com/getsentry/sentry-dotnet/pull/1716))
Fixes:
- Remove IInternalSdkIntegration ([#1656](https://github.com/getsentry/sentry-dotnet/pull/1656))
- On async Main, dont unregister unhandled exception before capturing crash ([#321](https://github.com/getsentry/sentry-dotnet/issues/321))
- Handle BadHttpRequestException from Kestrel inside SentryTunnelMiddleware ([#1673](https://github.com/getsentry/sentry-dotnet/pull/1673))
-->
See full changelog at https://github.com/getsentry/sentry-dotnet/blob/main/CHANGELOG.md
.NET Framework 4.6.1
- Microsoft.Bcl.AsyncInterfaces (>= 5.0.0)
- System.Threading.Tasks.Extensions (>= 4.5.4)
- System.Text.Json (>= 5.0.2)
- System.Runtime.InteropServices.RuntimeInformation (>= 4.3.0)
- System.Reflection.Metadata (>= 5.0.0)
- System.Buffers (>= 4.5.1)
.NET Standard 2.1
- System.Text.Json (>= 5.0.2)
- System.Reflection.Metadata (>= 5.0.0)
.NET Standard 2.0
- System.Threading.Tasks.Extensions (>= 4.5.4)
- System.Text.Json (>= 5.0.2)
- System.Buffers (>= 4.5.1)
- Microsoft.Bcl.AsyncInterfaces (>= 5.0.0)
- System.Reflection.Metadata (>= 5.0.0)
.NET 6.0
- No dependencies.
.NET 5.0
- No dependencies.
.NET Core 3.0
- System.Reflection.Metadata (>= 5.0.0)
.NET 6.0
- No dependencies.
| Version | Downloads | Last updated |
|---|---|---|
| 4.10.2 | 1 | 08/22/2024 |
| 4.10.1 | 3 | 08/22/2024 |
| 4.10.0 | 1 | 08/22/2024 |
| 4.9.0 | 11 | 07/19/2024 |
| 4.9.0-sync.collection.2 | 3 | 08/19/2024 |
| 4.9.0-sync.collection.1 | 7 | 08/13/2024 |
| 4.8.1 | 10 | 07/19/2024 |
| 4.8.0 | 9 | 07/19/2024 |
| 4.7.0 | 11 | 07/19/2024 |
| 4.6.2 | 8 | 07/19/2024 |
| 4.6.0 | 15 | 07/19/2024 |
| 4.5.0 | 8 | 07/19/2024 |
| 4.4.0 | 8 | 07/19/2024 |
| 4.3.0 | 8 | 07/19/2024 |
| 4.2.1 | 13 | 07/19/2024 |
| 4.2.0 | 15 | 07/19/2024 |
| 4.1.2 | 8 | 07/19/2024 |
| 4.1.1 | 14 | 07/19/2024 |
| 4.1.0 | 20 | 02/13/2024 |
| 4.0.3 | 13 | 07/19/2024 |
| 4.0.2 | 11 | 07/19/2024 |
| 4.0.1 | 10 | 07/19/2024 |
| 4.0.0 | 9 | 07/19/2024 |
| 4.0.0-beta.9 | 10 | 07/23/2024 |
| 4.0.0-beta.8 | 9 | 07/27/2024 |
| 4.0.0-beta.7 | 11 | 07/19/2024 |
| 4.0.0-beta.6 | 13 | 07/19/2024 |
| 4.0.0-beta.5 | 10 | 07/19/2024 |
| 4.0.0-beta.4 | 10 | 07/19/2024 |
| 4.0.0-beta.3 | 14 | 07/19/2024 |
| 4.0.0-beta.2 | 12 | 07/19/2024 |
| 4.0.0-beta.1 | 12 | 07/19/2024 |
| 4.0.0-beta.0 | 11 | 07/19/2024 |
| 4.0.0-alpha.0 | 9 | 08/04/2024 |
| 3.41.4 | 11 | 07/19/2024 |
| 3.41.3 | 11 | 07/19/2024 |
| 3.41.2 | 9 | 07/19/2024 |
| 3.41.1 | 15 | 07/27/2024 |
| 3.41.0 | 0 | 11/08/2023 |
| 3.40.1 | 0 | 10/12/2023 |
| 3.40.0 | 11 | 08/11/2024 |
| 3.40.0-beta.0 | 8 | 08/08/2024 |
| 3.39.1 | 9 | 08/04/2024 |
| 3.39.0 | 10 | 07/19/2024 |
| 3.36.0 | 0 | 08/22/2023 |
| 3.35.1 | 10 | 08/03/2024 |
| 3.35.0 | 10 | 08/08/2024 |
| 3.34.0 | 0 | 07/13/2023 |
| 3.33.1 | 10 | 07/19/2024 |
| 3.33.0 | 9 | 08/11/2024 |
| 3.32.0 | 12 | 07/19/2024 |
| 3.31.0 | 7 | 08/11/2024 |
| 3.30.0 | 9 | 07/19/2024 |
| 3.29.1 | 13 | 07/19/2024 |
| 3.29.0 | 39 | 02/04/2024 |
| 3.28.1 | 21 | 03/18/2024 |
| 3.28.0 | 6 | 07/19/2024 |
| 3.27.1 | 7 | 08/13/2024 |
| 3.27.0 | 0 | 02/01/2023 |
| 3.26.2 | 11 | 07/19/2024 |
| 3.26.1 | 9 | 07/19/2024 |
| 3.26.0 | 11 | 07/19/2024 |
| 3.25.0 | 20 | 07/19/2024 |
| 3.24.1 | 17 | 07/19/2024 |
| 3.24.0 | 22 | 07/19/2024 |
| 3.23.1 | 21 | 07/19/2024 |
| 3.23.0 | 21 | 07/19/2024 |
| 3.22.0 | 2 | 09/04/2024 |
| 3.21.0 | 1 | 09/16/2024 |
| 3.20.1 | 24 | 07/19/2024 |
| 3.19.0 | 25 | 07/19/2024 |
| 3.18.0 | 17 | 07/19/2024 |
| 3.17.1 | 17 | 07/19/2024 |
| 3.17.0 | 24 | 07/19/2024 |
| 3.16.0 | 24 | 07/19/2024 |
| 3.15.0 | 37 | 02/05/2024 |
| 3.14.1 | 35 | 02/04/2024 |
| 3.14.0 | 20 | 07/19/2024 |
| 3.13.0 | 22 | 07/19/2024 |
| 3.12.3 | 25 | 07/19/2024 |
| 3.12.2 | 20 | 07/19/2024 |
| 3.12.1 | 31 | 07/19/2024 |
| 3.12.0 | 21 | 07/19/2024 |
| 3.12.0-alpha.1 | 22 | 07/19/2024 |
| 3.11.1 | 22 | 07/19/2024 |
| 3.11.0 | 26 | 07/19/2024 |
| 3.10.0 | 22 | 07/19/2024 |
| 3.9.4 | 20 | 07/19/2024 |
| 3.9.3 | 28 | 07/19/2024 |
| 3.9.2 | 29 | 07/19/2024 |
| 3.9.1 | 19 | 07/19/2024 |
| 3.9.0 | 28 | 07/19/2024 |
| 3.8.3 | 24 | 07/19/2024 |
| 3.8.2 | 22 | 07/19/2024 |
| 3.8.1 | 26 | 07/19/2024 |
| 3.8.0 | 22 | 07/19/2024 |
| 3.7.0 | 25 | 07/19/2024 |
| 3.6.1 | 23 | 07/19/2024 |
| 3.6.0 | 32 | 07/19/2024 |
| 3.6.0-alpha.2 | 13 | 07/19/2024 |
| 3.6.0-alpha.1 | 27 | 07/19/2024 |
| 3.5.0 | 33 | 07/19/2024 |
| 3.4.0 | 24 | 07/19/2024 |
| 3.4.0-beta.0 | 28 | 07/19/2024 |
| 3.3.5-beta.0 | 20 | 07/19/2024 |
| 3.3.4 | 34 | 07/19/2024 |
| 3.3.3 | 22 | 07/19/2024 |
| 3.3.2 | 26 | 07/19/2024 |
| 3.3.1 | 22 | 07/19/2024 |
| 3.3.0 | 24 | 07/19/2024 |
| 3.2.0 | 27 | 07/19/2024 |
| 3.1.0 | 18 | 07/19/2024 |
| 3.0.8 | 28 | 07/19/2024 |
| 3.0.7 | 25 | 07/19/2024 |
| 3.0.6 | 26 | 07/19/2024 |
| 3.0.5 | 22 | 07/19/2024 |
| 3.0.4 | 26 | 07/19/2024 |
| 3.0.3 | 19 | 07/19/2024 |
| 3.0.2 | 22 | 07/19/2024 |
| 3.0.1 | 25 | 07/19/2024 |
| 3.0.0 | 26 | 07/19/2024 |
| 3.0.0-beta.0 | 23 | 07/19/2024 |
| 3.0.0-alpha.11 | 29 | 07/19/2024 |
| 3.0.0-alpha.10 | 26 | 07/19/2024 |
| 3.0.0-alpha.9 | 21 | 07/19/2024 |
| 3.0.0-alpha.8 | 29 | 07/19/2024 |
| 3.0.0-alpha.7 | 22 | 07/19/2024 |
| 3.0.0-alpha.6 | 20 | 07/19/2024 |
| 3.0.0-alpha.5 | 22 | 07/19/2024 |
| 3.0.0-alpha.4 | 20 | 07/19/2024 |
| 3.0.0-alpha.3 | 22 | 07/19/2024 |
| 3.0.0-alpha.2 | 20 | 07/19/2024 |
| 3.0.0-alpha.1 | 21 | 07/19/2024 |
| 3.0.0-alpha.0 | 24 | 07/19/2024 |
| 2.2.0-alpha | 19 | 07/19/2024 |
| 2.1.8 | 26 | 07/19/2024 |
| 2.1.6 | 23 | 07/19/2024 |
| 2.1.5 | 18 | 07/19/2024 |
| 2.1.5-beta | 20 | 07/19/2024 |
| 2.1.4 | 19 | 07/19/2024 |
| 2.1.3 | 20 | 07/19/2024 |
| 2.1.2-beta5 | 22 | 07/19/2024 |
| 2.1.2-beta4 | 25 | 07/19/2024 |
| 2.1.2-beta3 | 20 | 07/19/2024 |
| 2.1.2-beta2 | 24 | 07/19/2024 |
| 2.1.2-beta | 23 | 07/19/2024 |
| 2.1.1 | 27 | 07/19/2024 |
| 2.1.0 | 24 | 07/19/2024 |
| 2.0.3 | 23 | 07/19/2024 |
| 2.0.2 | 20 | 07/19/2024 |
| 2.0.1 | 23 | 07/19/2024 |
| 2.0.0-beta8 | 17 | 07/19/2024 |
| 2.0.0-beta7 | 23 | 07/19/2024 |
| 2.0.0-beta6 | 24 | 07/19/2024 |
| 2.0.0-beta5 | 24 | 07/19/2024 |
| 2.0.0-beta4 | 24 | 07/19/2024 |
| 2.0.0-beta3 | 24 | 07/19/2024 |
| 2.0.0-beta2 | 18 | 07/19/2024 |
| 2.0.0-beta | 31 | 07/19/2024 |
| 1.2.1-beta | 33 | 07/19/2024 |
| 1.2.0 | 23 | 07/19/2024 |
| 1.1.3-beta4 | 21 | 07/19/2024 |
| 1.1.3-beta3 | 22 | 07/19/2024 |
| 1.1.3-beta2 | 26 | 07/19/2024 |
| 1.1.3-beta | 22 | 07/19/2024 |
| 1.1.2 | 20 | 07/19/2024 |
| 1.1.2-beta | 16 | 07/19/2024 |
| 1.1.1 | 21 | 07/19/2024 |
| 1.1.0 | 16 | 07/19/2024 |
| 1.0.1-beta5 | 20 | 07/19/2024 |
| 1.0.1-beta4 | 21 | 07/19/2024 |
| 1.0.1-beta3 | 19 | 07/19/2024 |
| 1.0.1-beta2 | 18 | 07/19/2024 |
| 1.0.1-beta | 19 | 07/19/2024 |
| 1.0.0 | 26 | 07/19/2024 |
| 1.0.0-rc2 | 25 | 07/19/2024 |
| 1.0.0-rc | 16 | 07/19/2024 |
| 0.0.1-preview5 | 20 | 07/19/2024 |
| 0.0.1-preview4 | 17 | 07/19/2024 |
| 0.0.1-preview3 | 19 | 07/19/2024 |
| 0.0.1-preview2 | 20 | 07/19/2024 |
| 0.0.1-preview1 | 27 | 07/19/2024 |