Module io.helidon.webserver.observe.tracing

Package io.helidon.webserver.observe.tracing

Class TracingObserverConfig.BuilderBase<BUILDER extends TracingObserverConfig.BuilderBase<BUILDER,PROTOTYPE>,PROTOTYPE extends TracingObserverConfig>

java.lang.Object

io.helidon.webserver.observe.ObserverConfigBase.BuilderBase<BUILDER,PROTOTYPE>

io.helidon.webserver.observe.tracing.TracingObserverConfig.BuilderBase<BUILDER,PROTOTYPE>

Type Parameters:

BUILDER - type of the builder extending this abstract builder

PROTOTYPE - type of the prototype interface that would be built by Prototype.Builder.buildPrototype()

All Implemented Interfaces:

Prototype.Builder<BUILDER,PROTOTYPE>, Prototype.ConfiguredBuilder<BUILDER,PROTOTYPE>

Direct Known Subclasses:

TracingObserverConfig.Builder

Enclosing interface:

TracingObserverConfig

public abstract static class TracingObserverConfig.BuilderBase<BUILDER extends TracingObserverConfig.BuilderBase<BUILDER,PROTOTYPE>,PROTOTYPE extends TracingObserverConfig>
extends ObserverConfigBase.BuilderBase<BUILDER,PROTOTYPE>
implements Prototype.ConfiguredBuilder<BUILDER,PROTOTYPE>

Fluent API builder base for TracingObserver.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	TracingObserverConfig.BuilderBase.TracingObserverConfigImpl	Generated implementation of the prototype, can be extended by descendant prototype implementations.

Nested classes/interfaces inherited from class io.helidon.webserver.observe.ObserverConfigBase.BuilderBase

ObserverConfigBase.BuilderBase.ObserverConfigBaseImpl

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BuilderBase()	Protected to support extensibility.

Method Summary

Modifier and Type	Method	Description
BUILDER	addPathConfig(PathTracingConfig pathConfig)	Path specific configuration of tracing.
BUILDER	addPathConfig(Consumer<PathTracingConfig.Builder> consumer)	Path specific configuration of tracing.
BUILDER	addPathConfigs(List<? extends PathTracingConfig> pathConfigs)	Path specific configuration of tracing.
BUILDER	addSocket(String socket)	Sockets to trace.
BUILDER	addSockets(Set<? extends String> sockets)	Sockets to trace.
Optional<Config>	config()	If this instance was configured, this would be the config instance used.
BUILDER	config(Config config)	Update builder from configuration (node of this type).
TracingConfig	envConfig()	Use the provided configuration as a default for any request.
BUILDER	envConfig(TracingConfig envConfig)	Use the provided configuration as a default for any request.
BUILDER	envConfig(Consumer<TracingConfig.Builder> consumer)	Use the provided configuration as a default for any request.
BUILDER	envConfig(Supplier<? extends TracingConfig> supplier)	Use the provided configuration as a default for any request.
BUILDER	from(TracingObserverConfig prototype)	Update this builder from an existing prototype instance.
BUILDER	from(TracingObserverConfig.BuilderBase<?,?> builder)	Update this builder from an existing prototype builder instance.
List<PathTracingConfig>	pathConfigs()	Path specific configuration of tracing.
BUILDER	pathConfigs(List<? extends PathTracingConfig> pathConfigs)	Path specific configuration of tracing.
protected void	preBuildPrototype()	Handles providers and decorators.
Set<String>	sockets()	Sockets to trace.
BUILDER	sockets(Set<? extends String> sockets)	Sockets to trace.
String	toString()
Optional<Tracer>	tracer()	Tracer to use to extract inbound span context.
BUILDER	tracer(Tracer tracer)	Tracer to use to extract inbound span context.
protected void	validatePrototype()	Validates required properties.
double	weight()	Weight of the feature registered with WebServer.
BUILDER	weight(double weight)	Weight of the feature registered with WebServer.

Methods inherited from class io.helidon.webserver.observe.ObserverConfigBase.BuilderBase

enabled, enabled, from, from, name, name

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.helidon.builder.api.Prototype.Builder

buildPrototype, self

Methods inherited from interface io.helidon.builder.api.Prototype.ConfiguredBuilder

discoverService, discoverServices

Constructor Details

BuilderBase

protected BuilderBase()

Protected to support extensibility.

Method Details

from

public BUILDER from(TracingObserverConfig prototype)

Update this builder from an existing prototype instance. This method disables automatic service discovery.

Parameters:

prototype - existing prototype to update this builder from

Returns:

updated builder instance

from

public BUILDER from(TracingObserverConfig.BuilderBase<?,?> builder)

Update this builder from an existing prototype builder instance.

Parameters:

builder - existing builder prototype to update this builder from

Returns:

updated builder instance

config

public BUILDER config(Config config)

Update builder from configuration (node of this type). If a value is present in configuration, it would override currently configured values.

Specified by:

config in interface Prototype.ConfiguredBuilder<BUILDER extends TracingObserverConfig.BuilderBase<BUILDER,PROTOTYPE>,PROTOTYPE extends TracingObserverConfig>

Overrides:

config in class ObserverConfigBase.BuilderBase<BUILDER extends TracingObserverConfig.BuilderBase<BUILDER,PROTOTYPE>,PROTOTYPE extends TracingObserverConfig>

