brave.opentracing

Class BraveTracer

java.lang.Object

brave.opentracing.BraveTracer

All Implemented Interfaces:

io.opentracing.Tracer

public final class BraveTracer
extends Object
implements io.opentracing.Tracer

Using a tracer, you can create a spans, inject span contexts into a transport, and extract span contexts from a transport Here's an example:

     Tracer tracer = BraveTracer.wrap(brave4);

     Span span = tracer.buildSpan("DoWork").start();
     tracer.inject(span.context());

     ...

     SpanContext clientContext = tracer.extract(Format.Builtin.HTTP_HEADERS,
 request.getHeaders());
     Span clientSpan = tracer.buildSpan('...').asChildOf(clientContext).start();
 

See Also:

BraveSpan, Propagation

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BraveTracer.Builder

Nested classes/interfaces inherited from interface io.opentracing.Tracer

io.opentracing.Tracer.SpanBuilder

Method Summary

Modifier and Type	Method and Description
io.opentracing.Tracer.SpanBuilder	buildSpan(String operationName)
static BraveTracer	create(brave.Tracing brave4) Returns an implementation of Tracer which delegates to the provided Brave Tracing component and uses an instance of BraveScopeManager for its ScopeManager.
<C> io.opentracing.SpanContext	extract(io.opentracing.propagation.Format<C> format, C carrier) Extracts the underlying context using B3 encoding by default.
<C> void	inject(io.opentracing.SpanContext spanContext, io.opentracing.propagation.Format<C> format, C carrier) Injects the underlying context using B3 encoding by default.
static BraveTracer.Builder	newBuilder(brave.Tracing brave4) Returns a BraveTracer.Builder configured with the provided Brave Tracing provided Brave Tracing component and uses an instance of BraveScopeManager for its ScopeManager.
io.opentracing.ScopeManager	scopeManager()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static BraveTracer create(brave.Tracing brave4)

Returns an implementation of Tracer which delegates to the provided Brave Tracing component and uses an instance of BraveScopeManager for its ScopeManager.

newBuilder

public static BraveTracer.Builder newBuilder(brave.Tracing brave4)

Returns a BraveTracer.Builder configured with the provided Brave Tracing provided Brave Tracing component and uses an instance of BraveScopeManager for its ScopeManager.

scopeManager

public io.opentracing.ScopeManager scopeManager()

Specified by:

scopeManager in interface io.opentracing.Tracer

buildSpan

public io.opentracing.Tracer.SpanBuilder buildSpan(String operationName)

Specified by:

buildSpan in interface io.opentracing.Tracer

inject

public <C> void inject(io.opentracing.SpanContext spanContext,
                       io.opentracing.propagation.Format<C> format,
                       C carrier)

Injects the underlying context using B3 encoding by default.

Specified by:

inject in interface io.opentracing.Tracer

extract

public <C> io.opentracing.SpanContext extract(io.opentracing.propagation.Format<C> format,
                                              C carrier)

Extracts the underlying context using B3 encoding by default. A new trace context is provisioned when there is no encoded context in the carrier, or upon error extracting it.

Specified by:

extract in interface io.opentracing.Tracer