io.opentracing

Interface ActiveSpanSource

All Known Subinterfaces:

Tracer

public interface ActiveSpanSource

ActiveSpanSource allows an existing (possibly thread-local-aware) execution context provider to act as a source for an actively-scheduled OpenTracing Span.

ActiveSpanSource is a super-interface to Tracer, so note that all Tracers fulfill the ActiveSpanSource contract.

See Also:

ActiveSpan

Method Summary

Modifier and Type	Method and Description
ActiveSpan	activeSpan() Return the active span.
ActiveSpan	makeActive(Span span) Wrap and "make active" a Span by encapsulating it – and any active state (e.g., MDC state) in the current thread – in a new ActiveSpan.

Method Detail

activeSpan

ActiveSpan activeSpan()

Return the active span. This does not affect the internal reference count for the ActiveSpan.

If there is an active span, it becomes an implicit parent of any newly-created span at Tracer.SpanBuilder.startActive() time (rather than at Tracer.buildSpan(String) time).

Returns:

the active span, or null if none could be found.

makeActive

ActiveSpan makeActive(Span span)

Wrap and "make active" a Span by encapsulating it – and any active state (e.g., MDC state) in the current thread – in a new ActiveSpan.

Parameters:

span - the Span to wrap in an ActiveSpan

Returns:

an ActiveSpan that encapsulates the given Span and any other ActiveSpanSource-specific context (e.g., the MDC context map)