Raven is a C# client for Sentry
Clone or download
bruno-garcia ref: remove docs from repo
* new docs are kept on a separate repo
* resolves #269
Latest commit b13b7fb Aug 28, 2018


Looking for ASP.NET Core integration?

We've released a preview of our integration with ASP.NET Core and Microsoft.Extensions.Logging. If you are interested in checking it out, please go to this GitHub repository for details.

These integrations are based on a new SDK, built as part of the unified API initiative from Sentry. If you'd like to try the new API, we'd love to get some feedback.

Official Sentry SDK for .NET.

Stable Pre-release
GitHub GitHub release -
SharpRaven NuGet NuGet
SharpRaven.Nancy NuGet NuGet
Travis Build Master Develop
AppVeyor Build Master Develop


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

var ravenClient = new RavenClient("https://public@sentry.io/project-id");

Capturing Exceptions

Call out to the client in your catch block:

    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 property on exceptions thrown about in your solution:

    // ...    
catch (Exception exception)
    exception.Data.Add("SomeKey", "SomeValue");

The data SomeKey and SomeValue will be captured and presented in the extra property on Sentry.

Additionally, the SentryEvent class allow you to provide extra data to be sent with your request, such as ErrorLevel, Fingerprint, a custom Message and Tags.

Async Support

In the .NET 4.5 or later build of SharpRaven, there's an async version of the Capture method as well:

async Task<string> 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 event, so all unhandled exceptions will be sent to Sentry.

The only thing you have to do is provide a DSN, either by registering an instance of the Dsn class in your container:

protected override void ApplicationStartup(TinyIoCContainer container, IPipelines pipelines)
    container.Register(new Dsn("https://public@sentry.io/project-id"));

or through configuration:

    <section name="sharpRaven" type="SharpRaven.Nancy.NancyConfiguration, SharpRaven.Nancy" />
    <dsn value="https://public@sentry.io/project-id" />

The DSN will be picked up by the auto-registered IRavenClient instance, so if you want to send events to Sentry, all you have to do is add a requirement on IRavenClient in your classes:

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 it is logged to the Console. To extend this behaviour use the property ErrorOnCapture:

ravenClient.ErrorOnCapture = exception =>
    // Custom code here

You can also hook into the BeforeSend function to inspect or manipulate the data being sent to Sentry before it is sent:

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.