Package com.google.api.gax.tracing

Class SpanTracerFactory

java.lang.Object

com.google.api.gax.tracing.SpanTracerFactory

All Implemented Interfaces:

ApiTracerFactory

@BetaApi
@InternalApi
public class SpanTracerFactory
extends Object
implements ApiTracerFactory

A ApiTracerFactory to build instances of SpanTracer.

This class wraps the TraceManager and pass it to SpanTracer. It will be used to record traces in SpanTracer.

This class is expected to be initialized once during client initialization.

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.api.gax.tracing.ApiTracerFactory

ApiTracerFactory.OperationType

Constructor Summary

Constructors

Constructor	Description
SpanTracerFactory(TraceManager traceManager)	Creates a SpanTracerFactory

Method Summary

Modifier and Type	Method	Description
ApiTracerContext	getApiTracerContext()
ApiTracer	newTracer(ApiTracer parent, ApiTracerContext apiTracerContext)	Create a new ApiTracer that will be a child of the current context.
ApiTracer	newTracer(ApiTracer parent, SpanName spanName, ApiTracerFactory.OperationType operationType)	Create a new ApiTracer that will be a child of the current context.
ApiTracerFactory	withContext(ApiTracerContext context)	Returns a new ApiTracerFactory that will use the provided context to infer attributes for all tracers created by the factory.

Methods inherited from class java.lang.Object

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

Constructor Details

SpanTracerFactory

public SpanTracerFactory(TraceManager traceManager)

Creates a SpanTracerFactory

Method Details

newTracer

public ApiTracer newTracer(ApiTracer parent,
 SpanName spanName,
 ApiTracerFactory.OperationType operationType)

Description copied from interface: ApiTracerFactory

Create a new ApiTracer that will be a child of the current context.

Specified by:

newTracer in interface ApiTracerFactory

Parameters:

parent - the parent of this tracer

spanName - the name of the new span

operationType - the type of operation that the tracer will trace

newTracer

public ApiTracer newTracer(ApiTracer parent,
 ApiTracerContext apiTracerContext)

Description copied from interface: ApiTracerFactory

Create a new ApiTracer that will be a child of the current context.

Specified by:

newTracer in interface ApiTracerFactory

Parameters:

parent - the parent of this tracer

apiTracerContext - the method-definition-specific tracer context

getApiTracerContext

public ApiTracerContext getApiTracerContext()

Specified by:

getApiTracerContext in interface ApiTracerFactory

Returns:

the ApiTracerContext for this factory

withContext

public ApiTracerFactory withContext(ApiTracerContext context)

Description copied from interface: ApiTracerFactory

Returns a new ApiTracerFactory that will use the provided context to infer attributes for all tracers created by the factory.

Specified by:

withContext in interface ApiTracerFactory

Parameters:

context - an ApiTracerContext object containing information to construct attributes