Package com.lightstep.tracer.shared

Class AbstractTracer

java.lang.Object

com.lightstep.tracer.shared.AbstractTracer

All Implemented Interfaces:

io.opentracing.Tracer

public abstract class AbstractTracer
extends java.lang.Object
implements io.opentracing.Tracer

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	AbstractTracer.InternalLogLevel	For mapping internal logs to Android log levels without importing Android packages.

Nested classes/interfaces inherited from interface io.opentracing.Tracer

io.opentracing.Tracer.SpanBuilder

Field Summary

Fields

Modifier and Type	Field	Description
protected static java.lang.String	LIGHTSTEP_TRACER_PLATFORM_KEY
protected static java.lang.String	LIGHTSTEP_TRACER_PLATFORM_VERSION_KEY
protected static java.lang.String	LIGHTSTEP_TRACER_VERSION_KEY
protected java.lang.Object	mutex

Constructor Summary

Constructors

Constructor	Description
AbstractTracer(Options options)

Method Summary

Modifier and Type	Method	Description
io.opentracing.Span	activeSpan()
protected void	addTracerTag(java.lang.String key, java.lang.Object value)
io.opentracing.Tracer.SpanBuilder	buildSpan(java.lang.String operationName)
protected void	debug(java.lang.String s)	Internal logging.
protected void	debug(java.lang.String msg, java.lang.Object payload)	Internal logging.
protected void	error(java.lang.String s)	Internal logging.
protected void	error(java.lang.String msg, java.lang.Object payload)	Internal error.
<C> io.opentracing.SpanContext	extract(io.opentracing.propagation.Format<C> format, C carrier)
java.lang.Boolean	flush(long timeoutMillis)	Initiates a flush of data to the collectors.
protected abstract SimpleFuture<java.lang.Boolean>	flushInternal(boolean explicitRequest)
protected void	info(java.lang.String s)	Internal logging.
protected void	info(java.lang.String msg, java.lang.Object payload)	Internal logging.
<C> void	inject(io.opentracing.SpanContext spanContext, io.opentracing.propagation.Format<C> format, C carrier)
boolean	isDisabled()
protected abstract void	printLogToConsole(AbstractTracer.InternalLogLevel level, java.lang.String msg, java.lang.Object payload)
io.opentracing.ScopeManager	scopeManager()
protected boolean	sendReport(boolean explicitRequest)	Does the work of a flush by sending spans to the collector.
Status	status()	Internal method used primarily for unit testing and debugging.
protected void	warn(java.lang.String s)	Internal logging.
protected void	warn(java.lang.String msg, java.lang.Object payload)	Internal warning.

Methods inherited from class java.lang.Object

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

Field Detail

LIGHTSTEP_TRACER_PLATFORM_KEY

protected static final java.lang.String LIGHTSTEP_TRACER_PLATFORM_KEY

See Also:

Constant Field Values

LIGHTSTEP_TRACER_PLATFORM_VERSION_KEY

protected static final java.lang.String LIGHTSTEP_TRACER_PLATFORM_VERSION_KEY

See Also:

Constant Field Values

LIGHTSTEP_TRACER_VERSION_KEY

protected static final java.lang.String LIGHTSTEP_TRACER_VERSION_KEY

See Also:

Constant Field Values

mutex

protected final java.lang.Object mutex

Constructor Detail

AbstractTracer

public AbstractTracer(Options options)

Method Detail

isDisabled

public boolean isDisabled()

scopeManager

public io.opentracing.ScopeManager scopeManager()

Specified by:

scopeManager in interface io.opentracing.Tracer

activeSpan

public io.opentracing.Span activeSpan()

Specified by:

activeSpan in interface io.opentracing.Tracer

buildSpan

public io.opentracing.Tracer.SpanBuilder buildSpan(java.lang.String operationName)

Specified by:

buildSpan in interface io.opentracing.Tracer

inject

public <C> void inject(io.opentracing.SpanContext spanContext,
                       io.opentracing.propagation.Format<C> format,
                       C carrier)

Specified by:

inject in interface io.opentracing.Tracer

extract

public <C> io.opentracing.SpanContext extract(io.opentracing.propagation.Format<C> format,
                                              C carrier)

Specified by:

extract in interface io.opentracing.Tracer

flush

public java.lang.Boolean flush(long timeoutMillis)

Initiates a flush of data to the collectors. Method does not return until the flush is complete, or has timed out.

Parameters:

timeoutMillis - The amount of time, in milliseconds, to allow for the flush to complete

Returns:

True if the flush completed within the time allotted, false otherwise.

flushInternal

protected abstract SimpleFuture<java.lang.Boolean> flushInternal(boolean explicitRequest)

sendReport

protected boolean sendReport(boolean explicitRequest)

Does the work of a flush by sending spans to the collector.

Parameters:

explicitRequest - if true, the report request was made explicitly rather than implicitly (via a reporting loop) and therefore the code should make a 'best effort' to truly report (i.e. send even if the clock state is not ready).

Returns:

true if the report was sent successfully

addTracerTag

protected void addTracerTag(java.lang.String key,
                            java.lang.Object value)

debug

protected void debug(java.lang.String s)

Internal logging.

debug

protected void debug(java.lang.String msg,
                     java.lang.Object payload)

Internal logging.

info

protected void info(java.lang.String s)

Internal logging.

info

protected void info(java.lang.String msg,
                    java.lang.Object payload)

Internal logging.

warn

protected void warn(java.lang.String s)

Internal logging.

warn

protected void warn(java.lang.String msg,
                    java.lang.Object payload)

Internal warning.

error

protected void error(java.lang.String s)

Internal logging.

error

protected void error(java.lang.String msg,
                     java.lang.Object payload)

Internal error.

printLogToConsole

protected abstract void printLogToConsole(AbstractTracer.InternalLogLevel level,
                                          java.lang.String msg,
                                          java.lang.Object payload)

status

public Status status()

Internal method used primarily for unit testing and debugging. This is not part of the OpenTracing API and is not a supported API. Copies the internal state/status into an object that's easier to check against in unit tests.