Class TracerImpl

java.lang.Object

io.opencensus.trace.Tracer

io.opencensus.implcore.trace.TracerImpl

public final class TracerImpl
extends Tracer

Implementation of the Tracer.

Field Summary

Fields

Modifier and Type	Field	Description
private final SpanBuilderImpl.Options	spanBuilderOptions

Constructor Summary

Constructors

Constructor	Description
TracerImpl(RandomHandler randomHandler, RecordEventsSpanImpl.StartEndHandler startEndHandler, Clock clock, TraceConfig traceConfig)

Method Summary

Modifier and Type	Method	Description
SpanBuilder	spanBuilderWithExplicitParent(String spanName, Span parent)	Returns a SpanBuilder to create and start a new child Span (or root if parent is null or has an invalid SpanContext), with parent being the designated Span.
SpanBuilder	spanBuilderWithRemoteParent(String spanName, SpanContext remoteParentSpanContext)	Returns a SpanBuilder to create and start a new child Span (or root if parent is SpanContext.INVALID or null), with parent being the remote Span designated by the SpanContext.

Methods inherited from class Tracer

getCurrentSpan, spanBuilder, withSpan, withSpan, withSpan

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

spanBuilderOptions

private final SpanBuilderImpl.Options spanBuilderOptions

Constructor Details

TracerImpl

public TracerImpl(RandomHandler randomHandler,
 RecordEventsSpanImpl.StartEndHandler startEndHandler,
 Clock clock,
 TraceConfig traceConfig)

Method Details

spanBuilderWithExplicitParent

public SpanBuilder spanBuilderWithExplicitParent(String spanName,
 @Nullable
 Span parent)

Description copied from class: Tracer

Returns a SpanBuilder to create and start a new child Span (or root if parent is null or has an invalid SpanContext), with parent being the designated Span.

See SpanBuilder for usage examples.

This must be used to create a Span when manual Context propagation is used OR when creating a root Span with a null parent.

Specified by:

spanBuilderWithExplicitParent in class Tracer

Parameters:

spanName - The name of the returned Span.

parent - The parent of the returned Span. If null the SpanBuilder will build a root Span.

Returns:

a SpanBuilder to create and start a new Span.

spanBuilderWithRemoteParent

public SpanBuilder spanBuilderWithRemoteParent(String spanName,
 @Nullable
 SpanContext remoteParentSpanContext)

Description copied from class: Tracer

Returns a SpanBuilder to create and start a new child Span (or root if parent is SpanContext.INVALID or null), with parent being the remote Span designated by the SpanContext.

See SpanBuilder for usage examples.

This must be used to create a Span when the parent is in a different process. This is only intended for use by RPC systems or similar.

If no SpanContext OR fail to parse the SpanContext on the server side, users must call this method with a null remote parent SpanContext.

Specified by:

spanBuilderWithRemoteParent in class Tracer

Parameters:

spanName - The name of the returned Span.

remoteParentSpanContext - The remote parent of the returned Span.

Returns:

a SpanBuilder to create and start a new Span.