The LightStep distributed tracing library for C#

Install the package via NuGet into your solution, or use Install-Package LightStep / dotnet add package LightStep.

It's recommended to initialize the tracer once at the beginning of your application and assign it as the global tracer, as follows:

var tracerOptions = new Options();
var tracer = new Tracer(tracerOptions);
GlobalTracer.Register(tracer);

Once you've initialized a tracer, you can begin to create and emit spans.

Please refer to the OpenTracing C# documentation for information on how to create spans.

You can also refer to the examples folder for sample code and projects.

There's several options that can be adjusted when instantiating a LightStepTracer.

The C# Tracer will prefer TLS 1.2 when available on all .NET Runtime versions, but should fall back to TLS 1.1 or 1.0 in that order.

The following is an example of overriding the LightStep Component Name and adding a new custom tag for all spans -

var satelliteOptions = new SatelliteOptions("satellite.mydomain.com");
var overrideTags = new Dictionary<string, object> 
{
    {LightStepConstants.ComponentNameKey, "test_component"},
    {"my_tag", "foobar"}
};
var tracerOptions = new Options("TEST_TOKEN").WithSatellite(satelliteOptions).WithTags(overrideTags);
var tracer = new Tracer(tracerOptions);

This tracer uses LibLog, a transparent logging abstraction that provides built-in support for NLog, Log4Net, Serilog, and Loupe. If you use a logging provider that isn't identified by LibLog, see this gist on how to implement a custom logging provider.