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

Interface ClientAttributesGetter<REQUEST,RESPONSE>

All Known Subinterfaces:

HttpServerAttributesGetter<REQUEST,RESPONSE>, NetServerAttributesGetter<REQUEST,RESPONSE>

public interface ClientAttributesGetter<REQUEST,RESPONSE>

An interface for getting attributes describing a network client.

Instrumentation authors will create implementations of this interface for their specific library/framework. It will be used by the ClientAttributesExtractor (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	getClientAddress(REQUEST request)	Returns the client address - unix domain socket name, IPv4 or IPv6 address.
default InetSocketAddress	getClientInetSocketAddress(REQUEST request, RESPONSE response)	Returns an InetSocketAddress object representing the immediate client socket address.
default Integer	getClientPort(REQUEST request)	Returns the client port number.
default String	getClientSocketAddress(REQUEST request, RESPONSE response)	Returns the immediate client peer address - unix domain socket name, IPv4 or IPv6 address.
default Integer	getClientSocketPort(REQUEST request, RESPONSE response)	Returns the immediate client peer port number.

Method Details

getClientAddress

@Nullable
default String getClientAddress(REQUEST request)

Returns the client address - unix domain socket name, IPv4 or IPv6 address.

Examples: /tmp/my.sock, 10.1.2.80

getClientPort

@Nullable
default Integer getClientPort(REQUEST request)

Returns the client port number.

Examples: 65123

getClientInetSocketAddress

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

Returns an InetSocketAddress object representing the immediate client socket address.

Implementing this method is equivalent to implementing all of getClientSocketAddress(Object, Object) and getClientSocketPort(Object, Object).

getClientSocketAddress

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

Returns the immediate client peer address - unix domain socket name, IPv4 or IPv6 address.

Examples: /tmp/my.sock, 127.0.0.1

By default, this method attempts to retrieve the immediate client address using the getClientInetSocketAddress(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 getClientInetSocketAddress(Object, Object).

getClientSocketPort

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

Returns the immediate client peer port number.

Examples: 35555

By default, this method attempts to retrieve the immediate client port using the getClientInetSocketAddress(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 getClientInetSocketAddress(Object, Object).