Note

Sentry is unifying the API across all SDKs. With that, a new .NET SDK was created.

This SDK is still recommended for .NET Framework 3.5 to 4.6.0.

For .NET Framework 4.6.1, .NET Core 2.0, Mono 5.4 or higher please use the new SDK.

Raven is the official legacy .NET client for Sentry

| | Stable | Pre-release | | -------------------: | :----------------------------: | :------------------: | | GitHub | | - | | SharpRaven | | | | SharpRaven.Nancy | | | | Travis Build | | | | AppVeyor Build | | |

Usage

Instantiate the client with your 'Data Source Name' (DSN):

var ravenClient = new RavenClient("https://[email protected]/project-id");

Capturing Exceptions

Call out to the client in your catch block:

try
{
    int i2 = 0;
    int i = 10 / i2;
}
catch (Exception exception)
{
    ravenClient.Capture(new SentryEvent(exception));
}

Logging Non-Exceptions

You can capture a message without being bound by an exception:

ravenClient.Capture(new SentryEvent("Hello World!"));

Additional Data

You can add additional data to the

Exception.Data

try
{
    // ...    
}
catch (Exception exception)
{
    exception.Data.Add("SomeKey", "SomeValue");
    throw;
}

The data

SomeKey

SomeValue

extra

Additionally, the

SentryEvent

ErrorLevel

Fingerprint

Message

Tags

Async Support

In the .NET 4.5 or later build of SharpRaven, there's an

async

Capture

async Task CaptureAsync(SentryEvent @event);

Nancy Support

You can install the SharpRaven.Nancy package to capture the HTTP context in Nancy applications. It will auto-register on the

IPipelines.OnError

The only thing you have to do is provide a DSN, either by registering an instance of the

Dsn

protected override void ApplicationStartup(TinyIoCContainer container, IPipelines pipelines)
{
    container.Register(new Dsn("https://[email protected]/project-id"));
}

or through configuration:

The DSN will be picked up by the auto-registered

IRavenClient

IRavenClient

public class LoggingModule : NancyModule
{
    private readonly IRavenClient ravenClient;

public LoggingModule(IRavenClient ravenClient)
{
    this.ravenClient = ravenClient;
}
}

Debugging SharpRaven

If an exception is raised internally to

RavenClient

Console

ErrorOnCapture

ravenClient.ErrorOnCapture = exception =>
{
    // Custom code here
};

You can also hook into the

BeforeSend

ravenClient.BeforeSend = requester =>
{
    // Here you can log data from the requester
    // or replace it entirely if you want.
    return requester;
};

Get it!

You can clone and build SharpRaven yourself, but for those of us who are happy with prebuilt binaries, there's NuGet packages of both SharpRaven and SharpRaven.Nancy.

Resources

• 
• Code
• Bug Tracker
• Forum
• Mailing List
• IRC (

  #sentry

  on

  irc.freenode.net

  )
• Follow @getsentry on Twitter for updates