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.AgentTracer.TracerAPI , com.datadog.trace.bootstrap.instrumentation.api.ScopeStateAware
```
public class CoreTracer
 implements AgentTracer.TracerAPI
                    
```
Main entrypoint into the tracer implementation. In addition to implementing com.datadog.trace.api.Tracer and TracerAPI, it coordinates many functions necessary creating, reporting, and propagating traces

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`public class`	`CoreTracer.CoreTracerBuilder`
`public class`	`CoreTracer.CoreSpanBuilder`	Spans are built using this builder

Field Summary

Fields
Modifier and Type	Field	Description
`private final int`	`partialFlushMinSpans`
`private Timer`	`timer`
`private final TagInterceptor`	`tagInterceptor`

Method Summary

Modifier and Type	Method	Description
`int`	`getPartialFlushMinSpans()`
`Timer`	`getTimer()`
`TagInterceptor`	`getTagInterceptor()`
`CoreTracer.ConfigSnapshot`	`captureTraceConfig()`
`void`	`onRootSpanFinished(AgentSpan root, EndpointTracker tracker)`	Callback to be called when a root span is written (together with the trace)
`EndpointTracker`	`onRootSpanStarted(AgentSpan root)`	Callback to be called when a root span is started
`ScopeState`	`newScopeState()`
`CoreTracer.CoreSpanBuilder`	`buildSpan(String instrumentationName, CharSequence operationName)`
`AgentSpan`	`startSpan(String instrumentationName, CharSequence spanName)`	Create and start a new span.
`AgentSpan`	`startSpan(String instrumentationName, CharSequence spanName, long startTimeMicros)`	Create and start a new span with a given start time.
`AgentSpan`	`startSpan(String instrumentationName, CharSequence spanName, AgentSpan.Context parent)`	Create and start a new span with an explicit parent.
`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.
`AgentScope`	`activateSpan(AgentSpan span)`
`AgentScope`	`activateSpan(AgentSpan span, ScopeSource source)`
`AgentScope`	`activateSpan(AgentSpan span, ScopeSource source, boolean isAsyncPropagating)`
`AgentScope.Continuation`	`captureSpan(AgentSpan span)`
`void`	`closePrevious(boolean finishSpan)`
`AgentScope`	`activateNext(AgentSpan span)`
`AgentSpan`	`activeSpan()`
`AgentScope`	`activeScope()`
`AgentPropagation`	`propagate()`
`AgentSpan`	`noopSpan()`
`String`	`getTraceId()`	Get the trace id of the active trace.
`String`	`getSpanId()`	Get the span id of the active span of the active trace.
`String`	`getTraceId(AgentSpan span)`
`String`	`getSpanId(AgentSpan span)`
`void`	`addScopeListener(ScopeListener listener)`	Attach a scope listener to the global scope manager
`void`	`registerCheckpointer(EndpointCheckpointer implementation)`	Registers the checkpointer
`void`	`registerTimer(Timer timer)`
`void`	`close()`
`void`	`flush()`
`ProfilingContextIntegration`	`getProfilingContext()`

Methods inherited from class com.datadog.trace.bootstrap.instrumentation.api.AgentTracer.TracerAPI
activateSpan, addScopeListener, buildSpan, buildSpan, captureSpan, captureTraceConfig, registerCheckpointer, startSpan, startSpan, startSpan, startSpan
Methods inherited from class com.datadog.trace.api.EndpointCheckpointer
onRootSpanFinished, onRootSpanStarted
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getPartialFlushMinSpans
```
 int getPartialFlushMinSpans()
```

getTimer
```
 Timer getTimer()
```

getTagInterceptor
```
 TagInterceptor getTagInterceptor()
```

captureTraceConfig

 CoreTracer.ConfigSnapshot captureTraceConfig()

onRootSpanFinished
```
 void onRootSpanFinished(AgentSpan root, EndpointTracker tracker)
```
Callback to be called when a root span is written (together with the trace)

Parameters:

tracker - the endpoint tracker

onRootSpanStarted
```
 EndpointTracker onRootSpanStarted(AgentSpan root)
```
Callback to be called when a root span is started

newScopeState
```
 ScopeState newScopeState()
```

buildSpan

 CoreTracer.CoreSpanBuilder buildSpan(String instrumentationName, CharSequence operationName)

startSpan
```
 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
```
 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
```
 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
```
 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

 AgentScope activateSpan(AgentSpan span)

activateSpan

 AgentScope activateSpan(AgentSpan span, ScopeSource source)

activateSpan

 AgentScope activateSpan(AgentSpan span, ScopeSource source, boolean isAsyncPropagating)

captureSpan

 AgentScope.Continuation captureSpan(AgentSpan span)

closePrevious

 void closePrevious(boolean finishSpan)

activateNext

 AgentScope activateNext(AgentSpan span)

activeSpan
```
 AgentSpan activeSpan()
```

activeScope
```
 AgentScope activeScope()
```

propagate
```
 AgentPropagation propagate()
```

noopSpan
```
 AgentSpan noopSpan()
```

getTraceId
```
 String getTraceId()
```
Get the trace id of the active trace. Returns 0 if there is no active trace.

getSpanId
```
 String getSpanId()
```
Get the span id of the active span of the active trace. Returns 0 if there is no active trace.

getTraceId
```
 String getTraceId(AgentSpan span)
```

getSpanId
```
 String getSpanId(AgentSpan span)
```

addScopeListener
```
 void addScopeListener(ScopeListener listener)
```
Attach a scope listener to the global scope manager

Parameters:

listener - listener to attach

registerCheckpointer

 void registerCheckpointer(EndpointCheckpointer implementation)

Registers the checkpointer

registerTimer
```
 void registerTimer(Timer timer)
```

close
```
 void close()
```

flush
```
 void flush()
```

getProfilingContext

 ProfilingContextIntegration getProfilingContext()

Class CoreTracer

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class com.datadog.trace.bootstrap.instrumentation.api.AgentTracer.TracerAPI

Methods inherited from class com.datadog.trace.api.EndpointCheckpointer

Methods inherited from class java.lang.Object

Method Detail

getPartialFlushMinSpans

getTimer

getTagInterceptor

captureTraceConfig

onRootSpanFinished

onRootSpanStarted

newScopeState

buildSpan

startSpan

startSpan

startSpan

startSpan

activateSpan

activateSpan

activateSpan

captureSpan

closePrevious

activateNext

activeSpan

activeScope

propagate

noopSpan

getTraceId

getSpanId

getTraceId

getSpanId

addScopeListener

registerCheckpointer

registerTimer

close

flush

getProfilingContext