com.lightstep.tracer.shared

Class Options

java.lang.Object

com.lightstep.tracer.shared.Options

public final class Options
extends Object

Options control behaviors specific to the LightStep tracer.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Options.CollectorClient Select the client provider explicitly.
static interface	Options.OkHttpDns A DNS service passed to the OkHttp transport to resolve IP addresses for hostnames.
static class	Options.OptionsBuilder

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_MAX_BUFFERED_SPANS Default maximum number of Spans buffered locally (a protective mechanism)
static int	VERBOSITY_DEBUG all internal log statements, including debugging details
static int	VERBOSITY_ERRORS_ONLY all errors are echoed locally
static int	VERBOSITY_FIRST_ERROR_ONLY only the first error encountered will be echoed locally
static int	VERBOSITY_INFO all errors, warnings, and info statements are echoed locally
static int	VERBOSITY_NONE never produce local output

Method Summary

Modifier and Type	Method and Description
Options	disableResetClient() Provided so implementations of AbstractTracer can turn off resetClient by default.
Options	setDefaultReportingIntervalMillis(int value) If this instance of Options has an overridden maxReportingIntervalMillis, returns this instance of Options with that value.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MAX_BUFFERED_SPANS

public static final int DEFAULT_MAX_BUFFERED_SPANS

Default maximum number of Spans buffered locally (a protective mechanism)

See Also:

Constant Field Values

VERBOSITY_DEBUG

public static final int VERBOSITY_DEBUG

all internal log statements, including debugging details

See Also:

Constant Field Values

VERBOSITY_INFO

public static final int VERBOSITY_INFO

all errors, warnings, and info statements are echoed locally

See Also:

Constant Field Values

VERBOSITY_ERRORS_ONLY

public static final int VERBOSITY_ERRORS_ONLY

all errors are echoed locally

See Also:

Constant Field Values

VERBOSITY_FIRST_ERROR_ONLY

public static final int VERBOSITY_FIRST_ERROR_ONLY

only the first error encountered will be echoed locally

See Also:

Constant Field Values

VERBOSITY_NONE

public static final int VERBOSITY_NONE

never produce local output

See Also:

Constant Field Values

Method Detail

setDefaultReportingIntervalMillis

public Options setDefaultReportingIntervalMillis(int value)

If this instance of Options has an overridden maxReportingIntervalMillis, returns this instance of Options with that value. If this instance of Options is using the default DEFAULT_REPORTING_INTERVAL_MILLIS then creates a new instance of Options and overrides maxReportingIntervalMillis with the provided value.

Parameters:

value - A new value for maxReportingIntervalMillis. Will only be used if this Options object is current set to the default value for maxReportingIntervalMillis.

Throws:

IllegalArgumentException - If this Options object has an malformed collector url.

disableResetClient

public Options disableResetClient()

Provided so implementations of AbstractTracer can turn off resetClient by default. For example, Android tracer may not want resetClient.