Sentry 0.0.1-preview2

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
This is a prerelease version of Sentry.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Sentry --version 0.0.1-preview2
NuGet\Install-Package Sentry -Version 0.0.1-preview2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Sentry" Version="0.0.1-preview2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Sentry --version 0.0.1-preview2
#r "nuget: Sentry, 0.0.1-preview2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Sentry as a Cake Addin
#addin nuget:?package=Sentry&version=0.0.1-preview2&prerelease

// Install Sentry as a Cake Tool
#tool nuget:?package=Sentry&version=0.0.1-preview2&prerelease

Initialize the SDK:

void Main() 
{
    using (SentrySdk.Init("dsn"))
    {
        // App code
    }
}

The SDK by default will watch for unhandled exceptions in your app. If the DSN is not explicitly passed by parameter to Init, the SDK will try to locate it via environment variable SENTRY_DSN.

To configure advanced settings, for example a proxy server:

void Main() 
{
    using (SentrySdk.Init(o =>
    {
        o.Dsn = new Dsn("dsn");
        o.Http(h =>
        {
            h.Proxy = new WebProxy("https://localhost:3128");
        });
    }))
    {
        // App code
    }
}

Capture an exception:

try
{
    throw null;
}
catch (Exception e)
{
    SentrySdk.CaptureException(e);
}

Capture a message: ```csharp` SentrySdk.CaptureMessage("this just happened"); ``

Internals/Testability

It's often the case we don't want to couple our code with static class like SentrySdk, especially to allow our code to be testable. If that's your case, you can use 2 abstractions:

  • ISentryClient
  • IHub

The ISentryClient is responsible to queueing the event to be sent to Sentry and abstracting away the internal transport. The IHub on the other hand, holds a client and the current scope. It in fact also implements ISentryClient and is able to dispatch calls to the right client depending on the current scope.

In order to allow different events hold different contextual data, you need to know in which scope you are in. That's the job of the Hub. It holds the scope management as well as a client.

If all you are doing is sending events, without modification/access to the current scope, then you depend on ISentryClient. If on the other hand you would like to have access to the current scope by configuring it or binding a different client to it, etc. You'd depend on IHub.

An example using IHub for testability is SentryLogger and its unit tests SentryLoggerTests.
SentryLogger depends on IHub because it does modify the scope (through AddBreadcrumb). In case it only sent events, it should instead depend on ISentryClient

Compatibility

The packages target .NET Standard 2.0. That means it is compatible with the following versions or newer:

  • .NET Framework 4.6.1
  • .NET Core 2.0
  • Mono 5.4
  • Xamarin.Android 8.0
  • Xamarin.Mac 3.8
  • Xamarin.iOS 10.14
  • Universal Windows Platform 10.0.16299

Of those, we've tested (we run our unit/integration tests) against:

  • .NET Framework 4.6.2 on Windows (AppVeyor)
  • Mono 5.12 macOS and Linux (Travis-CI)
  • .NET Core 2.0 Windows (AppVeyor), macOS and Linux (Travis-CI)
  • .NET Core 2.1 Windows (AppVeyor), macOS and Linux (Travis-CI)
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (72)

Showing the top 5 NuGet packages that depend on Sentry:

Package Downloads
Sentry.Extensions.Logging The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.

Sentry.Serilog The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Official Serilog integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.

Sentry.NLog The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Official NLog integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.

VisioForge.DotNet.Core

VisioForge .Net products for video capture, editing and playback (Video Capture SDK, Media Player SDK, Video Edit SDK). Core package.

DisCatSharp The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

DisCatSharp Your library to write discord bots in C# with a focus on always providing access to the latest discord features. Written with love and for everyone.

GitHub repositories (40)

Showing the top 5 popular GitHub repositories that depend on Sentry:

