com.linecorp.armeria.common.logging

Interface RequestOnlyLog

All Superinterfaces:

RequestLogAccess

All Known Subinterfaces:

RequestLog

public interface RequestOnlyLog
extends RequestLogAccess

A set of informational properties for request-side only, collected while consuming a Request.

See Also:

RequestLogAccess.isRequestComplete(), RequestLogAccess.whenRequestComplete(), RequestLogAccess.ensureRequestComplete()

Method Summary

Modifier and Type	Method and Description
io.netty.channel.Channel	channel() Returns the Netty Channel which handled the Request.
ClientConnectionTimings	connectionTimings() Returns the ClientConnectionTimings of the Request.
String	name() Returns the human-readable simple name of the Request, such as RPC method name or annotated service method name.
Object	rawRequestContent() Returns the low-level content object of the Request, which is specific to the SerializationFormat.
Throwable	requestCause() Returns the cause of request processing failure.
Object	requestContent() Returns the high-level content object of the Request, which is specific to the SerializationFormat.
String	requestContentPreview() Returns the preview of request content of the Request.
default long	requestDurationNanos() Returns the duration that was taken to consume or produce the request completely, in nanoseconds.
long	requestEndTimeNanos() Returns the time when the processing of the request finished, in nanoseconds.
Long	requestFirstBytesTransferredTimeNanos() Returns the time when the first bytes of the request headers were transferred over the wire.
RequestHeaders	requestHeaders() Returns the RequestHeaders.
long	requestLength() Returns the length of the request content.
long	requestStartTimeMicros() Returns the time when the processing of the request started, in microseconds since the epoch.
long	requestStartTimeMillis() Returns the time when the processing of the request started, in milliseconds since the epoch.
long	requestStartTimeNanos() Returns the time when the processing of the request started, in nanoseconds.
HttpHeaders	requestTrailers() Returns the HTTP trailers of the Request.
Scheme	scheme() Returns the Scheme of the Request.
SessionProtocol	sessionProtocol() Returns the SessionProtocol of the Request.
SSLSession	sslSession() Returns the SSLSession of the connection which handled the Request.
default String	toStringRequestOnly() Returns the string representation of the Request, with no sanitization of headers or content.
default String	toStringRequestOnly(Function<? super HttpHeaders,?> headersSanitizer, Function<Object,?> contentSanitizer) Returns the string representation of the Request.
String	toStringRequestOnly(Function<? super RequestHeaders,?> headersSanitizer, Function<Object,?> contentSanitizer, Function<? super HttpHeaders,?> trailersSanitizer) Returns the string representation of the Request.

Methods inherited from interface com.linecorp.armeria.common.logging.RequestLogAccess

availabilityStamp, children, context, ensureAvailable, ensureAvailable, ensureAvailable, ensureComplete, ensureRequestComplete, isAvailable, isAvailable, isAvailable, isComplete, isRequestComplete, partial, whenAvailable, whenAvailable, whenAvailable, whenComplete, whenRequestComplete

Method Detail

requestStartTimeMicros

long requestStartTimeMicros()

Returns the time when the processing of the request started, in microseconds since the epoch.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_START_TIME

requestStartTimeMillis

long requestStartTimeMillis()

Returns the time when the processing of the request started, in milliseconds since the epoch.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_START_TIME

requestStartTimeNanos

long requestStartTimeNanos()

Returns the time when the processing of the request started, in nanoseconds. This value can only be used to measure elapsed time and is not related to any other notion of system or wall-clock time.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_START_TIME

requestFirstBytesTransferredTimeNanos

Long requestFirstBytesTransferredTimeNanos()

Returns the time when the first bytes of the request headers were transferred over the wire. For a client, this is the time the client sent the data, while for a server it is the time the server received them. This value can only be used to measure elapsed time and is not related to any other notion of system or wall-clock time.

Returns:

the transfer time, or null if nothing was transferred.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_FIRST_BYTES_TRANSFERRED_TIME

requestEndTimeNanos

