io.opentracing

Interface Tracer.SpanBuilder

Enclosing interface:

Tracer

public static interface Tracer.SpanBuilder

Method Summary

Modifier and Type	Method and Description
Tracer.SpanBuilder	addReference(String referenceType, SpanContext referencedContext) Add a reference from the Span being built to a distinct (usually parent) Span.
Tracer.SpanBuilder	asChildOf(Span parent) A shorthand for addReference(References.CHILD_OF, parent.context()).
Tracer.SpanBuilder	asChildOf(SpanContext parent) A shorthand for addReference(References.CHILD_OF, parent).
Tracer.SpanBuilder	ignoreActiveSpan() Do not create an implicit References.CHILD_OF reference to the ScopeManager.activeSpan()).
Span	start() Returns a newly-started Span.
Tracer.SpanBuilder	withStartTimestamp(long microseconds) Specify a timestamp of when the Span was started, represented in microseconds since epoch.
Tracer.SpanBuilder	withTag(String key, boolean value) Same as Span.setTag(String, boolean), but for the span being built.
Tracer.SpanBuilder	withTag(String key, Number value) Same as Span.setTag(String, Number), but for the span being built.
Tracer.SpanBuilder	withTag(String key, String value) Same as Span.setTag(String, String), but for the span being built.
<T> Tracer.SpanBuilder	withTag(Tag<T> tag, T value) Same as AbstractTag#set(Span, T), but for the span being built.

Method Detail

asChildOf

Tracer.SpanBuilder asChildOf(SpanContext parent)

A shorthand for addReference(References.CHILD_OF, parent).

If parent==null, this is a noop.

asChildOf

Tracer.SpanBuilder asChildOf(Span parent)

A shorthand for addReference(References.CHILD_OF, parent.context()).

If parent==null, this is a noop.

addReference

Tracer.SpanBuilder addReference(String referenceType,
                                SpanContext referencedContext)

Add a reference from the Span being built to a distinct (usually parent) Span. May be called multiple times to represent multiple such References.

If

• the Tracer's ScopeManager.activeSpan() is not null, and
• no explicit references are added via addReference(java.lang.String, io.opentracing.SpanContext), and
• ignoreActiveSpan() is not invoked,

... then an inferred References.CHILD_OF reference is created to the ScopeManager.activeSpan() SpanContext when either SpanBuilder#startActive(boolean) or start() is invoked.

Parameters:

referenceType - the reference type, typically one of the constants defined in References

referencedContext - the SpanContext being referenced; e.g., for a References.CHILD_OF referenceType, the referencedContext is the parent. If referencedContext==null, the call to addReference(java.lang.String, io.opentracing.SpanContext) is a noop.

See Also:

References

ignoreActiveSpan

Tracer.SpanBuilder ignoreActiveSpan()

Do not create an implicit References.CHILD_OF reference to the ScopeManager.activeSpan()).

withTag

Tracer.SpanBuilder withTag(String key,
                           String value)

Same as Span.setTag(String, String), but for the span being built.

withTag

Tracer.SpanBuilder withTag(String key,
                           boolean value)

Same as Span.setTag(String, boolean), but for the span being built.

withTag

Tracer.SpanBuilder withTag(String key,
                           Number value)

Same as Span.setTag(String, Number), but for the span being built.

withTag

<T> Tracer.SpanBuilder withTag(Tag<T> tag,
                               T value)

Same as AbstractTag#set(Span, T), but for the span being built.

withStartTimestamp

Tracer.SpanBuilder withStartTimestamp(long microseconds)

Specify a timestamp of when the Span was started, represented in microseconds since epoch.

start

Span start()

Returns a newly-started Span.

If

• the Tracer's ScopeManager.activeSpan() is not null, and
• no explicit references are added via addReference(java.lang.String, io.opentracing.SpanContext), and
• ignoreActiveSpan() is not invoked,

... then an inferred References.CHILD_OF reference is created to the ScopeManager.activeSpan()'s SpanContext when either start() or SpanBuilder#startActive is invoked.

Returns:

the newly-started Span instance, which has *not* been automatically registered via the ScopeManager