io.opentelemetry.sdk.trace.config

Class TraceConfig.Builder

java.lang.Object

io.opentelemetry.sdk.common.export.ConfigBuilder<TraceConfig.Builder>

io.opentelemetry.sdk.trace.config.TraceConfig.Builder

Enclosing class:

TraceConfig

public abstract static class TraceConfig.Builder
extends ConfigBuilder<TraceConfig.Builder>

Builder for TraceConfig.

Nested Class Summary

Nested classes/interfaces inherited from class io.opentelemetry.sdk.common.export.ConfigBuilder

ConfigBuilder.NamingConvention

Method Summary

Modifier and Type	Method and Description
TraceConfig	build() Builds and returns a TraceConfig with the desired values.
protected TraceConfig.Builder	fromConfigMap(Map<String,String> configMap, ConfigBuilder.NamingConvention namingConvention) Sets the configuration values from the given configuration map for only the available keys.
TraceConfig.Builder	readEnvironmentVariables() * Sets the configuration values from environment variables for only the available keys.
TraceConfig.Builder	readProperties(Properties properties) * Sets the configuration values from the given properties object for only the available keys.
TraceConfig.Builder	readSystemProperties() * Sets the configuration values from system properties for only the available keys.
abstract TraceConfig.Builder	setMaxLengthOfAttributeValues(int maxLengthOfAttributeValues) Sets the global default max length of string attribute value in characters.
abstract TraceConfig.Builder	setMaxNumberOfAttributes(int maxNumberOfAttributes) Sets the global default max number of attributes per Span.
abstract TraceConfig.Builder	setMaxNumberOfAttributesPerEvent(int maxNumberOfAttributesPerEvent) Sets the global default max number of attributes per Event.
abstract TraceConfig.Builder	setMaxNumberOfAttributesPerLink(int maxNumberOfAttributesPerLink) Sets the global default max number of attributes per Link.
abstract TraceConfig.Builder	setMaxNumberOfEvents(int maxNumberOfEvents) Sets the global default max number of Events per Span.
abstract TraceConfig.Builder	setMaxNumberOfLinks(int maxNumberOfLinks) Sets the global default max number of Link entries per Span.
abstract TraceConfig.Builder	setSampler(Sampler sampler) Sets the global default Sampler.
TraceConfig.Builder	setSamplerProbability(double samplerProbability) Sets the global default Sampler.

Methods inherited from class io.opentelemetry.sdk.common.export.ConfigBuilder

getBooleanProperty, getDoubleProperty, getIntProperty, getLongProperty, getStringProperty

Methods inherited from class java.lang.Object

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

Method Detail

fromConfigMap

protected TraceConfig.Builder fromConfigMap(Map<String,String> configMap,
                                            ConfigBuilder.NamingConvention namingConvention)

Sets the configuration values from the given configuration map for only the available keys.

Specified by:

fromConfigMap in class ConfigBuilder<TraceConfig.Builder>

Parameters:

configMap - Map holding the configuration values.

Returns:

this

readProperties

public TraceConfig.Builder readProperties(Properties properties)

* Sets the configuration values from the given properties object for only the available keys.

Overrides:

readProperties in class ConfigBuilder<TraceConfig.Builder>

Parameters:

properties - Properties holding the configuration values.

Returns:

this

readEnvironmentVariables

public TraceConfig.Builder readEnvironmentVariables()

* Sets the configuration values from environment variables for only the available keys.

Overrides:

readEnvironmentVariables in class ConfigBuilder<TraceConfig.Builder>

Returns:

this.

readSystemProperties

public TraceConfig.Builder readSystemProperties()

* Sets the configuration values from system properties for only the available keys.

Overrides:

readSystemProperties in class ConfigBuilder<TraceConfig.Builder>

Returns:

this.

setSampler

public abstract TraceConfig.Builder setSampler(Sampler sampler)

Sets the global default Sampler. It must be not null otherwise build() will throw an exception.

Parameters:

sampler - the global default Sampler.

Returns:

this.

setSamplerProbability

public TraceConfig.Builder setSamplerProbability(double samplerProbability)

Sets the global default Sampler. It must be not null otherwise build() will throw an exception.

Parameters:

samplerProbability - the global default probability used to make decisions on Span sampling.

Returns:

this.

setMaxNumberOfAttributes

public abstract TraceConfig.Builder setMaxNumberOfAttributes(int maxNumberOfAttributes)

Sets the global default max number of attributes per Span.

Parameters:

maxNumberOfAttributes - the global default max number of attributes per Span. It must be positive otherwise build() will throw an exception.

Returns:

this.

setMaxNumberOfEvents

public abstract TraceConfig.Builder setMaxNumberOfEvents(int maxNumberOfEvents)

Sets the global default max number of Events per Span.

Parameters:

maxNumberOfEvents - the global default max number of Events per Span. It must be positive otherwise build() will throw an exception.

Returns:

this.

setMaxNumberOfLinks

public abstract TraceConfig.Builder setMaxNumberOfLinks(int maxNumberOfLinks)

Sets the global default max number of Link entries per Span.

Parameters:

maxNumberOfLinks - the global default max number of Link entries per Span. It must be positive otherwise build() will throw an exception.

Returns:

this.

setMaxNumberOfAttributesPerEvent

public abstract TraceConfig.Builder setMaxNumberOfAttributesPerEvent(int maxNumberOfAttributesPerEvent)

Sets the global default max number of attributes per Event.

Parameters:

maxNumberOfAttributesPerEvent - the global default max number of attributes per Event. It must be positive otherwise build() will throw an exception.

Returns:

this.

setMaxNumberOfAttributesPerLink

public abstract TraceConfig.Builder setMaxNumberOfAttributesPerLink(int maxNumberOfAttributesPerLink)

Sets the global default max number of attributes per Link.

Parameters:

maxNumberOfAttributesPerLink - the global default max number of attributes per Link. It must be positive otherwise build() will throw an exception.

Returns:

this.

setMaxLengthOfAttributeValues

public abstract TraceConfig.Builder setMaxLengthOfAttributeValues(int maxLengthOfAttributeValues)

Sets the global default max length of string attribute value in characters.

Parameters:

maxLengthOfAttributeValues - the global default max length of string attribute value in characters. It must be non-negative (or TraceConfig.UNLIMITED_ATTRIBUTE_LENGTH) otherwise build() will throw an exception.

Returns:

this.

build

public TraceConfig build()

Builds and returns a TraceConfig with the desired values.

Returns:

a TraceConfig with the desired values.

Throws:

IllegalArgumentException - if any of the max numbers are not positive.