org.apache.skywalking.apm.agent.core.context

Interface AsyncSpan

All Known Subinterfaces:

AbstractSpan

All Known Implementing Classes:

AbstractTracingSpan, EntrySpan, ExitSpan, LocalSpan, NoopExitSpan, NoopSpan, StackBasedTracingSpan

public interface AsyncSpan

Span could use these APIs to active and extend its lift cycle across thread. This is typical used in async plugin, especially RPC plugins.

Author:

wusheng

Method Summary

Modifier and Type	Method and Description
AbstractSpan	asyncFinish() Notify the span, it could be finished.
AbstractSpan	prepareForAsync() The span finish at current tracing context, but the current span is still alive, until asyncFinish() called.

Method Detail

prepareForAsync

AbstractSpan prepareForAsync()

The span finish at current tracing context, but the current span is still alive, until asyncFinish() called. This method must be called 1. In original thread(tracing context). 2. Current span is active span. During alive, tags, logs and attributes of the span could be changed, in any thread. The execution times of prepareForAsync() and asyncFinish() must match.

Returns:

the current span

asyncFinish

AbstractSpan asyncFinish()

Notify the span, it could be finished. The execution times of prepareForAsync() and asyncFinish() must match.

Returns:

the current span