com.github.kristofa.brave

Interface ServerSpanThreadBinder

public interface ServerSpanThreadBinder

Allows binding span from request thread to a new executor thread.

To be used in case you execute logic in new threads within you service and if you submit annotations or new requests from those threads. The span state is bound to the request thread. When you start new threads it means that the span state that was set in the request thread is not available in those new threads. The ServerSpanThreadBinder allows you to bind the original span state to the new thread.

Author:

kristof

Method Summary

Methods

Modifier and Type	Method and Description
ServerSpan	getCurrentServerSpan() This should be called in the thread in which the request was received before executing code in new threads.
void	setCurrentSpan(ServerSpan span) Binds given span to current thread.

Method Detail

getCurrentServerSpan

ServerSpan getCurrentServerSpan()

This should be called in the thread in which the request was received before executing code in new threads.

It returns the current server span which you can keep and bind to a new thread using ServerSpanThreadBinder#setCurrentSpan(Span).

Returns:

Returned Span can be bound to different executing threads.

See Also:

ServerSpanThreadBinder#setCurrentSpan(Span)

setCurrentSpan

void setCurrentSpan(ServerSpan span)

Binds given span to current thread. This should typically be called when code is invoked in new thread to bind the span from the thread in which we received the request to the new execution thread.

Parameters:

span - Span to bind to current execution thread. Should not be null.