Parameters:

config - configuration instance used to obtain values to update this builder

Returns:

updated builder instance

envConfig

public BUILDER envConfig(TracingConfig envConfig)

Use the provided configuration as a default for any request.

Parameters:

envConfig - default web server tracing configuration

Returns:

updated builder instance

See Also:

• envConfig()

envConfig

public BUILDER envConfig(Consumer<TracingConfig.Builder> consumer)

Use the provided configuration as a default for any request.

Parameters:

consumer - consumer of builder for default web server tracing configuration

Returns:

updated builder instance

See Also:

• envConfig()

envConfig

public BUILDER envConfig(Supplier<? extends TracingConfig> supplier)

Use the provided configuration as a default for any request.

Parameters:

supplier - supplier of default web server tracing configuration

Returns:

updated builder instance

See Also:

• envConfig()

pathConfigs

public BUILDER pathConfigs(List<? extends PathTracingConfig> pathConfigs)

Path specific configuration of tracing.

Parameters:

pathConfigs - configuration of tracing for specific paths

Returns:

updated builder instance

See Also:

• pathConfigs()

addPathConfigs

public BUILDER addPathConfigs(List<? extends PathTracingConfig> pathConfigs)

Path specific configuration of tracing.

Parameters:

pathConfigs - configuration of tracing for specific paths

Returns:

updated builder instance

See Also:

• pathConfigs()

addPathConfig

public BUILDER addPathConfig(PathTracingConfig pathConfig)

Path specific configuration of tracing.

Parameters:

pathConfig - configuration of tracing for specific paths

Returns:

updated builder instance

See Also:

• pathConfigs()

addPathConfig

public BUILDER addPathConfig(Consumer<PathTracingConfig.Builder> consumer)

Path specific configuration of tracing.

Parameters:

consumer - configuration of tracing for specific paths

Returns:

updated builder instance

See Also:

• pathConfigs()

tracer

public BUILDER tracer(Tracer tracer)

Tracer to use to extract inbound span context.

Parameters:

tracer - tracer to use

Returns:

updated builder instance

See Also:

• tracer()

weight

public BUILDER weight(double weight)

Weight of the feature registered with WebServer. Changing weight may cause tracing to be executed at a different time (such as after security, or even after all routes). Please understand feature weights before changing this order.

Parameters:

weight - weight of tracing feature

Returns:

updated builder instance

See Also:

• weight()

sockets

public BUILDER sockets(Set<? extends String> sockets)

Sockets to trace.

If empty, all sockets will be traced. The default socket without any tag, additional sockets with a tag with the socket name.

Parameters:

sockets - set of sockets to trace

Returns:

updated builder instance

See Also:

• sockets()

addSockets

public BUILDER addSockets(Set<? extends String> sockets)

Sockets to trace.

If empty, all sockets will be traced. The default socket without any tag, additional sockets with a tag with the socket name.

Parameters:

sockets - set of sockets to trace

Returns:

updated builder instance

See Also:

• sockets()

addSocket

public BUILDER addSocket(String socket)

Sockets to trace.

If empty, all sockets will be traced. The default socket without any tag, additional sockets with a tag with the socket name.

Parameters:

socket - set of sockets to trace

Returns:

updated builder instance

See Also:

• sockets()

envConfig

public TracingConfig envConfig()

Use the provided configuration as a default for any request.

Returns:

the env config

pathConfigs

public List<PathTracingConfig> pathConfigs()

Path specific configuration of tracing.

Returns:

the path configs

tracer

public Optional<Tracer> tracer()

Tracer to use to extract inbound span context.

Returns:

the tracer

weight

public double weight()

Weight of the feature registered with WebServer. Changing weight may cause tracing to be executed at a different time (such as after security, or even after all routes). Please understand feature weights before changing this order.

Returns:

the weight

sockets

public Set<String> sockets()

Sockets to trace.

If empty, all sockets will be traced. The default socket without any tag, additional sockets with a tag with the socket name.

Returns:

the sockets

config

public Optional<Config> config()

If this instance was configured, this would be the config instance used.

Overrides:

config in class ObserverConfigBase.BuilderBase<BUILDER extends TracingObserverConfig.BuilderBase<BUILDER,PROTOTYPE>,PROTOTYPE extends TracingObserverConfig>

Returns:

config node used to configure this builder, or empty if not configured

toString

public String toString()

Overrides:

toString in class ObserverConfigBase.BuilderBase<BUILDER extends TracingObserverConfig.BuilderBase<BUILDER,PROTOTYPE>,PROTOTYPE extends TracingObserverConfig>

preBuildPrototype

protected void preBuildPrototype()

Handles providers and decorators.

Overrides:

preBuildPrototype in class ObserverConfigBase.BuilderBase<BUILDER extends TracingObserverConfig.BuilderBase<BUILDER,PROTOTYPE>,PROTOTYPE extends TracingObserverConfig>

validatePrototype

protected void validatePrototype()

Validates required properties.

Overrides:

validatePrototype in class ObserverConfigBase.BuilderBase<BUILDER extends TracingObserverConfig.BuilderBase<BUILDER,PROTOTYPE>,PROTOTYPE extends TracingObserverConfig>