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(BaseSpan<?> 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 ActiveSpanSource.activeSpan()).
Span	start() Deprecated. use startManual() or startActive() instead.
ActiveSpan	startActive() Returns a newly started and activated ActiveSpan.
Span	startManual() Like startActive(), but the returned Span has not been registered via the ActiveSpanSource.
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 BaseSpan.setTag(String, boolean), but for the span being built.
Tracer.SpanBuilder	withTag(String key, Number value) Same as BaseSpan.setTag(String, Number), but for the span being built.
Tracer.SpanBuilder	withTag(String key, String value) Same as BaseSpan.setTag(String, String), 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(BaseSpan<?> 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 ActiveSpanSource.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 ActiveSpanSource.activeSpan() SpanContext when either startActive() or startManual() 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 ActiveSpanSource.activeSpan()).

withTag

Tracer.SpanBuilder withTag(String key,
                           String value)

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

withTag

Tracer.SpanBuilder withTag(String key,
                           boolean value)

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

withTag

Tracer.SpanBuilder withTag(String key,
                           Number value)

Same as BaseSpan.setTag(String, Number), 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.

startActive

ActiveSpan startActive()

Returns a newly started and activated ActiveSpan.

The returned ActiveSpan supports try-with-resources. For example:

     try (ActiveSpan span = tracer.buildSpan("...").startActive()) {
         // (Do work)
         span.setTag( ... );  // etc, etc
     }  // Span finishes automatically unless deferred via ActiveSpan.capture()
 

If

• the Tracer's ActiveSpanSource.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 ActiveSpanSource.activeSpan()'s SpanContext when either startManual() or startActive() is invoked.

Note: startActive() is a shorthand for tracer.makeActive(spanBuilder.startManual()).

Returns:

an ActiveSpan, already registered via the ActiveSpanSource

See Also:

ActiveSpanSource, ActiveSpan

startManual

Span startManual()

Like startActive(), but the returned Span has not been registered via the ActiveSpanSource.

Returns:

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

See Also:

startActive()

start

@Deprecated
Span start()

Deprecated. use startManual() or startActive() instead.