com.datadoghq.trace

Class DDTracer

java.lang.Object

io.opentracing.util.ThreadLocalActiveSpanSource

com.datadoghq.trace.DDTracer

All Implemented Interfaces:

io.opentracing.ActiveSpanSource, io.opentracing.Tracer

public class DDTracer
extends io.opentracing.util.ThreadLocalActiveSpanSource
implements io.opentracing.Tracer

DDTracer makes it easy to send traces and span to DD using the OpenTracing integration.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	DDTracer.DDSpanBuilder Spans are built using this builder

Nested classes/interfaces inherited from interface io.opentracing.Tracer

io.opentracing.Tracer.SpanBuilder

Field Summary

Fields

Modifier and Type	Field and Description
static String	UNASSIGNED_DEFAULT_SERVICE_NAME
static Sampler	UNASSIGNED_SAMPLER
static Writer	UNASSIGNED_WRITER

Constructor Summary

Constructors

Constructor and Description
DDTracer() Default constructor, trace/spans are logged, no trace/span dropped
DDTracer(String defaultServiceName, Writer writer, Sampler sampler)
DDTracer(Writer writer)
DDTracer(Writer writer, Sampler sampler)

Method Summary

Modifier and Type	Method and Description
void	addDecorator(AbstractDecorator decorator) Add a new decorator in the list (AbstractDecorator)
void	addServiceInfo(Service service) Register additional information about a service.
DDTracer.DDSpanBuilder	buildSpan(String operationName)
void	close()
<T> io.opentracing.SpanContext	extract(io.opentracing.propagation.Format<T> format, T carrier)
Map<String,Service>	getServiceInfo() Return the list of additional service information registered
List<AbstractDecorator>	getSpanContextDecorators(String tag) Returns the list of span context decorators
<T> void	inject(io.opentracing.SpanContext spanContext, io.opentracing.propagation.Format<T> format, T carrier)
String	toString()
void	write(Queue<DDBaseSpan<?>> trace) We use the sampler to know if the trace has to be reported/written.

Methods inherited from class io.opentracing.util.ThreadLocalActiveSpanSource

activeSpan, makeActive

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.opentracing.ActiveSpanSource

activeSpan, makeActive

Field Detail

UNASSIGNED_DEFAULT_SERVICE_NAME

public static final String UNASSIGNED_DEFAULT_SERVICE_NAME

See Also:

Constant Field Values

UNASSIGNED_WRITER

public static final Writer UNASSIGNED_WRITER

UNASSIGNED_SAMPLER

public static final Sampler UNASSIGNED_SAMPLER

Constructor Detail

DDTracer

public DDTracer()

Default constructor, trace/spans are logged, no trace/span dropped

DDTracer

public DDTracer(Writer writer)

DDTracer

public DDTracer(Writer writer,
                Sampler sampler)

DDTracer

public DDTracer(String defaultServiceName,
                Writer writer,
                Sampler sampler)

Method Detail

getSpanContextDecorators

public List<AbstractDecorator> getSpanContextDecorators(String tag)

Returns the list of span context decorators

Returns:

the list of span context decorators

addDecorator

public void addDecorator(AbstractDecorator decorator)

Add a new decorator in the list (AbstractDecorator)

Parameters:

decorator - The decorator in the list

buildSpan

public DDTracer.DDSpanBuilder buildSpan(String operationName)

Specified by:

buildSpan in interface io.opentracing.Tracer

inject

public <T> void inject(io.opentracing.SpanContext spanContext,
                       io.opentracing.propagation.Format<T> format,
                       T carrier)

Specified by:

inject in interface io.opentracing.Tracer

extract

public <T> io.opentracing.SpanContext extract(io.opentracing.propagation.Format<T> format,
                                              T carrier)

Specified by:

extract in interface io.opentracing.Tracer

write

public void write(Queue<DDBaseSpan<?>> trace)

We use the sampler to know if the trace has to be reported/written. The sampler is called on the first span (root span) of the trace. If the trace is marked as a sample, we report it.

Parameters:

trace - a list of the spans related to the same trace

close

public void close()

toString

public String toString()

Overrides:

toString in class Object

addServiceInfo

public void addServiceInfo(Service service)

Register additional information about a service. Service additional information are a Datadog feature only. Services are reported through a specific Datadog endpoint.

Parameters:

service - additional service information

getServiceInfo

public Map<String,Service> getServiceInfo()

Return the list of additional service information registered

Returns:

the list of additional service information