org.apache.cassandra.tracing
Class Tracing

java.lang.Object
  org.apache.cassandra.tracing.Tracing

public class Tracing
extends java.lang.Object

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. All events and sessions are stored at table.

Field Summary

static java.lang.String	EVENTS_CF
static org.slf4j.Logger	logger
static java.lang.String	SESSIONS_CF
static java.lang.String	TRACE_HEADER
static java.lang.String	TRACE_KS

Constructor Summary

Tracing()

Method Summary

static void	addColumn(ColumnFamily cf, java.nio.ByteBuffer name, java.net.InetAddress address)
static void	addColumn(ColumnFamily cf, java.nio.ByteBuffer name, int value)
static void	addColumn(ColumnFamily cf, java.nio.ByteBuffer name, long value)
static void	addColumn(ColumnFamily cf, java.nio.ByteBuffer name, java.lang.String value)
void	addParameterColumns(ColumnFamily cf, java.util.Map<java.lang.String,java.lang.String> rawPayload)
void	begin(java.lang.String request, java.util.Map<java.lang.String,java.lang.String> parameters)
static java.nio.ByteBuffer	buildName(CFMetaData meta, java.nio.ByteBuffer... args)
void	continueExistingSession(java.util.UUID sessionId) Activate @param sessionId representing a session we've already seen
TraceState	get()
java.util.UUID	getSessionId()
void	initializeFromMessage(MessageIn<?> message) Updates the threads query context from a message
static Tracing	instance() Fetches and lazy initializes the trace context.
static boolean	isTracing() Indicates if the current thread's execution is being traced.
void	maybeStopNonlocalSession(java.util.UUID sessionId) Removes the state data but does not log it as complete.
java.util.UUID	newSession()
java.util.UUID	newSession(java.util.UUID sessionId)
void	set(TraceState tls)
void	stopSession() Stop the session and record its complete.

Methods inherited from class java.lang.Object

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

Field Detail

TRACE_KS

public static final java.lang.String TRACE_KS

See Also:

Constant Field Values

EVENTS_CF

public static final java.lang.String EVENTS_CF

See Also:

Constant Field Values

SESSIONS_CF

public static final java.lang.String SESSIONS_CF

See Also:

Constant Field Values

TRACE_HEADER

public static final java.lang.String TRACE_HEADER

See Also:

Constant Field Values

logger

public static final org.slf4j.Logger logger

Constructor Detail

Tracing

public Tracing()

Method Detail

instance

public static Tracing instance()

Fetches and lazy initializes the trace context.

addColumn

public static void addColumn(ColumnFamily cf,
                             java.nio.ByteBuffer name,
                             java.net.InetAddress address)

addColumn

public static void addColumn(ColumnFamily cf,
                             java.nio.ByteBuffer name,
                             int value)

addColumn

public static void addColumn(ColumnFamily cf,
                             java.nio.ByteBuffer name,
                             long value)

addColumn

public static void addColumn(ColumnFamily cf,
                             java.nio.ByteBuffer name,
                             java.lang.String value)

addParameterColumns

public void addParameterColumns(ColumnFamily cf,
                                java.util.Map<java.lang.String,java.lang.String> rawPayload)

buildName

public static java.nio.ByteBuffer buildName(CFMetaData meta,
                                            java.nio.ByteBuffer... args)

getSessionId

public java.util.UUID getSessionId()

isTracing

public static boolean isTracing()

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

newSession

public java.util.UUID newSession()

newSession

public java.util.UUID newSession(java.util.UUID sessionId)

maybeStopNonlocalSession

public void maybeStopNonlocalSession(java.util.UUID sessionId)

Removes the state data but does not log it as complete. For use by replica nodes, after replying to the master. Note: checking that the session exists is the job of the caller.

stopSession

public void stopSession()

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

get

public TraceState get()

set

public void set(TraceState tls)

begin

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

initializeFromMessage

public void initializeFromMessage(MessageIn<?> message)

Updates the threads query context from a message

Parameters:

message - The internode message

continueExistingSession

public void continueExistingSession(java.util.UUID sessionId)

Activate @param sessionId representing a session we've already seen