Package io.opentelemetry.instrumentation.api.instrumenter

Class InstrumenterBuilder<REQUEST,RESPONSE>

java.lang.Object

io.opentelemetry.instrumentation.api.instrumenter.InstrumenterBuilder<REQUEST,RESPONSE>

public final class InstrumenterBuilder<REQUEST,RESPONSE>
extends Object

A builder of Instrumenter. Instrumentation libraries should generally expose their own builder with controls that are appropriate for that library and delegate to this to create the Instrumenter.

Method Summary

Modifier and Type	Method	Description
InstrumenterBuilder<REQUEST,RESPONSE>	addAttributesExtractor(AttributesExtractor<? super REQUEST,? super RESPONSE> attributesExtractor)	Adds a AttributesExtractor to extract attributes from requests and responses.
InstrumenterBuilder<REQUEST,RESPONSE>	addAttributesExtractors(AttributesExtractor<? super REQUEST,? super RESPONSE>... attributesExtractors)	Adds AttributesExtractors to extract attributes from requests and responses.
InstrumenterBuilder<REQUEST,RESPONSE>	addAttributesExtractors(Iterable<? extends AttributesExtractor<? super REQUEST,? super RESPONSE>> attributesExtractors)	Adds AttributesExtractors to extract attributes from requests and responses.
InstrumenterBuilder<REQUEST,RESPONSE>	addRequestMetrics(RequestMetrics factory)	Adds a RequestMetrics whose metrics will be recorded for request start and stop.
InstrumenterBuilder<REQUEST,RESPONSE>	addSpanLinkExtractor(SpanLinkExtractor<REQUEST> spanLinkExtractor)	Adds a SpanLinkExtractor to extract span link from requests.
Instrumenter<REQUEST,RESPONSE>	newClientInstrumenter(io.opentelemetry.context.propagation.TextMapSetter<REQUEST> setter)	Returns a new Instrumenter which will create client spans and inject context into requests.
Instrumenter<REQUEST,RESPONSE>	newConsumerInstrumenter(io.opentelemetry.context.propagation.TextMapGetter<REQUEST> getter)	Returns a new Instrumenter which will create consumer spans and extract context from requests.
Instrumenter<REQUEST,RESPONSE>	newInstrumenter()	Returns a new Instrumenter which will create internal spans and do no context propagation.
Instrumenter<REQUEST,RESPONSE>	newInstrumenter(SpanKindExtractor<? super REQUEST> spanKindExtractor)	Returns a new Instrumenter which will create spans with kind determined by the passed spanKindExtractor and do no context propagation.
Instrumenter<REQUEST,RESPONSE>	newProducerInstrumenter(io.opentelemetry.context.propagation.TextMapSetter<REQUEST> setter)	Returns a new Instrumenter which will create producer spans and inject context into requests.
Instrumenter<REQUEST,RESPONSE>	newServerInstrumenter(io.opentelemetry.context.propagation.TextMapGetter<REQUEST> getter)	Returns a new Instrumenter which will create server spans and extract context from requests.
Instrumenter<REQUEST,RESPONSE>	newUpstreamPropagatingInstrumenter(SpanKindExtractor<REQUEST> spanKindExtractor, io.opentelemetry.context.propagation.TextMapGetter<REQUEST> getter)	Returns a new Instrumenter which will create spans with kind determined by the passed spanKindExtractor and extract context from requests.
InstrumenterBuilder<REQUEST,RESPONSE>	setErrorCauseExtractor(ErrorCauseExtractor errorCauseExtractor)	Sets the ErrorCauseExtractor to extract the root cause from an exception handling the request.
InstrumenterBuilder<REQUEST,RESPONSE>	setSpanStatusExtractor(SpanStatusExtractor<? super REQUEST,? super RESPONSE> spanStatusExtractor)	Sets the SpanStatusExtractor to use to determine the StatusCode for a response.
InstrumenterBuilder<REQUEST,RESPONSE>	setTimeExtractors(StartTimeExtractor<REQUEST> startTimeExtractor, EndTimeExtractor<RESPONSE> endTimeExtractor)	Sets the StartTimeExtractor and the EndTimeExtractor to extract the timestamp marking the start and end of processing.

Methods inherited from class java.lang.Object

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

