Backtrace 2.1.9

.NET Standard 2.0 .NET Framework 3.5
Install-Package Backtrace -Version 2.1.9
dotnet add package Backtrace --version 2.1.9
<PackageReference Include="Backtrace" Version="2.1.9" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Backtrace --version 2.1.9
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Backtrace, 2.1.9"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Backtrace as a Cake Addin
#addin nuget:?package=Backtrace&version=2.1.9

// Install Backtrace as a Cake Tool
#tool nuget:?package=Backtrace&version=2.1.9
The NuGet Team does not provide support for this client. Please contact its maintainers for support.


Backtrace's integration with C# applications allows customers to capture and report handled and unhandled C# exceptions to their Backtrace instance, instantly offering the ability to prioritize and debug software errors.

Features Summary

  • Light-weight C# client library that quickly submits C#/.NET exceptions and crashes to your Backtrace dashboard
    • Can include callstack, system metadata, custom metadata, and file attachments (e.g. minidump) if needed.
  • Supports a wide range of .NET versions such as .NET Framework, .NET Core, Mono, Xamarin and Unity
  • Supports both CLI and IDE work environments
  • Supports asynchronous Tasks in .NET 4.5+
  • Supports offline database for error report storage and re-submission in case of network outage
  • Fully customizable and extendable event handlers and base classes for custom implementations
  • Available as a NuGet Package as well as a fully open-sourced Github Release.

Supported .NET Frameworks

  • .NET Framework 3.5 +
  • .NET Framework 4.5 +
    • getting information about application thread
    • handling unhandled application exceptions
  • .NET Standard:
    • .NET Core 2.0 application
    • Xamarin
    • Universal Windows Platform
  • Unity


Development Environment

  • On Windows, we recommend Visual Studio 2017 or above for IDE. You can download and install Visual Studio here. As an alternative to Visual Studio you can use .NET Core command line interface, see installation guide here
  • On Mac OS X, you can download and install Visual Studio here if you prefer using an IDE. For command line, you should to download and install .NET Core 2.0 or above.
  • On Linux, Visual Studio Code is available as a light-weight IDE. Similarly, you can use .NET Core command line interface, see instruction for Linux here


The Backtrace library is available on NuGet. You can read more about NuGet and how to download the packages here

Installing Backtrace via NuGet

You can install Backtrace via NuGet using the following commands:

Windows NuGet CLI:

Install-Package Backtrace

Linux/Mac OS X .NET Core CLI:

dotnet add package Backtrace


Initialize a new BacktraceClient

First create a BacktraceCredential instance with your Backtrace endpoint URL (e.g. and submission token, and supply it as a parameter in the BacktraceClient constructor:

var credentials = new BacktraceCredentials("backtrace_endpoint_url", "token");
var backtraceClient = new BacktraceClient(credentials);

For more advanced usage of BacktraceClient, you can supply BacktraceClientConfiguration as a parameter. See the following example:

var credentials = new BacktraceCredentials("backtrace_endpoint_url", "token");
var configuration = new BacktraceClientConfiguration(credentials){
    ClientAttributes = new Dictionary<string, object>() { 
        { "attribute_name", "attribute_value" } },
    ReportPerMin = 3,
var backtraceClient = new BacktraceClient(configuration);
Database initialization <a name="documentation-database-initialization"></a>

BacktraceClient allows you to customize the initialization of BacktraceDatabase for local storage of error reports by supplying a BacktraceDatabaseSettings parameter, as follows:

var dbSettings = new BacktraceDatabaseSettings("databaseDirectory"){
    MaxRecordCount = 100,
    MaxDatabaseSize = 1000,
    AutoSendMode = true,
    RetryBehavior = Backtrace.Types.RetryBehavior.ByInterval
var database = new BacktraceDatabase<object>(dbSettings);
var credentials = new BacktraceCredentials("backtrace_endpoint_url", "token");
var configuration = new BacktraceClientConfiguration(credentials);
var backtraceClient = new BacktraceClient(configuration, database);
Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net35 net40 net403 net45 net451 net452 net46 net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.1.9 31,257 6/8/2020
2.1.8 825 3/26/2020
2.1.7 1,012 3/2/2020
2.1.6 567 10/11/2019
2.1.5 368 10/4/2019
2.1.4 655 8/2/2019
2.1.3 677 6/13/2019
2.1.2 690 6/7/2019
2.1.1 1,071 3/18/2019
2.1.0 674 3/12/2019
2.0.7 833 2/14/2019
2.0.6 1,091 12/19/2018
2.0.5 807 12/14/2018
2.0.4 1,018 9/24/2018
2.0.3 958 9/4/2018
2.0.2 849 8/28/2018
2.0.1 1,105 7/17/2018
2.0.0 1,008 7/10/2018
1.3.2 1,081 7/3/2018
1.3.1 1,087 6/28/2018
1.3.0 1,076 6/26/2018
1.2.3 1,147 6/21/2018
1.2.2 1,187 6/19/2018
1.2.1 1,071 6/14/2018
1.2.0 1,207 5/5/2018
1.1.4 1,035 4/27/2018
1.1.2 1,004 4/9/2018
1.1.1 1,049 4/9/2018
1.1.0 1,130 4/2/2018
1.0.3 1,089 3/20/2018

## Version 2.1.9 - 08.06.2019
- Changed acces modifiers in `BacktraceData` object. With this change, `BeforeSend` event allows to change `Annotations`, `ThreadInformation` and `SourceCode` property