UWP
Learn more about how Sentry's .NET SDK works with Universal Windows Platform (UWP) applications.
Sentry's .NET SDK works with Universal Windows platform applications through the Sentry NuGet package.
Install the NuGet package to add the Sentry dependency:
Copied
dotnet add package Sentry -v 4.7.0
In addition to initializing the SDK with SentrySdk.Init
, you must configure the UWP specific Application.UnhandledException
and Application.Suspending
events.
The SDK should be initialized in the constructor of your application class (usually App.xaml.cs
). Do not initialize the SDK in the OnLaunched
event of the application or the Hub
will not be initialized correctly.
Copied
using Sentry;
using Sentry.Protocol;
using UnhandledExceptionEventArgs = Windows.UI.Xaml.UnhandledExceptionEventArgs;
sealed partial class App : Application
{
public App()
{
// Initialize Sentry in the App constructor before any other code, to ensure you capture all possible exceptions.
SentrySdk.Init(options =>
{
// Tells which project in Sentry to send events to:
options.Dsn = "https://examplePublicKey@o0.ingest.sentry.io/0";
// When configuring for the first time, to see what the SDK is doing:
options.Debug = true;
// Set traces_sample_rate to 1.0 to capture 100% of transactions for tracing.
// We recommend adjusting this value in production.
options.TracesSampleRate = 1.0;
// Enable Global Mode since this is a client app.
options.IsGlobalModeEnabled = true;
// TODO:Any other Sentry options you need go here.
});
// Hook the UWP UnhandledException event before initializing the app component.
this.UnhandledException += OnUnhandledException;
// Initialize the app component, and hook the Suspending event.
this.InitializeComponent();
this.Suspending += OnSuspending;
// Add any other code you may need last.
}
// Update your OnSuspending handler as shown
private async void OnSuspending(object sender, SuspendingEventArgs e)
{
var deferral = e.SuspendingOperation.GetDeferral();
// Flush Sentry events when suspending
await SentrySdk.FlushAsync(TimeSpan.FromSeconds(2));
// TODO: Save any other application state and stop any background activity.
deferral.Complete();
}
// Add this OnUnhandledException handler.
// Use these attributes to ensure all types of exceptions are handled.
[SecurityCritical]
[HandleProcessCorruptedStateExceptions]
private void OnUnhandledException(object sender, UnhandledExceptionEventArgs e)
{
// Get a reference to the exception, because the Exception property is cleared when accessed.
var exception = e.Exception;
if (exception != null)
{
// Tell Sentry this was an unhandled exception
exception.Data[Mechanism.HandledKey] = false;
exception.Data[Mechanism.MechanismKey] = "Application.UnhandledException";
// Capture the exception
SentrySdk.CaptureException(exception);
// Flush the event immediately
SentrySdk.FlushAsync(TimeSpan.FromSeconds(2)).GetAwaiter().GetResult();
}
}
}
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").