Package io.opentelemetry.instrumentation.api.instrumenter.network

Interface ServerAttributesGetter<REQUEST,RESPONSE>

All Known Subinterfaces:

HttpClientAttributesGetter<REQUEST,RESPONSE>, HttpServerAttributesGetter<REQUEST,RESPONSE>, NetClientAttributesGetter<REQUEST,RESPONSE>, NetServerAttributesGetter<REQUEST,RESPONSE>

public interface ServerAttributesGetter<REQUEST,RESPONSE>

An interface for getting attributes describing a network server.

Instrumentation authors will create implementations of this interface for their specific library/framework. It will be used by the ServerAttributesExtractor (or other convention specific extractors) to obtain the various server attributes in a type-generic way.

Method Summary

Modifier and Type	Method	Description
default String	getServerAddress(REQUEST request)	Return the logical server hostname that matches server FQDN if available, and IP or socket address if FQDN is not known.
default InetSocketAddress	getServerInetSocketAddress(REQUEST request, RESPONSE response)	Returns an InetSocketAddress object representing the server socket address.
default Integer	getServerPort(REQUEST request)	Return the logical server port number.
default String	getServerSocketAddress(REQUEST request, RESPONSE response)	Return the physical server IP address or Unix socket address.
default String	getServerSocketDomain(REQUEST request, RESPONSE response)	Return the domain name of an immediate peer.
default Integer	getServerSocketPort(REQUEST request, RESPONSE response)	Return the physical server port.

Method Details

getServerAddress

@Nullable
default String getServerAddress(REQUEST request)

Return the logical server hostname that matches server FQDN if available, and IP or socket address if FQDN is not known.

Examples: example.com

getServerPort

@Nullable
default Integer getServerPort(REQUEST request)

Return the logical server port number.

Examples: 80, 8080, 443

getServerInetSocketAddress

@Nullable
default InetSocketAddress getServerInetSocketAddress(REQUEST request,
 @Nullable
 RESPONSE response)

Returns an InetSocketAddress object representing the server socket address.

Implementing this method is equivalent to implementing all of getServerSocketDomain(Object, Object), getServerSocketAddress(Object, Object) and getServerSocketPort(Object, Object).

getServerSocketDomain

@Nullable
default String getServerSocketDomain(REQUEST request,
 @Nullable
 RESPONSE response)

Return the domain name of an immediate peer.

Examples: proxy.example.com

By default, this method attempts to retrieve the server domain name using the getServerInetSocketAddress(Object, Object) method. If this method is not implemented, it will simply return null. If the instrumented library does not expose InetSocketAddress in its API, you might want to implement this method instead of getServerInetSocketAddress(Object, Object).

getServerSocketAddress

@Nullable
default String getServerSocketAddress(REQUEST request,
 @Nullable
 RESPONSE response)

Return the physical server IP address or Unix socket address.

Examples: 10.5.3.2

By default, this method attempts to retrieve the server address using the getServerInetSocketAddress(Object, Object) method. If this method is not implemented, it will simply return null. If the instrumented library does not expose InetSocketAddress in its API, you might want to implement this method instead of getServerInetSocketAddress(Object, Object).

getServerSocketPort

@Nullable
default Integer getServerSocketPort(REQUEST request,
 @Nullable
 RESPONSE response)

Return the physical server port.

Examples: 16456

By default, this method attempts to retrieve the server port using the getServerInetSocketAddress(Object, Object) method. If this method is not implemented, it will simply return null. If the instrumented library does not expose InetSocketAddress in its API, you might want to implement this method instead of getServerInetSocketAddress(Object, Object).