Repository Stars
ppy/osu
rhythm is just a *click* away!
Sonarr/Sonarr
Smart PVR for newsgroup and bittorrent users.
Radarr/Radarr
Movie organizer/manager for usenet and torrent users.
BililiveRecorder/BililiveRecorder
录播姬 | mikufans 生放送录制
Prowlarr/Prowlarr
Version Downloads Last updated
4.2.1 84,437 3/12/2024
4.2.0 22,370 3/11/2024
4.1.2 336,097 2/20/2024
4.1.1 58,680 2/14/2024
4.1.0 70,476 2/9/2024
4.0.3 25,489 2/7/2024
4.0.2 12,699 2/6/2024
4.0.1 20,509 2/5/2024
4.0.0 38,561 2/1/2024
4.0.0-beta.9 421 1/30/2024
4.0.0-beta.8 10,203 1/11/2024
4.0.0-beta.7 7,680 1/5/2024
4.0.0-beta.6 9,161 12/13/2023
4.0.0-beta.5 1,698 12/12/2023
4.0.0-beta.4 8,787 12/5/2023
4.0.0-beta.3 512 12/2/2023
4.0.0-beta.2 4,115 11/23/2023
4.0.0-beta.1 828 11/19/2023
4.0.0-beta.0 418 11/17/2023
4.0.0-alpha.0 1,754 11/9/2023
3.41.4 352,904 1/23/2024
3.41.3 880,723 11/29/2023
3.41.2 158,412 11/23/2023
3.41.1 35,626 11/22/2023
3.41.0 710,036 11/8/2023
3.40.1 560,007 10/12/2023
3.40.0 116,615 10/10/2023
3.40.0-beta.0 11,567 9/21/2023
3.39.1 868,769 9/12/2023
3.39.0 159,948 9/7/2023
3.36.0 475,354 8/22/2023
3.35.1 151,165 8/16/2023
3.35.0 139,125 8/8/2023
3.34.0 769,830 7/13/2023
3.33.1 1,047,232 6/13/2023
3.33.0 906,839 5/22/2023
3.32.0 22,792 5/22/2023
3.31.0 596,464 5/2/2023
3.30.0 1,048,850 4/11/2023
3.29.1 1,478,065 3/11/2023
3.29.0 193,768 3/6/2023
3.28.1 1,193,647 2/10/2023
3.28.0 65,065 2/8/2023
3.27.1 275,172 2/3/2023
3.27.0 122,657 2/1/2023
3.26.2 480,014 1/24/2023
3.26.1 228,350 1/17/2023
3.26.0 273,633 1/13/2023
3.25.0 1,019,088 12/23/2022
3.24.1 291,235 12/16/2022
3.24.0 1,341,066 11/18/2022
3.23.1 821,337 10/31/2022
3.23.0 91,382 10/27/2022
3.22.0 1,015,863 10/7/2022
3.21.0 1,460,013 9/2/2022
3.20.1 1,463,441 7/26/2022
3.19.0 869,389 6/28/2022
3.18.0 556,426 6/15/2022
3.17.1 1,277,422 5/8/2022
3.17.0 129,494 5/3/2022
3.16.0 929,687 4/7/2022
3.15.0 906,156 3/15/2022
3.14.1 848,162 2/18/2022
3.14.0 191,374 2/14/2022
3.13.0 1,376,925 1/11/2022
3.12.3 974,718 12/19/2021
3.12.2 77,648 12/15/2021
3.12.1 330,126 12/6/2021
3.12.0 261,574 11/23/2021
3.12.0-alpha.1 5,477 11/7/2021
3.11.1 605,874 11/5/2021
3.11.0 124,985 11/2/2021
3.10.0 578,550 10/15/2021
3.9.4 826,085 9/29/2021
3.9.3 163,723 9/21/2021
3.9.2 208,890 9/10/2021
3.9.1 12,764 9/9/2021
3.9.0 284,797 8/27/2021
3.8.3 749,104 7/25/2021
3.8.2 135,256 7/17/2021
3.8.1 27,551 7/15/2021
3.8.0 111,757 7/14/2021
3.7.0 123,872 7/10/2021
3.6.1 174,581 7/2/2021
3.6.0 220,172 6/23/2021
3.6.0-alpha.2 603 6/18/2021
3.6.0-alpha.1 1,217 6/11/2021
3.5.0 450,305 6/7/2021
3.4.0 149,352 5/31/2021
3.4.0-beta.0 290 5/27/2021
3.3.5-beta.0 2,529 5/13/2021
3.3.4 713,637 4/26/2021
3.3.3 8,846 4/23/2021
3.3.2 24,575 4/23/2021
3.3.1 560,818 4/5/2021
3.3.0 32,389 4/3/2021
3.2.0 127,106 3/26/2021
3.1.0 363,306 3/10/2021
3.0.8 67,834 3/4/2021
3.0.7 231,260 2/20/2021
3.0.6 96,720 2/14/2021
3.0.5 64,817 2/9/2021
3.0.4 31,458 2/8/2021
3.0.3 77,795 2/3/2021
3.0.2 20,313 2/3/2021
3.0.1 134,492 1/29/2021
3.0.0 35,673 1/28/2021
3.0.0-beta.0 3,916 1/20/2021
3.0.0-alpha.11 449 1/15/2021
3.0.0-alpha.10 61,580 1/10/2021
3.0.0-alpha.9 2,218 12/29/2020
3.0.0-alpha.8 4,507 12/25/2020
3.0.0-alpha.7 2,953 12/16/2020
3.0.0-alpha.6 3,544 11/30/2020
3.0.0-alpha.5 3,247 11/21/2020
3.0.0-alpha.4 2,351 11/2/2020
3.0.0-alpha.3 1,689 10/29/2020
3.0.0-alpha.2 808 10/21/2020
3.0.0-alpha.1 5,869 10/16/2020
3.0.0-alpha.0 2,078 9/25/2020
2.2.0-alpha 2,055 9/19/2020
2.1.8 1,904,996 11/21/2020
2.1.6 2,025,619 8/20/2020
2.1.5 570,140 7/27/2020
2.1.5-beta 4,095 6/30/2020
2.1.4 606,024 6/25/2020
2.1.3 656,262 6/5/2020
2.1.2-beta5 7,843 5/19/2020
2.1.2-beta4 4,833 5/12/2020
2.1.2-beta3 1,964 5/7/2020
2.1.2-beta2 21,812 4/16/2020
2.1.2-beta 4,243 3/31/2020
2.1.1 1,494,615 3/19/2020
2.1.0 757,053 2/24/2020
2.0.3 583,919 2/12/2020
2.0.2 36,047 2/8/2020
2.0.1 261,945 1/28/2020
2.0.0-beta8 24,041 1/15/2020
2.0.0-beta7 161,182 12/17/2019
2.0.0-beta6 102,432 10/31/2019
2.0.0-beta5 7,197 10/29/2019
2.0.0-beta4 74,960 9/4/2019
2.0.0-beta3 17,073 7/26/2019
2.0.0-beta2 6,095 6/9/2019
2.0.0-beta 3,228 6/4/2019
1.2.1-beta 1,916 5/27/2019
1.2.0 3,060,121 5/23/2019
1.1.3-beta4 1,863 5/15/2019
1.1.3-beta3 1,660 5/13/2019
1.1.3-beta2 7,679 3/28/2019
1.1.3-beta 5,346 2/11/2019
1.1.2 607,383 1/16/2019
1.1.2-beta 3,499 1/8/2019
1.1.1 24,152 1/5/2019
1.1.0 111,224 12/5/2018
1.0.1-beta5 2,579 12/5/2018
1.0.1-beta4 3,328 12/3/2018
1.0.1-beta3 18,100 11/15/2018
1.0.1-beta2 3,239 11/14/2018
1.0.1-beta 20,555 10/24/2018
1.0.0 275,323 10/2/2018
1.0.0-rc2 24,165 9/7/2018
1.0.0-rc 5,850 8/24/2018
0.0.1-preview5 7,435 8/5/2018
0.0.1-preview4 5,022 7/30/2018
0.0.1-preview3 6,563 7/17/2018
0.0.1-preview2 5,962 7/3/2018
0.0.1-preview1 2,539 6/28/2018