Skip to content

.NET notifier for BugSnag. Error monitoring and error reporting for .NET.

License

Notifications You must be signed in to change notification settings

bugsnag/bugsnag-dotnet

Repository files navigation

Bugsnag Notifier for .NET

build status Documentation

The Bugsnag Notifier for .NET gives you instant notification of exceptions thrown from your .NET apps. Any uncaught exceptions will trigger a notification to be sent to your Bugsnag project.

Bugsnag captures errors in real-time from your web, mobile and desktop applications, helping you to understand and resolve them as fast as possible. Create a free account to start capturing exceptions from your applications.

Contents

Getting Started

Installation

Using Nuget (Recommended)

  • Install the Bugsnag package from Nuget.

Manual library reference

  • Download the latest Bugsnag.dll and reference it in your project

Sending a Test Notification

var configuration = new Bugsnag.Configuration("{API_KEY}");
var client = new Bugsnag.Client(configuration);

client.Notify(new System.Exception("Error!"));

Usage

Catching and Reporting Exceptions

var configuration = new Bugsnag.Configuration("{API_KEY}");
var client = new Bugsnag.Client(configuration);

throw new System.Exception("Error!");

Sending Handled Exceptions

var configuration = new Bugsnag.Configuration("{API_KEY}");
var client = new Bugsnag.Client(configuration);

try
{
	throw new System.Exception("Error!");
}
catch (System.Exception ex)
{
	client.Notify(ex);
}

Callbacks

var configuration = new Bugsnag.Configuration("{API_KEY}");
var client = new Bugsnag.Client(configuration);
client.BeforeNotify((report) => {
	report.Event.User = new Bugsnag.Payload.User {
    Id = "1",
    Name = "Testy McTest",
    Email = "support@bugsnag.com" };
});

Disabling Bugsnag in Debug Mode

var configuration = new Bugsnag.Configuration("{API_KEY}")
{
	ReleaseStage = "development",
	NotifyReleaseStages = new[] { "production" },
};
var client = new Bugsnag.Client(configuration);

try
{
	throw new System.Exception("Error!");
}
catch (System.Exception ex)
{
	client.Notify(ex);
}

Demo Applications

Demo applications which use the Bugsnag .NET library

Support

Contributing

We'd love you to file issues and send pull requests. The contributing guidelines details the process of building and testing bugsnag-dotnet, as well as the pull request process. Feel free to comment on existing issues for clarification or starting points.

License

The Bugsnag .NET notifier is free software released under the MIT License. See LICENSE.txt for details.