org.apache.cassandra.tracing

Class Tracing

java.lang.Object

org.apache.cassandra.concurrent.ExecutorLocals.Impl

org.apache.cassandra.tracing.Tracing

public abstract class Tracing
extends ExecutorLocals.Impl

A trace session context. Able to track and store trace sessions. A session is usually a user initiated query, and may have multiple local and remote events before it is completed.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Tracing.TraceType

Field Summary

Fields

Modifier and Type	Field and Description
static Tracing	instance
protected static org.slf4j.Logger	logger
protected java.util.concurrent.ConcurrentMap<TimeUUID,TraceState>	sessions
static IVersionedSerializer<Tracing.TraceType>	traceTypeSerializer

Constructor Summary

Constructors

Constructor and Description
Tracing()

Method Summary

Modifier and Type	Method and Description
java.util.Map<ParamType,java.lang.Object>	addTraceHeaders(java.util.Map<ParamType,java.lang.Object> addToMutable)
abstract TraceState	begin(java.lang.String request, java.net.InetAddress client, java.util.Map<java.lang.String,java.lang.String> parameters)
TraceState	begin(java.lang.String request, java.util.Map<java.lang.String,java.lang.String> parameters)
void	doneWithNonLocalSession(TraceState state)
TraceState	get()
TraceState	get(TimeUUID sessionId)
TimeUUID	getSessionId()
Tracing.TraceType	getTraceType()
int	getTTL()
TraceState	initializeFromMessage(Message.Header header) Determines the tracing context from a message.
static boolean	isTracing() Indicates if the current thread's execution is being traced.
TimeUUID	newSession(java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)
TimeUUID	newSession(TimeUUID sessionId, java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)
protected TimeUUID	newSession(TimeUUID sessionId, Tracing.TraceType traceType, java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload) This method is intended to be overridden in tracing implementations that need access to the customPayload
TimeUUID	newSession(Tracing.TraceType traceType)
protected abstract TraceState	newTraceState(InetAddressAndPort coordinator, TimeUUID sessionId, Tracing.TraceType traceType)
void	set(TraceState tls)
void	stopSession() Stop the session and record its complete.
protected abstract void	stopSessionImpl()
abstract void	trace(java.nio.ByteBuffer sessionId, java.lang.String message, int ttl) Called for non-local traces (traces that are not initiated by local node == coordinator).
static void	trace(java.lang.String message)
static void	trace(java.lang.String format, java.lang.Object... args)
static void	trace(java.lang.String format, java.lang.Object arg)
static void	trace(java.lang.String format, java.lang.Object arg1, java.lang.Object arg2)
void	traceOutgoingMessage(Message<?> message, int serializedSize, InetAddressAndPort sendTo) Record any tracing data, if enabled on this message.
static void	traceRepair(java.lang.String format, java.lang.Object... args)

Methods inherited from class org.apache.cassandra.concurrent.ExecutorLocals.Impl

set

Methods inherited from class java.lang.Object

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

Field Detail

traceTypeSerializer

public static final IVersionedSerializer<Tracing.TraceType> traceTypeSerializer

logger

protected static final org.slf4j.Logger logger

sessions

protected final java.util.concurrent.ConcurrentMap<TimeUUID,TraceState> sessions

instance

public static final Tracing instance

Constructor Detail

Tracing

public Tracing()

Method Detail

getSessionId

public TimeUUID getSessionId()

getTraceType

public Tracing.TraceType getTraceType()

getTTL

public int getTTL()

isTracing

public static boolean isTracing()

Indicates if the current thread's execution is being traced.

newSession

public TimeUUID newSession(java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)

newSession

public TimeUUID newSession(Tracing.TraceType traceType)

newSession

public TimeUUID newSession(TimeUUID sessionId,
                           java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)

newSession

protected TimeUUID newSession(TimeUUID sessionId,
                              Tracing.TraceType traceType,
                              java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)

This method is intended to be overridden in tracing implementations that need access to the customPayload

doneWithNonLocalSession

public void doneWithNonLocalSession(TraceState state)

stopSession

public void stopSession()

Stop the session and record its complete. Called by coodinator when request is complete.

stopSessionImpl

protected abstract void stopSessionImpl()

get

public TraceState get()

get

public TraceState get(TimeUUID sessionId)

set

public void set(TraceState tls)

begin

public TraceState begin(java.lang.String request,
                        java.util.Map<java.lang.String,java.lang.String> parameters)

begin

public abstract TraceState begin(java.lang.String request,
                                 java.net.InetAddress client,
                                 java.util.Map<java.lang.String,java.lang.String> parameters)

initializeFromMessage

public TraceState initializeFromMessage(Message.Header header)

Determines the tracing context from a message. Does NOT set the threadlocal state.

Parameters:

header - The internode message header

traceOutgoingMessage

public void traceOutgoingMessage(Message<?> message,
                                 int serializedSize,
                                 InetAddressAndPort sendTo)

Record any tracing data, if enabled on this message.

addTraceHeaders

public java.util.Map<ParamType,java.lang.Object> addTraceHeaders(java.util.Map<ParamType,java.lang.Object> addToMutable)

newTraceState

protected abstract TraceState newTraceState(InetAddressAndPort coordinator,
                                            TimeUUID sessionId,
                                            Tracing.TraceType traceType)

traceRepair

public static void traceRepair(java.lang.String format,
                               java.lang.Object... args)

trace

public static void trace(java.lang.String message)

trace

public static void trace(java.lang.String format,
                         java.lang.Object arg)

trace

public static void trace(java.lang.String format,
                         java.lang.Object arg1,
                         java.lang.Object arg2)

trace

public static void trace(java.lang.String format,
                         java.lang.Object... args)

trace

public abstract void trace(java.nio.ByteBuffer sessionId,
                           java.lang.String message,
                           int ttl)

Called for non-local traces (traces that are not initiated by local node == coordinator).