Backtrace 2.1.6
See the version list below for details.
dotnet add package Backtrace --version 2.1.6
NuGet\Install-Package Backtrace -Version 2.1.6
<PackageReference Include="Backtrace" Version="2.1.6" />
paket add Backtrace --version 2.1.6
#r "nuget: Backtrace, 2.1.6"
// Install Backtrace as a Cake Addin #addin nuget:?package=Backtrace&version=2.1.6 // Install Backtrace as a Cake Tool #tool nuget:?package=Backtrace&version=2.1.6
Backtrace
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
Prerequisites
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
NuGet
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
Documentation
Initialize a new BacktraceClient
First create a BacktraceCredential
instance with your Backtrace endpoint URL
(e.g. https://xxx.sp.backtrace.io:6098) 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 Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net35 is compatible. net40 was computed. net403 was computed. net45 is compatible. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 3.5
- Newtonsoft.Json (>= 11.0.1)
-
.NETFramework 4.5
- Microsoft.Diagnostics.Runtime (>= 0.9.170809.3)
- Newtonsoft.Json (>= 11.0.1)
-
.NETStandard 2.0
- Newtonsoft.Json (>= 11.0.1)
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.10 | 3,221 | 7/3/2024 |
2.1.10-alpha1 | 77 | 7/3/2024 |
2.1.10-alpha | 79 | 7/3/2024 |
2.1.9 | 72,427 | 6/8/2020 |
2.1.8 | 995 | 3/26/2020 |
2.1.7 | 20,014 | 3/2/2020 |
2.1.6 | 751 | 10/11/2019 |
2.1.5 | 551 | 10/4/2019 |
2.1.4 | 832 | 8/2/2019 |
2.1.3 | 872 | 6/13/2019 |
2.1.2 | 872 | 6/7/2019 |
2.1.1 | 1,253 | 3/18/2019 |
2.1.0 | 860 | 3/12/2019 |
2.0.7 | 1,039 | 2/14/2019 |
2.0.6 | 1,300 | 12/19/2018 |
2.0.5 | 1,007 | 12/14/2018 |
2.0.4 | 1,233 | 9/24/2018 |
2.0.3 | 1,191 | 9/4/2018 |
2.0.2 | 1,043 | 8/28/2018 |
2.0.1 | 1,330 | 7/17/2018 |
2.0.0 | 1,214 | 7/10/2018 |
1.3.2 | 1,309 | 7/3/2018 |
1.3.1 | 1,320 | 6/28/2018 |
1.3.0 | 1,324 | 6/26/2018 |
1.2.3 | 1,373 | 6/21/2018 |
1.2.2 | 1,442 | 6/19/2018 |
1.2.1 | 1,310 | 6/14/2018 |
1.2.0 | 1,452 | 5/5/2018 |
1.1.4 | 1,231 | 4/27/2018 |
1.1.2 | 1,228 | 4/9/2018 |
1.1.1 | 1,279 | 4/9/2018 |
1.1.0 | 1,349 | 4/2/2018 |
1.0.3 | 1,327 | 3/20/2018 |
Changed AppDomain exception handler - now Backtrace library will try to store report in database instead of sending report to Backtrace. Because of that we won't block application on unhandled exception event handler.