com.github.kristofa.brave

Class ThreadLocalServerClientAndLocalSpanState

java.lang.Object

com.github.kristofa.brave.ThreadLocalServerClientAndLocalSpanState

All Implemented Interfaces:

ClientSpanState, CommonSpanState, LocalSpanState, ServerClientAndLocalSpanState, ServerSpanState

public final class ThreadLocalServerClientAndLocalSpanState
extends Object
implements ServerClientAndLocalSpanState

ServerClientAndLocalSpanState implementation that keeps trace state using a ThreadLocal variable.

Author:

kristof

Constructor Summary

Constructors

Constructor and Description
ThreadLocalServerClientAndLocalSpanState(InetAddress ip, int port, String serviceName) Deprecated. Please switch to constructor that takes 'int' for ip. This only does a conversion from the InetAddress to integer anyway and using InetAddress can result in ns lookup and nasty side effects.
ThreadLocalServerClientAndLocalSpanState(int ip, int port, String serviceName) Constructor

Method Summary

Modifier and Type	Method and Description
Endpoint	endpoint() Gets the Endpoint (ip, port, service name) for this service.
Span	getCurrentClientSpan() Gets the Span for the client request that was started as part of current request.
Span	getCurrentLocalSpan() Gets the Span for the local request that was started as part of current request.
ServerSpan	getCurrentServerSpan() Gets the Span for the server request we are currently part of.
Boolean	sample() Indicates if we should sample current request.
void	setCurrentClientSpan(Span span) Sets current client span.
void	setCurrentLocalSpan(Span span) Sets current local span.
void	setCurrentServerSpan(ServerSpan span) Set span for current request.

Methods inherited from class java.lang.Object

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

Constructor Detail

ThreadLocalServerClientAndLocalSpanState

@Deprecated
public ThreadLocalServerClientAndLocalSpanState(InetAddress ip,
                                                            int port,
                                                            String serviceName)

Deprecated. Please switch to constructor that takes 'int' for ip. This only does a conversion from the InetAddress to integer anyway and using InetAddress can result in ns lookup and nasty side effects.

Constructor

Parameters:

ip - InetAddress of current host. If you don't have access to InetAddress you can use InetAddressUtilities#getLocalHostLANAddress()

port - port on which current process is listening.

serviceName - Name of the local service being traced. Should be lowercase and not null or empty.

ThreadLocalServerClientAndLocalSpanState

public ThreadLocalServerClientAndLocalSpanState(int ip,
                                                int port,
                                                String serviceName)

Constructor

Parameters:

ip - Int representation of ipv4 address.

port - port on which current process is listening.

serviceName - Name of the local service being traced. Should be lowercase and not null or empty.

Method Detail

getCurrentServerSpan

public ServerSpan getCurrentServerSpan()

Gets the Span for the server request we are currently part of.

Should be thread-aware to support multiple parallel requests.

Specified by:

getCurrentServerSpan in interface ServerSpanState

Returns:

Server request span for current thread. This will return the span we are part of. In case we should not trace current request null will be returned.

setCurrentServerSpan

public void setCurrentServerSpan(ServerSpan span)

Set span for current request.

Specified by:

setCurrentServerSpan in interface ServerSpanState

Parameters:

span - Span for current request.

endpoint

public Endpoint endpoint()

Gets the Endpoint (ip, port, service name) for this service.

Specified by:

endpoint in interface CommonSpanState

Returns:

Endpoint for this service.

getCurrentClientSpan

public Span getCurrentClientSpan()

Gets the Span for the client request that was started as part of current request.

Should be thread-aware to support multiple parallel requests.

Specified by:

getCurrentClientSpan in interface ClientSpanState

Returns:

Client request span for current thread.

setCurrentClientSpan

public void setCurrentClientSpan(Span span)

Sets current client span.

Should be thread-aware to support multiple parallel requests.

Specified by:

setCurrentClientSpan in interface ClientSpanState

Parameters:

span - Client span.

sample

public Boolean sample()

Description copied from interface: CommonSpanState

Indicates if we should sample current request.

Should be thread-aware to support multiple parallel requests.

Specified by:

sample in interface CommonSpanState

Returns:

null in case there is no indication if we should sample or not. true in case we got the indication we should sample current request, false in case we should not sample the current request.

getCurrentLocalSpan

public Span getCurrentLocalSpan()

Description copied from interface: LocalSpanState

Gets the Span for the local request that was started as part of current request.

Should be thread-aware to support multiple parallel requests.

Specified by:

getCurrentLocalSpan in interface LocalSpanState

Returns:

Local request span for current thread.

setCurrentLocalSpan

public void setCurrentLocalSpan(Span span)

Description copied from interface: LocalSpanState

Sets current local span.

Should be thread-aware to support multiple parallel requests.

Specified by:

setCurrentLocalSpan in interface LocalSpanState

Parameters:

span - Local span.