Package io.opentelemetry.instrumentation.api.tracer

Class HttpServerTracer<REQUEST,RESPONSE,CONNECTION,STORAGE>

java.lang.Object

io.opentelemetry.instrumentation.api.tracer.BaseTracer

io.opentelemetry.instrumentation.api.tracer.HttpServerTracer<REQUEST,RESPONSE,CONNECTION,STORAGE>

Type Parameters:

REQUEST - - The specific type for HTTP requests

RESPONSE - - The specific type for HTTP responses

CONNECTION - - The specific type of HTTP connection, used to get peer address information and HTTP flavor.

STORAGE - - Implementation specific storage type for attaching/getting the server context. Use Void if your subclass does not have an implementation specific storage need.

@Deprecated
public abstract class HttpServerTracer<REQUEST,RESPONSE,CONNECTION,STORAGE>
extends BaseTracer

Deprecated.

Use Instrumenter and the HTTP semantic convention utilities package instead.

Base class for implementing Tracers for HTTP servers. It has 3 types that must be specified by subclasses:

Field Summary

Fields

Modifier and Type	Field	Description
static String	CONTEXT_ATTRIBUTE	Deprecated.
protected static String	USER_AGENT	Deprecated.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	HttpServerTracer()	Deprecated.
protected	HttpServerTracer(io.opentelemetry.api.OpenTelemetry openTelemetry)	Deprecated.

Method Summary

Modifier and Type	Method	Description
protected abstract void	attachServerContext(io.opentelemetry.context.Context context, STORAGE storage)	Deprecated. Stores given context in the given request-response-loop storage in implementation specific way.
protected io.opentelemetry.context.Context	customizeContext(io.opentelemetry.context.Context context, REQUEST request)	Deprecated. Override in subclass to customize context that is returned by startSpan.
void	end(io.opentelemetry.context.Context context, RESPONSE response)	Deprecated. Convenience method.
void	end(io.opentelemetry.context.Context context, RESPONSE response, long timestamp)	Deprecated.
void	endExceptionally(io.opentelemetry.context.Context context, Throwable throwable)	Deprecated. Convenience method.
void	endExceptionally(io.opentelemetry.context.Context context, Throwable throwable, RESPONSE response)	Deprecated. Convenience method.
void	endExceptionally(io.opentelemetry.context.Context context, Throwable throwable, RESPONSE response, long timestamp)	Deprecated. If response is null, the http.status_code will be set to 500 and the Span status will be set to StatusCode.ERROR.
protected abstract String	flavor(CONNECTION connection, REQUEST request)	Deprecated.
protected abstract io.opentelemetry.context.propagation.TextMapGetter<REQUEST>	getGetter()	Deprecated.
abstract io.opentelemetry.context.Context	getServerContext(STORAGE storage)	Deprecated. Returns context stored to the given request-response-loop storage by attachServerContext(Context, Object).
io.opentelemetry.api.trace.Span	getServerSpan(STORAGE storage)	Deprecated.
protected abstract String	host(REQUEST request)	Deprecated.
protected boolean	isRelativeUrl(String url)	Deprecated.
protected abstract String	method(REQUEST request)	Deprecated.
protected void	onConnection(io.opentelemetry.api.trace.SpanBuilder spanBuilder, CONNECTION connection)	Deprecated.
protected void	onConnectionAndRequest(io.opentelemetry.api.trace.SpanBuilder spanBuilder, CONNECTION connection, REQUEST request)	Deprecated.
protected void	onRequest(io.opentelemetry.api.trace.SpanBuilder spanBuilder, REQUEST request)	Deprecated.
protected abstract String	peerHostIp(CONNECTION connection)	Deprecated.
protected abstract Integer	peerPort(CONNECTION connection)	Deprecated.
protected abstract String	requestHeader(REQUEST request, String name)	Deprecated.
protected abstract int	responseStatus(RESPONSE response)	Deprecated.
protected abstract String	scheme(REQUEST request)	Deprecated.
io.opentelemetry.context.Context	startSpan(REQUEST request, CONNECTION connection, STORAGE storage, Method origin)	Deprecated.
io.opentelemetry.context.Context	startSpan(REQUEST request, CONNECTION connection, STORAGE storage, String spanName)	Deprecated.
io.opentelemetry.context.Context	startSpan(REQUEST request, CONNECTION connection, STORAGE storage, String spanName, long startTimestamp)	Deprecated.
protected abstract String	target(REQUEST request)	Deprecated.
protected String	url(REQUEST request)	Deprecated.

Methods inherited from class io.opentelemetry.instrumentation.api.tracer.BaseTracer

end, end, endExceptionally, extract, getInstrumentationName, getVersion, inject, onException, shouldStartSpan, spanBuilder, startSpan, startSpan, startSpan, unwrapThrowable, withClientSpan, withConsumerSpan, withServerSpan

