datadog.trace.context

Interface TraceScope

All Superinterfaces:

AutoCloseable, Closeable

public interface TraceScope
extends Closeable

An object which can propagate a datadog trace across multiple threads.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	TraceScope.Continuation Used to pass async context between workers.

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.

Method Detail

capture

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.

Should be called on the parent thread.

captureConcurrent

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.

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.

close

void close()

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

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

isAsyncPropagating

boolean isAsyncPropagating()

If true, this context will propagate across async boundaries.

setAsyncPropagation

void setAsyncPropagation(boolean value)

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

Parameters:

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