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

Class ExitSpan

java.lang.Object

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

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

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

All Implemented Interfaces:

AsyncSpan, AbstractSpan, WithPeerInfo

public class ExitSpan
extends StackBasedTracingSpan
implements WithPeerInfo

The ExitSpan represents a service consumer point, such as Feign, Okhttp client for an Http service. It is an exit point or a leaf span(our old name) of trace tree. In a single rpc call, because of a combination of discovery libs, there maybe contain multi-layer exit point: The ExitSpan only presents the first one. Such as: Dubbox - Apache Httpcomponent - ...(Remote) The ExitSpan represents the Dubbox span, and ignore the httpcomponent span's info.

Author:

wusheng

Field Summary

Fields inherited from class org.apache.skywalking.apm.agent.core.context.trace.StackBasedTracingSpan

peer, peerId, stackDepth

Fields inherited from class org.apache.skywalking.apm.agent.core.context.trace.AbstractTracingSpan

componentId, componentName, context, endTime, errorOccurred, isInAsyncMode, layer, logs, operationId, operationName, parentSpanId, refs, spanId, startTime, tags

Constructor Summary

Constructors

Constructor and Description
ExitSpan(int spanId, int parentSpanId, int operationId, int peerId)
ExitSpan(int spanId, int parentSpanId, int operationId, String peer)
ExitSpan(int spanId, int parentSpanId, String operationName, int peerId)
ExitSpan(int spanId, int parentSpanId, String operationName, String peer)

Method Summary

Modifier and Type	Method and Description
String	getPeer()
int	getPeerId()
boolean	isEntry()
boolean	isExit()
ExitSpan	log(Throwable t) Record an exception event of the current walltime timestamp.
AbstractTracingSpan	setComponent(Component component) Set the component of this span, with internal supported.
AbstractTracingSpan	setComponent(String componentName) Set the component name.
AbstractTracingSpan	setLayer(SpanLayer layer)
AbstractTracingSpan	setOperationId(int operationId) Set the operation id, which compress by the name.
AbstractTracingSpan	setOperationName(String operationName) Set the operation name, just because these is not compress dictionary value for this name.
ExitSpan	start() Set the AbstractTracingSpan.startTime, when the first start, which means the first service provided.
AbstractTracingSpan	tag(AbstractTag tag, String value)
ExitSpan	tag(String key, String value) Set a key:value tag on the Span.

Methods inherited from class org.apache.skywalking.apm.agent.core.context.trace.StackBasedTracingSpan

finish, setPeer, transform

Methods inherited from class org.apache.skywalking.apm.agent.core.context.trace.AbstractTracingSpan

asyncFinish, errorOccurred, getOperationId, getOperationName, getSpanId, log, prepareForAsync, ref, start

Methods inherited from class java.lang.Object

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

Constructor Detail

ExitSpan

public ExitSpan(int spanId,
                int parentSpanId,
                String operationName,
                String peer)

ExitSpan

public ExitSpan(int spanId,
                int parentSpanId,
                int operationId,
                int peerId)

ExitSpan

public ExitSpan(int spanId,
                int parentSpanId,
                int operationId,
                String peer)

ExitSpan

public ExitSpan(int spanId,
                int parentSpanId,
                String operationName,
                int peerId)

Method Detail

start

public ExitSpan start()

Set the AbstractTracingSpan.startTime, when the first start, which means the first service provided.

Specified by:

start in interface AbstractSpan

Overrides:

start in class AbstractTracingSpan

Returns:

this Span instance, for chaining

tag

public ExitSpan tag(String key,
                    String value)

Description copied from class: AbstractTracingSpan

Set a key:value tag on the Span.

Specified by:

tag in interface AbstractSpan

Overrides:

tag in class AbstractTracingSpan

Returns:

this Span instance, for chaining

tag

public AbstractTracingSpan tag(AbstractTag tag,
                               String value)

Specified by:

tag in interface AbstractSpan

Overrides:

tag in class AbstractTracingSpan

Returns:

setLayer

public AbstractTracingSpan setLayer(SpanLayer layer)

Specified by:

setLayer in interface AbstractSpan

Overrides:

setLayer in class AbstractTracingSpan

setComponent

public AbstractTracingSpan setComponent(Component component)

Description copied from class: AbstractTracingSpan

Set the component of this span, with internal supported. Highly recommend to use this way.

Specified by:

setComponent in interface AbstractSpan

Overrides:

setComponent in class AbstractTracingSpan

Returns:

span instance, for chaining.

setComponent

public AbstractTracingSpan setComponent(String componentName)

Description copied from class: AbstractTracingSpan

Set the component name. By using this, cost more memory and network.

Specified by:

setComponent in interface AbstractSpan

Overrides:

setComponent in class AbstractTracingSpan

Returns:

span instance, for chaining.

log

public ExitSpan log(Throwable t)

Description copied from class: AbstractTracingSpan

Record an exception event of the current walltime timestamp.

Specified by:

log in interface AbstractSpan

Overrides:

log in class AbstractTracingSpan

Parameters:

t - any subclass of Throwable, which occurs in this span.

Returns:

the Span, for chaining

setOperationName

public AbstractTracingSpan setOperationName(String operationName)

Description copied from class: AbstractTracingSpan

Set the operation name, just because these is not compress dictionary value for this name. Use the entire string temporarily, the agent will compress this name in async mode.

Specified by:

setOperationName in interface AbstractSpan

Overrides:

setOperationName in class AbstractTracingSpan

Returns:

span instance, for chaining.

setOperationId

public AbstractTracingSpan setOperationId(int operationId)

Description copied from class: AbstractTracingSpan

Set the operation id, which compress by the name.

Specified by:

setOperationId in interface AbstractSpan

Overrides:

setOperationId in class AbstractTracingSpan

Returns:

span instance, for chaining.

getPeerId

public int getPeerId()

Specified by:

getPeerId in interface WithPeerInfo

getPeer

public String getPeer()

Specified by:

getPeer in interface WithPeerInfo

isEntry

public boolean isEntry()

Specified by:

isEntry in interface AbstractSpan

Returns:

true if the actual span is an entry span.

isExit

public boolean isExit()

Specified by:

isExit in interface AbstractSpan

Returns:

true if the actual span is an exit span.