ClientConnectionTimings (filter-service-metrics 1.12 1.12 API)

java.lang.Object
- com.linecorp.armeria.client.ClientConnectionTimings

```
public final class ClientConnectionTimings
extends Object
```
A holder class which has the timing information about a connection attempt before a client sends a Request.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static ClientConnectionTimingsBuilder`	`builder()` Returns a newly created `ClientConnectionTimingsBuilder`.
`long`	`connectionAcquisitionDurationNanos()` Returns the duration which was taken to get a connection, in nanoseconds.
`long`	`connectionAcquisitionStartTimeMicros()` Returns the time when the client started to acquire a connection, in microseconds since the epoch.
`long`	`connectionAcquisitionStartTimeMillis()` Returns the time when the client started to acquire a connection, in milliseconds since the epoch.
`long`	`dnsResolutionDurationNanos()` Returns the duration which was taken to resolve a domain name, in nanoseconds.
`long`	`dnsResolutionStartTimeMicros()` Returns the time when the client started to resolve a domain name, in microseconds since the epoch.
`long`	`dnsResolutionStartTimeMillis()` Returns the time when the client started to resolve a domain name, in milliseconds since the epoch.
`static ClientConnectionTimings`	`get(RequestContext ctx)` Returns `ClientConnectionTimings` from the specified `RequestContext` if exists.
`static ClientConnectionTimings`	`get(RequestLog log)` Returns `ClientConnectionTimings` from the specified `RequestLog` if exists.
`long`	`pendingAcquisitionDurationNanos()` Returns the duration which was taken to wait for the completion of an existing connection attempt in order to use one connection for HTTP/2.
`long`	`pendingAcquisitionStartTimeMicros()` Returns the time when the client started to wait for the completion of an existing connection attempt, in microseconds since the epoch.
`long`	`pendingAcquisitionStartTimeMillis()` Returns the time when the client started to wait for the completion of an existing connection attempt, in milliseconds since the epoch.
`void`	`setTo(RequestContext ctx)` Sets this `ClientConnectionTimings` to the specified `RequestContext`.
`void`	`setTo(RequestLog log)` Sets this `ClientConnectionTimings` to the specified `RequestLog`.
`long`	`socketConnectDurationNanos()` Returns the duration which was taken to connect to a remote peer, in nanoseconds.
`long`	`socketConnectStartTimeMicros()` Returns the time when the client started to connect to a remote peer, in microseconds since the epoch.
`long`	`socketConnectStartTimeMillis()` Returns the time when the client started to connect to a remote peer, in milliseconds since the epoch.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Method Detail
  - get
```
@Nullable
public static ClientConnectionTimings get(RequestContext ctx)
```
    Returns ClientConnectionTimings from the specified RequestContext if exists.
    
    See Also:
    
    setTo(RequestContext)
  - get
```
@Nullable
public static ClientConnectionTimings get(RequestLog log)
```
    Returns ClientConnectionTimings from the specified RequestLog if exists.
    
    See Also:
    
    setTo(RequestLog)
  - builder
```
public static ClientConnectionTimingsBuilder builder()
```
    Returns a newly created ClientConnectionTimingsBuilder.
  - setTo
```
public void setTo(RequestContext ctx)
```
    Sets this ClientConnectionTimings to the specified RequestContext. Note that this method is intended for internal use. Do not use unless you really need to.
    
    See Also:
    
    get(RequestContext)
  - setTo
```
public void setTo(RequestLog log)
```
    Sets this ClientConnectionTimings to the specified RequestLog. Note that this method is intended for internal use. Do not use unless you really need to.
    
    See Also:
    
    get(RequestLog)
  - connectionAcquisitionStartTimeMicros
```
public long connectionAcquisitionStartTimeMicros()
```
    Returns the time when the client started to acquire a connection, in microseconds since the epoch.
  - connectionAcquisitionStartTimeMillis
```
public long connectionAcquisitionStartTimeMillis()
```
    Returns the time when the client started to acquire a connection, in milliseconds since the epoch.
  - connectionAcquisitionDurationNanos
```
public long connectionAcquisitionDurationNanos()
```
    Returns the duration which was taken to get a connection, in nanoseconds. This value is greater than or equal to the sum of dnsResolutionDurationNanos(), socketConnectDurationNanos() and pendingAcquisitionDurationNanos().
  - dnsResolutionStartTimeMicros
```
public long dnsResolutionStartTimeMicros()
```
    Returns the time when the client started to resolve a domain name, in microseconds since the epoch.
    
    Returns:
    
    the start time, or -1 if there was no action to resolve a domain name.
  - dnsResolutionStartTimeMillis
```
public long dnsResolutionStartTimeMillis()
```
    Returns the time when the client started to resolve a domain name, in milliseconds since the epoch.
    
    Returns:
    
    the start time, or -1 if there was no action to resolve a domain name.
  - dnsResolutionDurationNanos
```
public long dnsResolutionDurationNanos()
```
    Returns the duration which was taken to resolve a domain name, in nanoseconds.
    
    Returns:
    
    the duration, or -1 if there was no action to resolve a domain name.
  - socketConnectStartTimeMicros
```
public long socketConnectStartTimeMicros()
```
    Returns the time when the client started to connect to a remote peer, in microseconds since the epoch.
    
    Returns:
    
    the start time, or -1 if there was no action to connect to a remote peer.
  - socketConnectStartTimeMillis
```
public long socketConnectStartTimeMillis()
```
    Returns the time when the client started to connect to a remote peer, in milliseconds since the epoch.
    
    Returns:
    
    the start time, or -1 if there was no action to connect to a remote peer.
  - socketConnectDurationNanos
```
public long socketConnectDurationNanos()
```
    Returns the duration which was taken to connect to a remote peer, in nanoseconds.
    
    Returns:
    
    the duration, or -1 if there was no action to connect to a remote peer.
  - pendingAcquisitionStartTimeMicros
```
public long pendingAcquisitionStartTimeMicros()
```
    Returns the time when the client started to wait for the completion of an existing connection attempt, in microseconds since the epoch.
    
    Returns:
    
    the start time, or -1 if there was no action to get a pending connection.
  - pendingAcquisitionStartTimeMillis
```
public long pendingAcquisitionStartTimeMillis()
```
    Returns the time when the client started to wait for the completion of an existing connection attempt, in milliseconds since the epoch.
    
    Returns:
    
    the start time, or -1 if there was no action to get a pending connection.
  - pendingAcquisitionDurationNanos
```
public long pendingAcquisitionDurationNanos()
```
    Returns the duration which was taken to wait for the completion of an existing connection attempt in order to use one connection for HTTP/2.
    
    Returns:
    
    the duration, or -1 if there was no action to get a pending connection.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class ClientConnectionTimings

Method Summary

Methods inherited from class java.lang.Object

Method Detail

get

get

builder

setTo

setTo

connectionAcquisitionStartTimeMicros

connectionAcquisitionStartTimeMillis

connectionAcquisitionDurationNanos

dnsResolutionStartTimeMicros

dnsResolutionStartTimeMillis

dnsResolutionDurationNanos

socketConnectStartTimeMicros

socketConnectStartTimeMillis

socketConnectDurationNanos

pendingAcquisitionStartTimeMicros

pendingAcquisitionStartTimeMillis

pendingAcquisitionDurationNanos

toString