Package io.opentelemetry.instrumentation.api.instrumenter.http

Class HttpClientAttributesExtractor<REQUEST,RESPONSE>

java.lang.Object

io.opentelemetry.instrumentation.api.instrumenter.http.HttpClientAttributesExtractor<REQUEST,RESPONSE>

All Implemented Interfaces:

AttributesExtractor<REQUEST,RESPONSE>

public final class HttpClientAttributesExtractor<REQUEST,RESPONSE>
extends Object

Extractor of HTTP client attributes. Instrumentation of HTTP client frameworks should extend this class, defining HttpClientAttributesExtractor and HttpClientAttributesExtractor with the actual request / response types of the instrumented library. If an attribute is not available in this library, it is appropriate to return null from the protected attribute methods, but implement as many as possible for best compliance with the OpenTelemetry specification.

Method Summary

Modifier and Type	Method	Description
static <REQUEST,RESPONSE> HttpClientAttributesExtractorBuilder<REQUEST,RESPONSE>	builder(HttpClientAttributesGetter<REQUEST,RESPONSE> getter)	Returns a new HttpClientAttributesExtractorBuilder that can be used to configure the HTTP client attributes extractor.
static <REQUEST,RESPONSE> HttpClientAttributesExtractor<REQUEST,RESPONSE>	create(HttpClientAttributesGetter<REQUEST,RESPONSE> getter)	Creates the HTTP client attributes extractor with default configuration.
static <REQUEST,RESPONSE> HttpClientAttributesExtractor<REQUEST,RESPONSE>	create(HttpClientAttributesGetter<REQUEST,RESPONSE> getter, CapturedHttpHeaders capturedHttpHeaders)	Deprecated. Use builder(HttpClientAttributesGetter) instead.
void	onEnd(io.opentelemetry.api.common.AttributesBuilder attributes, io.opentelemetry.context.Context context, REQUEST request, RESPONSE response, Throwable error)	Extracts attributes from the Context, the AttributesExtractor and either AttributesExtractor or error into the AttributesBuilder at the end of a request.
void	onStart(io.opentelemetry.api.common.AttributesBuilder attributes, io.opentelemetry.context.Context parentContext, REQUEST request)	Extracts attributes from the Context and the AttributesExtractor into the AttributesBuilder at the beginning of a request.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.opentelemetry.instrumentation.api.instrumenter.AttributesExtractor

onEnd, onStart, set

Method Detail

create

public static <REQUEST,RESPONSE> HttpClientAttributesExtractor<REQUEST,RESPONSE> create(HttpClientAttributesGetter<REQUEST,RESPONSE> getter)

Creates the HTTP client attributes extractor with default configuration.

create

@Deprecated
public static <REQUEST,RESPONSE> HttpClientAttributesExtractor<REQUEST,RESPONSE> create(HttpClientAttributesGetter<REQUEST,RESPONSE> getter,
                                                                                                    CapturedHttpHeaders capturedHttpHeaders)

Deprecated.

Use builder(HttpClientAttributesGetter) instead.

Creates the HTTP client attributes extractor.

Parameters:

capturedHttpHeaders - A configuration object specifying which HTTP request and response headers should be captured as span attributes.

builder

public static <REQUEST,RESPONSE> HttpClientAttributesExtractorBuilder<REQUEST,RESPONSE> builder(HttpClientAttributesGetter<REQUEST,RESPONSE> getter)

Returns a new HttpClientAttributesExtractorBuilder that can be used to configure the HTTP client attributes extractor.

onStart

public void onStart(io.opentelemetry.api.common.AttributesBuilder attributes,
                    io.opentelemetry.context.Context parentContext,
                    REQUEST request)

Description copied from interface: AttributesExtractor

Extracts attributes from the Context and the AttributesExtractor into the AttributesBuilder at the beginning of a request.

Specified by:

onStart in interface AttributesExtractor<REQUEST,RESPONSE>

onEnd

public void onEnd(io.opentelemetry.api.common.AttributesBuilder attributes,
                  io.opentelemetry.context.Context context,
                  REQUEST request,
                  @Nullable
                  RESPONSE response,
                  @Nullable
                  Throwable error)

Description copied from interface: AttributesExtractor

Extracts attributes from the Context, the AttributesExtractor and either AttributesExtractor or error into the AttributesBuilder at the end of a request.

Specified by:

onEnd in interface AttributesExtractor<REQUEST,RESPONSE>