ASP.NET

Learn about Sentry's .NET integration with ASP.NET.

Sentry provides an integration with ASP.NET through the Sentry.AspNet NuGet package.

Add the Sentry dependency:

Copied
Install-Package Sentry.AspNet -Version 4.6.2

You can combine this integration with a logging library like log4net, NLog or Serilog to include both request data as well as your logs as breadcrumbs. The logging integrations also capture events when an error is logged.

You configure the SDK in the Global.asax.cs:

Copied
using System;
using System.Web;
using Sentry;
using Sentry.AspNet;
using Sentry.EntityFramework; // If you also installed Sentry.EntityFramework
using Sentry.Extensibility;

public class MvcApplication : HttpApplication
{
    private IDisposable _sentry;

    protected void Application_Start()
    {
        // Initialize Sentry to capture AppDomain unhandled exceptions and more.
        _sentry = SentrySdk.Init(o =>
        {
            o.Dsn = "https://examplePublicKey@o0.ingest.sentry.io/0";
            // When configuring for the first time, to see what the SDK is doing:
            o.Debug = true;

            // This option will enable Sentry's tracing features. You still need to start transactions and spans.
            o.EnableTracing = true;

            // Example sample rate for your transactions: captures 10% of transactions
            o.TracesSampleRate = 0.1;

            // If you also installed the Sentry.EntityFramework package
            o.AddEntityFramework();
            o.AddAspNet();
        });
    }

    // Global error catcher
    protected void Application_Error() => Server.CaptureLastError();

    protected void Application_BeginRequest()
    {
        Context.StartSentryTransaction();
    }

    protected void Application_EndRequest()
    {
        Context.FinishSentryTransaction();
    }

    protected void Application_End()
    {
        // Flushes out events before shutting down.
        _sentry?.Dispose();
    }
}

When opting-in to SendDefaultPii, the SDK will automatically read the user from the request by inspecting HttpContext.User. Default claim values like NameIdentifier for the Id will be used.

Copied
options.AddAspNet();
options.Dsn = "https://examplePublicKey@o0.ingest.sentry.io/0";
// Opt-in to send things like UserId and UserName if a user is logged-in
options.SendDefaultPii = true;

Although this setting is part of the Sentry package, in the context of ASP.NET Core, it means reporting the user by reading the frameworks HttpContext.User. The strategy to create the SentryUser can be customized.

It's helpful to troubleshoot a problem in the API when the payload that hit the endpoint is logged. Opt-in to send the request body to Sentry:

Copied
options.AddAspNet(RequestSize.Always);

For information about Troubleshooting, please visit the troubleshooting page.

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").