0.12.0-rc1

This is a release candidate for the upcoming 0.12.0 release!

New feature: Trace Identifiers

#96 implements the Trace Identifiers RFC by adding the properties string TraceId & string SpanId to ISpanContext. These identifiers make it easier to correlate tracing data with data in other systems, simplify important tasks, and allow the creation of reusable trace observers.

Current state of this RFC: Test

This RFC is a breaking change for tracers. Tracers who already have existing properties with the same name MAY use explicit interface implementations if they don't want to change the types/names of their existing properties.

Enhancements

• #72 New ISpan.SetTag and ISpanBuilder.WithTag overloads for use with Tag types
  • You can now use the fluent span.SetTag(Tags.HttpStatus, 200) syntax instead of Tags.HttpStatus.Set(span, 200). The same syntax also works for ISpanBuilder (e.g. spanBuilder.WithTag(Tags.HttpMethod, "GET"))
  • This is a breaking change for tracer libraries.
• #75 New parameterless ISpanBuilder.StartActive() overload
  • Tracers MUST implement this with finishSpanOnDispose: true
  • This is a breaking change for tracer libraries.
• #77 NoopTracer types are now public
• #80 OpenTracing assembly is signed
• #83 MockTracer uses AsyncLocalScopeManager on MockTracer(IPropagator) constructor
  • This might be a breaking change for anyone using MockTracer
• #91 ISpan.Log() methods now use IEnumerable<KeyValuePair<string, object>>
  • This makes it easier to pass more efficient data types. Existing code that passes dictionaries will continue to work because IDictionary<string, object> implements that interface.
  • This is a breaking change for tracer libraries

Bugs

• #99 AsyncLocalScopeManager now uses instance variables

Docs

• #70 New examples folder which contains a port of opentracing-java's opentracing-examples
• #74 Improved XML docs

We'd like to thank everyone who contributed code or commented on issues for their help!