datadog.trace.context

Class NoopTraceScope

java.lang.Object

datadog.trace.context.NoopTraceScope

All Implemented Interfaces:

TraceScope, Closeable, AutoCloseable

public class NoopTraceScope
extends Object
implements TraceScope

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NoopTraceScope.NoopContinuation

Nested classes/interfaces inherited from interface datadog.trace.context.TraceScope

TraceScope.Continuation

Field Summary

Fields

Modifier and Type	Field and Description
static NoopTraceScope	INSTANCE

Method Summary

Modifier and Type	Method and Description
TraceScope.Continuation	capture() Prevent the trace attached to this TraceScope from reporting until the returned Continuation is either activated (and the returned scope is closed), or canceled.
TraceScope.Continuation	captureConcurrent() Prevent the trace attached to this TraceScope from reporting until the returned Continuation is either activated (and the returned scope is closed), or canceled.
void	close() Close the activated context and allow any underlying spans to finish.
boolean	isAsyncPropagating() If true, this context will propagate across async boundaries.
void	setAsyncPropagation(boolean value) Enable or disable async propagation.

Methods inherited from class java.lang.Object

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

Field Detail

INSTANCE

public static final NoopTraceScope INSTANCE

Method Detail

capture

public TraceScope.Continuation capture()

Description copied from interface: TraceScope

Prevent the trace attached to this TraceScope from reporting until the returned Continuation is either activated (and the returned scope is closed), or canceled.

Should be called on the parent thread.

Specified by:

capture in interface TraceScope

captureConcurrent

public TraceScope.Continuation captureConcurrent()

Description copied from interface: TraceScope

Prevent the trace attached to this TraceScope from reporting until the returned Continuation is either activated (and the returned scope is closed), or canceled.

Should be called on the parent thread.

If the returned TraceScope.Continuation is activated, it needs to be canceled in addition to the returned TraceScope being closed. This is to allow multiple concurrent threads that activate the continuation to race in a safe way, and close the scopes without fear of closing the related Span prematurely.

Specified by:

captureConcurrent in interface TraceScope

close

public void close()

Description copied from interface: TraceScope

Close the activated context and allow any underlying spans to finish.

Specified by:

close in interface TraceScope

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

isAsyncPropagating

public boolean isAsyncPropagating()

Description copied from interface: TraceScope

If true, this context will propagate across async boundaries.

Specified by:

isAsyncPropagating in interface TraceScope

setAsyncPropagation

public void setAsyncPropagation(boolean value)

Description copied from interface: TraceScope

Enable or disable async propagation. Async propagation is initially set to false.

Specified by:

setAsyncPropagation in interface TraceScope

Parameters:

value - The new propagation value. True == propagate. False == don't propagate.