public static interface Tracer.SpanBuilder
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.active() ). |
Span |
start()
|
Scope |
startActive(boolean finishSpanOnClose)
Returns a newly started and activated
Scope . |
Span |
startManual()
Deprecated.
use
start() or startActive(boolean) instead. |
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. |
Tracer.SpanBuilder asChildOf(SpanContext parent)
If parent==null, this is a noop.
Tracer.SpanBuilder asChildOf(Span parent)
If parent==null, this is a noop.
Tracer.SpanBuilder addReference(String referenceType, SpanContext referencedContext)
If
Tracer
's ScopeManager.active()
is not null, and
addReference(java.lang.String, io.opentracing.SpanContext)
, and
ignoreActiveSpan()
is not invoked,
References.CHILD_OF
reference is created to the
ScopeManager.active()
SpanContext
when either startActive(boolean)
or
startManual()
is invoked.referenceType
- the reference type, typically one of the constants defined in ReferencesreferencedContext
- 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.References
Tracer.SpanBuilder ignoreActiveSpan()
References.CHILD_OF
reference to the ScopeManager.active()
).Tracer.SpanBuilder withTag(String key, String value)
Span.setTag(String, String)
, but for the span being built.Tracer.SpanBuilder withTag(String key, boolean value)
Span.setTag(String, boolean)
, but for the span being built.Tracer.SpanBuilder withTag(String key, Number value)
Span.setTag(String, Number)
, but for the span being built.Tracer.SpanBuilder withStartTimestamp(long microseconds)
Scope startActive(boolean finishSpanOnClose)
Scope
.
The returned Scope
supports try-with-resources. For example:
try (Scope scope = tracer.buildSpan("...").startActive(true)) {
// (Do work)
scope.span().setTag( ... ); // etc, etc
}
// Span does finishes automatically only when 'finishSpanOnClose' is true
If
Tracer
's ScopeManager.active()
is not null, and
addReference(java.lang.String, io.opentracing.SpanContext)
, and
ignoreActiveSpan()
is not invoked,
References.CHILD_OF
reference is created to the
ScopeManager.active()
's SpanContext
when either
startManual()
or startActive(boolean)
is invoked.
Note: startActive(boolean)
is a shorthand for
tracer.scopeManager().activate(spanBuilder.startManual(), finishSpanOnClose)
.
finishSpanOnClose
- whether span should automatically be finished when Scope.close()
is calledScope
, already registered via the ScopeManager
ScopeManager
,
Scope
@Deprecated Span startManual()
start()
or startActive(boolean)
instead.Span start()
ScopeManager
startActive(boolean)
Copyright © 2016–2017 OpenTracing. All rights reserved.