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

Class TraceSegment

java.lang.Object

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

public class TraceSegment
extends Object

TraceSegment is a segment or fragment of the distributed trace. See https://github.com/opentracing/specification/blob/master/specification.md#the-opentracing-data-model A TraceSegment means the segment, which exists in current Thread. And the distributed trace is formed by multi TraceSegments, because the distributed trace crosses multi-processes, multi-threads.

Author:

wusheng

Constructor Summary

Constructors

Constructor and Description
TraceSegment() Create a default/empty trace segment, with current time as start time, and generate a new segment id.

Method Summary

Modifier and Type	Method and Description
void	archive(AbstractTracingSpan finishedSpan) After AbstractSpan is finished, as be controller by "skywalking-api" module, notify the TraceSegment to archive it.
long	createTime()
TraceSegment	finish(boolean isSizeLimited) Finish this TraceSegment.
int	getApplicationInstanceId()
List<TraceSegmentRef>	getRefs()
List<DistributedTraceId>	getRelatedGlobalTraces()
int	getServiceId()
ID	getTraceSegmentId()
boolean	hasRef()
boolean	isIgnore()
boolean	isSingleSpanSegment()
void	ref(TraceSegmentRef refSegment) Establish the link between this segment and its parents.
void	relatedGlobalTraces(DistributedTraceId distributedTraceId) Establish the line between this segment and all relative global trace ids.
void	setIgnore(boolean ignore)
String	toString()
UpstreamSegment	transform() This is a high CPU cost method, only called when sending to collector or test cases.

Methods inherited from class java.lang.Object

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

Constructor Detail

TraceSegment

public TraceSegment()

Create a default/empty trace segment, with current time as start time, and generate a new segment id.

Method Detail

ref

public void ref(TraceSegmentRef refSegment)

Establish the link between this segment and its parents.

Parameters:

refSegment - TraceSegmentRef

relatedGlobalTraces

public void relatedGlobalTraces(DistributedTraceId distributedTraceId)

Establish the line between this segment and all relative global trace ids.

archive

public void archive(AbstractTracingSpan finishedSpan)

After AbstractSpan is finished, as be controller by "skywalking-api" module, notify the TraceSegment to archive it.

Parameters:

finishedSpan -

finish

public TraceSegment finish(boolean isSizeLimited)

Finish this TraceSegment.

return this, for chaining

getTraceSegmentId

public ID getTraceSegmentId()

getServiceId

public int getServiceId()

hasRef

public boolean hasRef()

getRefs

public List<TraceSegmentRef> getRefs()

getRelatedGlobalTraces

public List<DistributedTraceId> getRelatedGlobalTraces()

isSingleSpanSegment

public boolean isSingleSpanSegment()

isIgnore

public boolean isIgnore()

setIgnore

public void setIgnore(boolean ignore)

transform

public UpstreamSegment transform()

This is a high CPU cost method, only called when sending to collector or test cases.

Returns:

the segment as GRPC service parameter

toString

public String toString()

Overrides:

toString in class Object

getApplicationInstanceId

public int getApplicationInstanceId()

createTime

public long createTime()