org.honton.chas.datadog.apm.cdi

Class TracerImpl

java.lang.Object

org.honton.chas.datadog.apm.cdi.TracerImpl

All Implemented Interfaces:

Tracer

@ApplicationScoped
public class TracerImpl
extends Object
implements Tracer

TracerImpl which acts as span factory.

Nested Class Summary

Nested classes/interfaces inherited from interface org.honton.chas.datadog.apm.Tracer

Tracer.HeaderAccessor, Tracer.HeaderMutator

Field Summary

Fields inherited from interface org.honton.chas.datadog.apm.Tracer

SPAN_ID, TRACE_ID

Constructor Summary

Constructors

Constructor and Description
TracerImpl()

Method Summary

Modifier and Type	Method and Description
void	closeCurrentSpan() Finish the current span and restore the current span's parent as the current span
void	closeSpan(SpanBuilder current) Finish the supplied span and restore the supplied span's parent as the current span.
SpanBuilder	createSpan() Create a span which is a child of the current span.
<T> T	executeCallable(String resource, String operation, Callable<T> callable) Execute a Callable with reporting
void	executeRunnable(String resource, String operation, Runnable runnable) Execute a Runnable with reporting
SpanBuilder.SpanContext	exportCurrentSpan() Export a span across a thread.
void	exportSpan(String resource, String operation, Tracer.HeaderMutator headerAccessor) Export a span to another process using headers.
SpanBuilder	getCurrentSpan() Get the currently active span
SpanBuilder	importCurrentSpan(SpanBuilder.SpanContext spanContext, String resource, String operation) Import a span across a thread.
SpanBuilder	importSpan(Tracer.HeaderAccessor headerAccessor) Import a span across process boundaries using a set of headers.

Methods inherited from class java.lang.Object

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

Constructor Detail

TracerImpl

public TracerImpl()

Method Detail

executeCallable

public <T> T executeCallable(String resource,
                             String operation,
                             Callable<T> callable)

Execute a Callable with reporting

Specified by:

executeCallable in interface Tracer

Type Parameters:

T - The return type of the Callable

Parameters:

resource - The resource being called

operation - The operation being called

callable - The Callable to invoke

Returns:

The value returned from the Callable

executeRunnable

public void executeRunnable(String resource,
                            String operation,
                            Runnable runnable)

Execute a Runnable with reporting

Specified by:

executeRunnable in interface Tracer

Parameters:

resource - The resource being called

operation - The operation being called

runnable - The runnable to invoke

getCurrentSpan

public SpanBuilder getCurrentSpan()

Get the currently active span

Specified by:

getCurrentSpan in interface Tracer

Returns:

The current span, or null

exportCurrentSpan

public SpanBuilder.SpanContext exportCurrentSpan()

Description copied from interface: Tracer

Export a span across a thread. Must be called from the exporting Thread. WARNING: Exporting a thread does not prevent the closure of parent span. It may look like asynchronous behavior in the APM dashboard.

Specified by:

exportCurrentSpan in interface Tracer

Returns:

A SpanContext

importCurrentSpan

public SpanBuilder importCurrentSpan(SpanBuilder.SpanContext spanContext,
                                     String resource,
                                     String operation)

Description copied from interface: Tracer

Import a span across a thread. Must be called from the importing Thread. Tracer.getCurrentSpan() must be called from the exporting Thread. WARNING: Importing a thread will destroy the current threads stack of spans!

Specified by:

importCurrentSpan in interface Tracer

Parameters:

spanContext - A SpanContext from Tracer.exportCurrentSpan()

resource - The resource for the new span

operation - The operation for the new span

Returns:

The SpanBuilder which is a child of the imported span.

importSpan

public SpanBuilder importSpan(Tracer.HeaderAccessor headerAccessor)

Import a span across process boundaries using a set of headers. If trace headers are not provided, creates a new root span.

Specified by:

importSpan in interface Tracer

Parameters:

headerAccessor - The function access to headers. Function supplied with header name and should return the header value.

Returns:

The SpanBuilder which is a child of the imported span.

exportSpan

public void exportSpan(String resource,
                       String operation,
                       Tracer.HeaderMutator headerAccessor)

Export a span to another process using headers. Creates a span in this process.

Specified by:

exportSpan in interface Tracer

Parameters:

resource - The remote resource being invoked

operation - The remote operation being invoked

headerAccessor - The function access to headers. Function supplied with header name and value.

createSpan

public SpanBuilder createSpan()

Create a span which is a child of the current span. The newly created span is now considered the current span.

Specified by:

createSpan in interface Tracer

Returns:

The child span, to be filled with resource and operation.

closeCurrentSpan

public void closeCurrentSpan()

Finish the current span and restore the current span's parent as the current span

Specified by:

closeCurrentSpan in interface Tracer

closeSpan

public void closeSpan(SpanBuilder current)

Finish the supplied span and restore the supplied span's parent as the current span. This method is called from finally blocks and must not throw any exceptions.

Specified by:

closeSpan in interface Tracer

Parameters:

current - The currently active span