Methods inherited from class java.lang.Object

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

Field Detail

CONTEXT_ATTRIBUTE

public static final String CONTEXT_ATTRIBUTE

Deprecated.

USER_AGENT

protected static final String USER_AGENT

Deprecated.

See Also:

Constant Field Values

Constructor Detail

HttpServerTracer

protected HttpServerTracer()

Deprecated.

HttpServerTracer

protected HttpServerTracer(io.opentelemetry.api.OpenTelemetry openTelemetry)

Deprecated.

Method Detail

startSpan

public io.opentelemetry.context.Context startSpan(REQUEST request,
                                                  CONNECTION connection,
                                                  STORAGE storage,
                                                  Method origin)

Deprecated.

startSpan

public io.opentelemetry.context.Context startSpan(REQUEST request,
                                                  CONNECTION connection,
                                                  STORAGE storage,
                                                  String spanName)

Deprecated.

startSpan

public io.opentelemetry.context.Context startSpan(REQUEST request,
                                                  CONNECTION connection,
                                                  @Nullable
                                                  STORAGE storage,
                                                  String spanName,
                                                  long startTimestamp)

Deprecated.

customizeContext

protected io.opentelemetry.context.Context customizeContext(io.opentelemetry.context.Context context,
                                                            REQUEST request)

Deprecated.

Override in subclass to customize context that is returned by startSpan.

end

public void end(io.opentelemetry.context.Context context,
                RESPONSE response)

Deprecated.

Convenience method. Delegates to end(Context, Object, long), passing timestamp value of -1.

end

public void end(io.opentelemetry.context.Context context,
                RESPONSE response,
                long timestamp)

Deprecated.

endExceptionally

public void endExceptionally(io.opentelemetry.context.Context context,
                             Throwable throwable)

Deprecated.

Convenience method. Delegates to endExceptionally(Context, Throwable, Object), passing response value of null.

Overrides:

endExceptionally in class BaseTracer

See Also:

BaseTracer.onException(Context, Throwable), BaseTracer.end(Context)

endExceptionally

public void endExceptionally(io.opentelemetry.context.Context context,
                             Throwable throwable,
                             RESPONSE response)

Deprecated.

Convenience method. Delegates to endExceptionally(Context, Throwable, Object, long), passing timestamp value of -1.

endExceptionally

public void endExceptionally(io.opentelemetry.context.Context context,
                             Throwable throwable,
                             RESPONSE response,
                             long timestamp)

Deprecated.

If response is null, the http.status_code will be set to 500 and the Span status will be set to StatusCode.ERROR.

getServerSpan

public io.opentelemetry.api.trace.Span getServerSpan(STORAGE storage)

Deprecated.

getServerContext

@Nullable
public abstract io.opentelemetry.context.Context getServerContext(STORAGE storage)

Deprecated.

Returns context stored to the given request-response-loop storage by attachServerContext(Context, Object).

onConnection

protected void onConnection(io.opentelemetry.api.trace.SpanBuilder spanBuilder,
                            CONNECTION connection)

Deprecated.

onRequest

protected void onRequest(io.opentelemetry.api.trace.SpanBuilder spanBuilder,
                         REQUEST request)

Deprecated.

onConnectionAndRequest

protected void onConnectionAndRequest(io.opentelemetry.api.trace.SpanBuilder spanBuilder,
                                      CONNECTION connection,
                                      REQUEST request)

Deprecated.

peerPort

@Nullable
protected abstract Integer peerPort(CONNECTION connection)

Deprecated.

peerHostIp

@Nullable
protected abstract String peerHostIp(CONNECTION connection)

Deprecated.

flavor

protected abstract String flavor(CONNECTION connection,
                                 REQUEST request)

Deprecated.

getGetter

protected abstract io.opentelemetry.context.propagation.TextMapGetter<REQUEST> getGetter()

Deprecated.

url

@Nullable
protected String url(REQUEST request)

Deprecated.

scheme

protected abstract String scheme(REQUEST request)

Deprecated.

host

protected abstract String host(REQUEST request)

Deprecated.

target

protected abstract String target(REQUEST request)

Deprecated.

method

protected abstract String method(REQUEST request)

Deprecated.

requestHeader

@Nullable
protected abstract String requestHeader(REQUEST request,
                                        String name)

Deprecated.

responseStatus

protected abstract int responseStatus(RESPONSE response)

Deprecated.

attachServerContext

protected abstract void attachServerContext(io.opentelemetry.context.Context context,
                                            STORAGE storage)

Deprecated.

Stores given context in the given request-response-loop storage in implementation specific way.

isRelativeUrl

protected boolean isRelativeUrl(String url)

Deprecated.