long requestEndTimeNanos()

Returns the time when the processing of the request finished, in nanoseconds. This value can only be used to measure elapsed time and is not related to any other notion of system or wall-clock time.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_END_TIME

requestDurationNanos

default long requestDurationNanos()

Returns the duration that was taken to consume or produce the request completely, in nanoseconds.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_END_TIME

requestLength

long requestLength()

Returns the length of the request content.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_LENGTH

requestCause

Throwable requestCause()

Returns the cause of request processing failure.

Returns:

the cause, or null if the request was processed completely.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_CAUSE

channel

io.netty.channel.Channel channel()

Returns the Netty Channel which handled the Request.

Returns:

the Netty Channel, or null if the Request has failed even before a connection is established.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.SESSION

sslSession

SSLSession sslSession()

Returns the SSLSession of the connection which handled the Request.

Returns:

the SSLSession, or null if the Request has failed even before a TLS connection is established or the connection does not use TLS.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.SESSION

sessionProtocol

SessionProtocol sessionProtocol()

Returns the SessionProtocol of the Request.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.SESSION

connectionTimings

ClientConnectionTimings connectionTimings()

Returns the ClientConnectionTimings of the Request.

Returns:

the ClientConnectionTimings if the Request involved a new connection attempt, or null otherwise.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.SESSION

scheme

Scheme scheme()

Returns the Scheme of the Request.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.SCHEME

name

String name()

Returns the human-readable simple name of the Request, such as RPC method name or annotated service method name. This property is often used as a meter tag or distributed trace's span name.

requestHeaders

RequestHeaders requestHeaders()

Returns the RequestHeaders. If the Request was not received or sent at all, it will return a dummy RequestHeaders whose :authority and :path are set to "?", :scheme is set to "http" or "https", and :method is set to "UNKNOWN".

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_HEADERS

requestContent

Object requestContent()

Returns the high-level content object of the Request, which is specific to the SerializationFormat.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_CONTENT

rawRequestContent

Object rawRequestContent()

Returns the low-level content object of the Request, which is specific to the SerializationFormat.

Returns:

ThriftCall for Thrift, or null for others

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_CONTENT

requestContentPreview

String requestContentPreview()

Returns the preview of request content of the Request. Note that a Service or a Client must be decorated with ContentPreviewingService or ContentPreviewingClient decorators respectively to enable the content preview.

Returns:

the preview, or null if the preview is disabled.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_CONTENT_PREVIEW

requestTrailers

HttpHeaders requestTrailers()

Returns the HTTP trailers of the Request.

Throws:

RequestLogAvailabilityException - if the property is not available yet.

See Also:

RequestLogProperty.REQUEST_TRAILERS

toStringRequestOnly

default String toStringRequestOnly()

Returns the string representation of the Request, with no sanitization of headers or content.

toStringRequestOnly

default String toStringRequestOnly(Function<? super HttpHeaders,?> headersSanitizer,
                                   Function<Object,?> contentSanitizer)

Returns the string representation of the Request. This method is a shortcut for:

 toStringRequestOnly(headersSanitizer, contentSanitizer, headersSanitizer);
 

Parameters:

headersSanitizer - a Function for sanitizing HTTP headers for logging. The result of the Function is what is actually logged as headers.

contentSanitizer - a Function for sanitizing request content for logging. The result of the Function is what is actually logged as content.

toStringRequestOnly

String toStringRequestOnly(Function<? super RequestHeaders,?> headersSanitizer,
                           Function<Object,?> contentSanitizer,
                           Function<? super HttpHeaders,?> trailersSanitizer)

Returns the string representation of the Request.

Parameters:

headersSanitizer - a Function for sanitizing HTTP headers for logging. The result of the Function is what is actually logged as headers.

contentSanitizer - a Function for sanitizing request content for logging. The result of the Function is what is actually logged as content.

trailersSanitizer - a Function for sanitizing HTTP trailers for logging. The result of the Function is what is actually logged as trailers.