com.github.kristofa.brave

Class ClientTracer

java.lang.Object

com.github.kristofa.brave.AnnotationSubmitter

com.github.kristofa.brave.ClientTracer

public abstract class ClientTracer
extends AnnotationSubmitter

Low level api that deals with client side of a request:

1. Decide on tracing or not (sampling)
2. Sending client set / client received annotations

It is advised that you use ClientRequestInterceptor and ClientResponseInterceptor which build upon ClientTracer and provide a higher level api.

Author:

kristof

See Also:

ClientRequestInterceptor, ClientResponseInterceptor

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ClientTracer.Builder

Method Summary

Modifier and Type	Method and Description
static ClientTracer.Builder	builder()
void	setClientReceived() Sets the 'client received' event for current thread.
void	setClientSent() Sets 'client sent' event for current thread.
void	setCurrentClientServiceName(String serviceName) Override the service name that will be submitted in the annotations.
SpanId	startNewSpan(String requestName) Start a new span for a new client request that will be bound to current thread.

Methods inherited from class com.github.kristofa.brave.AnnotationSubmitter

create, submitAnnotation, submitBinaryAnnotation, submitBinaryAnnotation

Methods inherited from class java.lang.Object

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

Method Detail

builder

public static ClientTracer.Builder builder()

setClientSent

public void setClientSent()

Sets 'client sent' event for current thread.

setClientReceived

public void setClientReceived()

Sets the 'client received' event for current thread. This will also submit span because setting a client received event means this span is finished.

startNewSpan

public SpanId startNewSpan(String requestName)

Start a new span for a new client request that will be bound to current thread. The ClientTracer can decide to return null in case this request should not be traced (eg sampling).

Parameters:

requestName - Request name. Should not be null or empty.

Returns:

Span id for new request or null in case we should not trace this new client request.

setCurrentClientServiceName

public void setCurrentClientServiceName(String serviceName)

Override the service name that will be submitted in the annotations.

This should be set before submitting any annotations. So after invoking startNewSpan(String) and before setClientSent().

Parameters:

serviceName - should be the same as the name of the service the client is calling.