org.honton.chas.datadog.apm

Interface Tracer

All Known Implementing Classes:

TracerImpl

public interface Tracer

Tracer acts as span manager. Spans can be created and closed through this interface. Cross-process traces can be imported and exported.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Tracer.HeaderAccessor A functional interface to access a header value.
static interface	Tracer.HeaderMutator A functional interface to set a header.

Field Summary

Fields

Modifier and Type	Field and Description
static String	SPAN_ID
static String	TRACE_ID

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
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	importSpan(Tracer.HeaderAccessor headerAccessor) Import a span across process boundaries using a set of headers.

Field Detail

SPAN_ID

static final String SPAN_ID

See Also:

Constant Field Values

TRACE_ID

static final String TRACE_ID

See Also:

Constant Field Values

Method Detail

executeCallable

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

Execute a Callable with reporting

Parameters:

resource - The resource being called

operation - The operation being called

callable - The Callable to invoke

Returns:

The value returned from the Callable

executeRunnable

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

Execute a Runnable with reporting

Parameters:

resource - The resource being called

operation - The operation being called

runnable - The runnable to invoke

getCurrentSpan

SpanBuilder getCurrentSpan()

Get the currently active span

Returns:

The current span, or null

importSpan

SpanBuilder importSpan(Tracer.HeaderAccessor headerAccessor)

Import a span across process boundaries using a set of headers.

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

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

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

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

SpanBuilder createSpan()

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

Returns:

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

closeCurrentSpan

void closeCurrentSpan()

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

closeSpan

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.

Parameters:

current - The currently active span