org.apache.cxf.tracing.brave

Class BraveTracerContext

java.lang.Object

org.apache.cxf.tracing.brave.BraveTracerContext

All Implemented Interfaces:

TracerContext

public class BraveTracerContext
extends Object
implements TracerContext

Constructor Summary

Constructors

Constructor and Description
BraveTracerContext(brave.http.HttpTracing brave)
BraveTracerContext(brave.http.HttpTracing brave, brave.Span continuationSpan)

Method Summary

Modifier and Type	Method and Description
void	annotate(String key, String value) Adds a key/value pair to the currently active span.
<T> T	continueSpan(Traceable<T> traceable) Picks up an currently detached span from another thread.
TraceScope	startSpan(String description) Starts a new span in the current thread.
void	timeline(String message) Adds a timeline to the currently active span.
<T> T	unwrap(Class<T> clazz) Returns an object of the specified type to allow access to the specific API of the tracing provider.
<T> Callable<T>	wrap(String description, Traceable<T> traceable) Wraps the traceable into a new span, preserving the current span as a parent.

Methods inherited from class java.lang.Object

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

Constructor Detail

BraveTracerContext

public BraveTracerContext(brave.http.HttpTracing brave)

BraveTracerContext

public BraveTracerContext(brave.http.HttpTracing brave,
                          brave.Span continuationSpan)

Method Detail

startSpan

public TraceScope startSpan(String description)

Description copied from interface: TracerContext

Starts a new span in the current thread.

Specified by:

startSpan in interface TracerContext

Parameters:

description - span description

Returns:

span instance object

continueSpan

public <T> T continueSpan(Traceable<T> traceable)
                   throws Exception

Description copied from interface: TracerContext

Picks up an currently detached span from another thread. This method is intended to be used in the context of JAX-RS asynchronous invocations, where request and response are effectively executed by different threads.

Specified by:

continueSpan in interface TracerContext

Parameters:

traceable - traceable implementation to be executed

Returns:

the result of the execution

Throws:

Exception - any exception being thrown by the traceable implementation

wrap

public <T> Callable<T> wrap(String description,
                            Traceable<T> traceable)

Description copied from interface: TracerContext

Wraps the traceable into a new span, preserving the current span as a parent.

Specified by:

wrap in interface TracerContext

Parameters:

description - span description

traceable - traceable implementation to be wrapped

Returns:

callable to be executed (in current thread or any other thread pool)

annotate

public void annotate(String key,
                     String value)

Description copied from interface: TracerContext

Adds a key/value pair to the currently active span.

Specified by:

annotate in interface TracerContext

Parameters:

key - key to add

value - value to add

timeline

public void timeline(String message)

Description copied from interface: TracerContext

Adds a timeline to the currently active span.

Specified by:

timeline in interface TracerContext

Parameters:

message - timeline message

unwrap

public <T> T unwrap(Class<T> clazz)

Description copied from interface: TracerContext

Returns an object of the specified type to allow access to the specific API of the tracing provider.

Specified by:

unwrap in interface TracerContext

Parameters:

clazz - - the class of the object to be returned.

Returns:

an instance of the specified class