com.google.instrumentation.trace

Class SpanFactory

java.lang.Object

com.google.instrumentation.trace.SpanFactory

public abstract class SpanFactory
extends Object

Factory class to create and start a Span.

Constructor Summary

Constructors

Constructor and Description
SpanFactory()

Method Summary

Modifier and Type	Method and Description
protected abstract Span	startSpan(Span parent, String name, StartSpanOptions options) Creates and starts a new child Span (or root if parent is null), with parent being the designated Span and the given options.
protected abstract Span	startSpanWithRemoteParent(SpanContext remoteParent, String name, StartSpanOptions options) Creates and starts a new child Span (or root if parent is null), with parent being the Span designated by the SpanContext and the given options.

Methods inherited from class java.lang.Object

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

Constructor Detail

SpanFactory

public SpanFactory()

Method Detail

startSpan

protected abstract Span startSpan(@Nullable
                                  Span parent,
                                  String name,
                                  StartSpanOptions options)

Creates and starts a new child Span (or root if parent is null), with parent being the designated Span and the given options.

Parameters:

parent - The parent of the returned Span.

name - The name of the returned Span.

options - The options for the start of the Span.

Returns:

A child Span that will have the name provided.

startSpanWithRemoteParent

protected abstract Span startSpanWithRemoteParent(@Nullable
                                                  SpanContext remoteParent,
                                                  String name,
                                                  StartSpanOptions options)

Creates and starts a new child Span (or root if parent is null), with parent being the Span designated by the SpanContext and the given options.

This must be used to create a Span when the parent is on a different process.

Parameters:

remoteParent - The remote parent of the returned Span.

name - The name of the returned Span.

options - The options for the start of the Span.

Returns:

A child Span that will have the name provided.