-
- All Implemented Interfaces:
-
com.datadog.trace.api.EndpointCheckpointer,com.datadog.trace.api.Tracer,com.datadog.trace.api.internal.InternalTracer,com.datadog.trace.bootstrap.instrumentation.api.ScopeStateAware
public interface AgentTracer.TracerAPI implements Tracer, InternalTracer, EndpointCheckpointer, ScopeStateAware
-
-
Method Summary
Modifier and Type Method Description abstract AgentSpanstartSpan(String instrumentationName, CharSequence spanName)Create and start a new span. abstract AgentSpanstartSpan(String instrumentationName, CharSequence spanName, long startTimeMicros)Create and start a new span with a given start time. abstract AgentSpanstartSpan(String instrumentationName, CharSequence spanName, AgentSpan.Context parent)Create and start a new span with an explicit parent. abstract AgentSpanstartSpan(String instrumentationName, CharSequence spanName, AgentSpan.Context parent, long startTimeMicros)Create and start a new span with an explicit parent and a given start time. abstract AgentScopeactivateSpan(AgentSpan span, ScopeSource source)abstract AgentScopeactivateSpan(AgentSpan span, ScopeSource source, boolean isAsyncPropagating)abstract AgentScope.ContinuationcaptureSpan(AgentSpan span)abstract voidclosePrevious(boolean finishSpan)abstract AgentScopeactivateNext(AgentSpan span)abstract AgentSpanactiveSpan()abstract AgentScopeactiveScope()abstract AgentPropagationpropagate()abstract AgentSpannoopSpan()AgentTracer.SpanBuilderbuildSpan(CharSequence spanName)Deprecated. abstract AgentTracer.SpanBuilderbuildSpan(String instrumentationName, CharSequence spanName)abstract voidclose()abstract voidaddScopeListener(ScopeListener listener)Attach a scope listener to the global scope manager abstract voidregisterCheckpointer(EndpointCheckpointer checkpointer)Registers the checkpointer abstract voidregisterTimer(Timer timer)abstract TimergetTimer()abstract StringgetTraceId(AgentSpan span)abstract StringgetSpanId(AgentSpan span)abstract TraceConfigcaptureTraceConfig()abstract ProfilingContextIntegrationgetProfilingContext()-
Methods inherited from class com.datadog.trace.api.Tracer
getSpanId, getTraceId -
Methods inherited from class com.datadog.trace.api.internal.InternalTracer
flush -
Methods inherited from class com.datadog.trace.api.EndpointCheckpointer
onRootSpanFinished, onRootSpanStarted -
Methods inherited from class com.datadog.trace.bootstrap.instrumentation.api.ScopeStateAware
newScopeState -
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
-
Method Detail
-
startSpan
abstract AgentSpan startSpan(String instrumentationName, CharSequence spanName)
Create and start a new span.
- Parameters:
instrumentationName- The instrumentation creating the span.spanName- The span operation name.
-
startSpan
abstract AgentSpan startSpan(String instrumentationName, CharSequence spanName, long startTimeMicros)
Create and start a new span with a given start time.
- Parameters:
instrumentationName- The instrumentation creating the span.spanName- The span operation name.startTimeMicros- The span start time, in microseconds.
-
startSpan
abstract AgentSpan startSpan(String instrumentationName, CharSequence spanName, AgentSpan.Context parent)
Create and start a new span with an explicit parent.
- Parameters:
instrumentationName- The instrumentation creating the span.spanName- The span operation name.parent- The parent span context.
-
startSpan
abstract AgentSpan startSpan(String instrumentationName, CharSequence spanName, AgentSpan.Context parent, long startTimeMicros)
Create and start a new span with an explicit parent and a given start time.
- Parameters:
instrumentationName- The instrumentation creating the span.spanName- The span operation name.parent- The parent span context.startTimeMicros- The span start time, in microseconds.
-
activateSpan
abstract AgentScope activateSpan(AgentSpan span, ScopeSource source)
-
activateSpan
abstract AgentScope activateSpan(AgentSpan span, ScopeSource source, boolean isAsyncPropagating)
-
captureSpan
abstract AgentScope.Continuation captureSpan(AgentSpan span)
-
closePrevious
abstract void closePrevious(boolean finishSpan)
-
activateNext
abstract AgentScope activateNext(AgentSpan span)
-
activeSpan
@Nullable() abstract AgentSpan activeSpan()
-
activeScope
abstract AgentScope activeScope()
-
propagate
abstract AgentPropagation propagate()
-
buildSpan
@Deprecated() AgentTracer.SpanBuilder buildSpan(CharSequence spanName)
Deprecated. Use buildSpan instead.
-
buildSpan
abstract AgentTracer.SpanBuilder buildSpan(String instrumentationName, CharSequence spanName)
-
close
abstract void close()
-
addScopeListener
abstract void addScopeListener(ScopeListener listener)
Attach a scope listener to the global scope manager
- Parameters:
listener- listener to attach
-
registerCheckpointer
abstract void registerCheckpointer(EndpointCheckpointer checkpointer)
Registers the checkpointer
-
registerTimer
abstract void registerTimer(Timer timer)
-
getTraceId
abstract String getTraceId(AgentSpan span)
-
captureTraceConfig
abstract TraceConfig captureTraceConfig()
-
getProfilingContext
abstract ProfilingContextIntegration getProfilingContext()
-
-
-
-