A report that provides metrics about how a connection was established.
SDKs
- iOS 13.0+
- macOS 10.15+
- Mac Catalyst 13.0+
- tvOS 13.0+
- watchOS 6.0+
- Xcode 11.0+
Framework
- Network
Declaration
struct NWConnection.EstablishmentReport
StructureNWConnection
NWConnection
Topics
Inspecting Connection Attempts
let duration: TimeThe total duration of the successful connection establishment attempt, from the preparing state to the ready state.
let previousThe number of attempts made before the successful attempt, when the connection moved from the preparing state back to the waiting state.
let attemptThe time between the call to start and the beginning of the successful connection attempt.
var debugThe description of the report.
Inspecting Resolution
let resolutions: [NWConnectionThe array of resolution steps performed during connection establishment, in order from first resolved to last resolved.
struct NWConnectionA description of a single DNS resolution step.
Inspecting Protocol Handshakes
let handshakes: [NWConnectionThe array of protocol handshakes in order from first completed to last completed.
struct NWConnectionA description of a single protocol handshake.
Checking for Proxies
let proxyA Boolean indicating whether a proxy was configured on the connection.
let usedA Boolean indicating whether the connection used a proxy.
let proxyThe endpoint of the proxy the connection used.
Relationships
Conforms To
See Also
Collecting Connection Metrics
Collecting Network Connection Metrics
Use reports to understand how DNS and protocol handshakes impact connection establishment.
func requestRequests a copy of the connection's establishment report once the connection is in the ready state.
func startBegins a new data transfer report, which can later be collected.
class NWConnectionAn outstanding data transfer report that has yet to be collected.
struct NWConnectionA report that provides metrics about data being sent and received on a connection.