Learn about SDK usage
This section will describe features, configurations and general functionality which are specific to the .NET SDK.
- .NET Framework 4.6.1 (4.7.2 advised)
- .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 run our unit/integration tests against:
- .NET Framework 4.8 on Windows
- Mono 5.12 macOS and Linux
- .NET Core 2.1 Windows, macOS and Linux
- .NET Core 3.1 Windows, macOS and Linux
Using an older version of .NET Framework or Mono?
Upgrading the SDK and want to understand what's new?
You can ignore exceptions by their type when initializing the SDK:
SentrySdk.Init(o => o.AddExceptionFilterForType<OperationCanceledException>());
It works in the whole inheritance chain.
The example above will also filter out
TaskCanceledException because it derives from
The SDK attempts to locate the release to add that to the events sent to Sentry.
The SDK will firstly look at the entry assembly's
AssemblyInformationalVersionAttribute, which accepts a string as
value and is often used to set a GIT commit hash.
If that returns null, it'll look at the default
AssemblyVersionAttribute which accepts the numeric version number. When creating a project with Visual Studio, the value is set to 184.108.40.206.
Since that usually means that the version is either not being set, or is set via a different method. The automatic version detection will disregard this value and no Release will be reported automatically.
We often don't want to couple our code with a static class like
SentrySdk. Especially to allow our code to be testable.
If that's your case, you can use 2 abstractions:
ISentryClient exposes the
CaptureEvent method and its implementation
SentryClient is responsible for queueing the event to be sent to Sentry. It also abstracts away the internal transport.
IHub on the other hand, holds a client and the current scope. In fact, it extends
ISentryClient and is able to dispatch calls to the right client depending on the current scope.
In order to allow different events to 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, you depend on
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