io.opentracing.v_030

Interface Span

All Superinterfaces:

BaseSpan<Span>

All Known Subinterfaces:

NoopSpan

All Known Implementing Classes:

MockSpan, SpanShim

public interface Span
extends BaseSpan<Span>

Represents an in-flight Span that's manually propagated within the given process. Most of the API lives in BaseSpan.

Spans are created by the Tracer.SpanBuilder.startManual() method; see ActiveSpan for a BaseSpan extension designed for automatic in-process propagation.

See Also:

for automatic propagation (recommended for most intstrumentation!)

Method Summary

Modifier and Type	Method and Description
void	finish() Sets the end timestamp to now and records the span.
void	finish(long finishMicros) Sets an explicit end timestamp and records the span.

Methods inherited from interface io.opentracing.v_030.BaseSpan

context, getBaggageItem, log, log, log, log, setBaggageItem, setOperationName, setTag, setTag, setTag

Method Detail

finish

void finish()

Sets the end timestamp to now and records the span.

With the exception of calls to BaseSpan.context(), this should be the last call made to the span instance. Future calls to finish() are defined as noops, and future calls to methods other than BaseSpan.context() lead to undefined behavior.

See Also:

BaseSpan.context()

finish

void finish(long finishMicros)

Sets an explicit end timestamp and records the span.

With the exception of calls to Span.context(), this should be the last call made to the span instance, and to do otherwise leads to undefined behavior.

Parameters:

finishMicros - an explicit finish time, in microseconds since the epoch

See Also:

BaseSpan.context()