Method Detail

setSpanStatusExtractor

public InstrumenterBuilder<REQUEST,RESPONSE> setSpanStatusExtractor(SpanStatusExtractor<? super REQUEST,? super RESPONSE> spanStatusExtractor)

Sets the SpanStatusExtractor to use to determine the StatusCode for a response.

addAttributesExtractor

public InstrumenterBuilder<REQUEST,RESPONSE> addAttributesExtractor(AttributesExtractor<? super REQUEST,? super RESPONSE> attributesExtractor)

Adds a AttributesExtractor to extract attributes from requests and responses.

addAttributesExtractors

public InstrumenterBuilder<REQUEST,RESPONSE> addAttributesExtractors(Iterable<? extends AttributesExtractor<? super REQUEST,? super RESPONSE>> attributesExtractors)

Adds AttributesExtractors to extract attributes from requests and responses.

addAttributesExtractors

public InstrumenterBuilder<REQUEST,RESPONSE> addAttributesExtractors(AttributesExtractor<? super REQUEST,? super RESPONSE>... attributesExtractors)

Adds AttributesExtractors to extract attributes from requests and responses.

addSpanLinkExtractor

public InstrumenterBuilder<REQUEST,RESPONSE> addSpanLinkExtractor(SpanLinkExtractor<REQUEST> spanLinkExtractor)

Adds a SpanLinkExtractor to extract span link from requests.

addRequestMetrics

@UnstableApi
public InstrumenterBuilder<REQUEST,RESPONSE> addRequestMetrics(RequestMetrics factory)

Adds a RequestMetrics whose metrics will be recorded for request start and stop.

setErrorCauseExtractor

public InstrumenterBuilder<REQUEST,RESPONSE> setErrorCauseExtractor(ErrorCauseExtractor errorCauseExtractor)

Sets the ErrorCauseExtractor to extract the root cause from an exception handling the request.

setTimeExtractors

public InstrumenterBuilder<REQUEST,RESPONSE> setTimeExtractors(StartTimeExtractor<REQUEST> startTimeExtractor,
                                                                     EndTimeExtractor<RESPONSE> endTimeExtractor)

Sets the StartTimeExtractor and the EndTimeExtractor to extract the timestamp marking the start and end of processing. If unset, the constructed instrumenter will defer determining start and end timestamps to the OpenTelemetry SDK.

newClientInstrumenter

public Instrumenter<REQUEST,RESPONSE> newClientInstrumenter(io.opentelemetry.context.propagation.TextMapSetter<REQUEST> setter)

Returns a new Instrumenter which will create client spans and inject context into requests.

newServerInstrumenter

public Instrumenter<REQUEST,RESPONSE> newServerInstrumenter(io.opentelemetry.context.propagation.TextMapGetter<REQUEST> getter)

Returns a new Instrumenter which will create server spans and extract context from requests.

newProducerInstrumenter

public Instrumenter<REQUEST,RESPONSE> newProducerInstrumenter(io.opentelemetry.context.propagation.TextMapSetter<REQUEST> setter)

Returns a new Instrumenter which will create producer spans and inject context into requests.

newConsumerInstrumenter

public Instrumenter<REQUEST,RESPONSE> newConsumerInstrumenter(io.opentelemetry.context.propagation.TextMapGetter<REQUEST> getter)

Returns a new Instrumenter which will create consumer spans and extract context from requests.

newUpstreamPropagatingInstrumenter

public Instrumenter<REQUEST,RESPONSE> newUpstreamPropagatingInstrumenter(SpanKindExtractor<REQUEST> spanKindExtractor,
                                                                               io.opentelemetry.context.propagation.TextMapGetter<REQUEST> getter)

Returns a new Instrumenter which will create spans with kind determined by the passed spanKindExtractor and extract context from requests.

newInstrumenter

public Instrumenter<REQUEST,RESPONSE> newInstrumenter()

Returns a new Instrumenter which will create internal spans and do no context propagation.

newInstrumenter

public Instrumenter<REQUEST,RESPONSE> newInstrumenter(SpanKindExtractor<? super REQUEST> spanKindExtractor)

Returns a new Instrumenter which will create spans with kind determined by the passed spanKindExtractor and do no context propagation.