Class

URLSessionTaskTransactionMetrics

An object that encapsualtes the performance metrics collected by the URL Loading System during the execution of a session task. あるセッションタスクの遂行の間にURLローディングシステムによって収集された履行指標をカプセル化するオブジェクト。

Declaration 宣言

class URLSessionTaskTransactionMetrics : NSObject

Overview 概要

Each URLSessionTaskTransactionMetrics object consists of a request and response property, corresponding to the request and response of the corresponding task. It also contains temporal metrics, starting with fetchStartDate and ending with responseEndDate, as well as other characteristics like networkProtocolName and resourceFetchType. 各URLSessionTaskTransactionMetricsオブジェクトは、対応しているタスクのリクエストと応答に対応しているrequestとresponseプロパティから成ります。それはまた、fetchStartDateで始まりresponseEndDateで終わる、時間的指標を含みます、それだけでなくnetworkProtocolNameとresourceFetchTypeのような他の特徴も。

Understanding Temporal Metrics 時間的指標を理解する

Figure 1 shows the sequence of events for a URL session task, which correspond to the temporal metrics captured by URLSessionTaskTransactionMetrics. 図 1 はあるURLセッションタスクに対する一連のイベントを示します、それらはURLSessionTaskTransactionMetricsによってキャプチャされた時間的指標に対応します。

Diagram showing the temporal metrics for a URL session task. When a task starts, it performs a DNS lookup and then starts a connection. If the connection is encrypted, the user agent starts a TLS security handshake to secure the connection. After the connection to the server is established, the user agent requests the specified resource, and receives a response. — **Figure 1** Timeline of temporal metrics for a URL session task **図 1** あるURLセッションタスクに対する時間的指標のタイムライン

For all metrics with a start and end date, if an aspect of the task was not completed, then its corresponding end date metric is nil. This can happen if name lookup begins, but the operation either times out, fails, or the client cancels the task before the name can be resolved. In this case, the domainLookupEndDate property is nil, along with all metrics for aspects that occurred afterwards. 開始および終了日付をもつ全ての指標に対して、タスクのある局面が完了しなかったならば、そのときそれの対応する終了日指標はnilです。これは、名前検索が始まる、しかし演算がタイムアウト、失敗どちらかをする、またはクライアントがタスクをその名前が解決される前に取り消すならばならば起こりえます。その場合には、domainLookupEndDateプロパティは、nilです、後で発生した局面それらに対する全ての指標と一緒に。

Measuring Tasks Using iCloud Private Relay

iCloud Private Relay can change the timing and sequence of events for your tasks by sending requests through a set of privacy proxies. All tasks that use iCloud Private Relay set the isProxyConnection property in their transaction metrics. In this case, the remoteAddress property contains the address of the proxy, and not the origin server.

Tasks to different hosts can reuse the same transport connection, just like how tasks can already share a connection when using HTTP/2. In these cases, a proxied task may not report any secureConnectionStartDate or secureConnectionEndDate.

Topics 話題

Accessing Request and Response リクエストと応答にアクセスする

var request: URLRequest

The transaction request. トランザクションリクエスト。

var response: URLResponse?

The transaction response. トランザクション応答。

Accessing Temporal Metrics 時間的指標にアクセスする

var fetchStartDate: Date?

The time when the task started fetching the resource, from the server or locally. タスクがリソースを、サーバーからまたはローカルに、取って来ることを開始したときの時間。

var domainLookupStartDate: Date?

The time immediately before the task started the name lookup for the resource. タスクがリソースに対する名前検索を開始した直前の時間。

var domainLookupEndDate: Date?

The time after the name lookup was completed. 名前検索が完了した後の時間。

var connectStartDate: Date?

The time immediately before the task started establishing a TCP connection to the server. タスクがサーバへのTCP接続を確立することを開始した直前の時間。

var secureConnectionStartDate: Date?

The time immediately before the task started the TLS security handshake to secure the current connection. タスクがTLSセキュリティハンドシェークを現在の接続を安全にするために開始した直前の時間。

var secureConnectionEndDate: Date?

The time immediately after the security handshake completed. セキュリティハンドシェークが完了した直後の時間。

var connectEndDate: Date?

The time immediately after the task finished establishing the connection to the server. タスクがサーバへの接続の確立を終了した直後の時間。

var requestStartDate: Date?

The time immediately before the task started requesting the resource, regardless of whether it is retrieved from the server or local resources. タスクがリソースのリクエストを、それがサーバまたはローカルリソースから回収されるかどうかに関係なく、開始した直前の時間。

var requestEndDate: Date?

The time immediately after the task finished requesting the resource, regardless of whether it was retrieved from the server or local resources. タスクがリソースのリクエストを、それがサーバまたはローカルリソースから回収されたかどうかに関係なく、終了した直後の時間。

var responseStartDate: Date?

The time immediately after the task received the first byte of the response from the server or from local resources. タスクがサーバからまたはローカルリソースから応答の最初のバイトを受け取った直後の時間。

var responseEndDate: Date?

The time immediately after the task received the last byte of the resource. タスクがリソースの最後のバイトを受け取った直後の時間。

Accessing Data Transfer Metrics データ転送指標にアクセスする

var countOfRequestBodyBytesBeforeEncoding: Int64

The size of the upload body data, file, or stream, in bytes. アップロードホディデータ、ファイル、またはストリームの大きさ、バイト数で。

var countOfRequestBodyBytesSent: Int64

The number of bytes transferred for the request body. リクエストボディに対して転送されたバイト数。

var countOfRequestHeaderBytesSent: Int64

The number of bytes transferred for the request header. リクエストヘッダに対して転送されたバイト数。

var countOfResponseBodyBytesAfterDecoding: Int64

The size of data delivered to your delegate or completion handler. あなたの委任先または完了ハンドラへと配達されたデータの大きさ。

var countOfResponseBodyBytesReceived: Int64

The number of bytes transferred for the response body. レンポンスボディに対して転送されたバイト数。

var countOfResponseHeaderBytesReceived: Int64

The number of bytes transferred for the response header. レンポンスヘッダに対して転送されたバイト数。

Accessing Transaction Characteristics トランザクション特徴にアクセスする

var networkProtocolName: String?

The network protocol used to fetch the resource. リソースを取って来るために使われるネットワークプロトコル。

var remoteAddress: String?

The IP address string of the remote interface for the connection. 接続に対するリモートインターフェイスのIPアドレス文字列。

var remotePort: Int?

The port number of the remote interface for the connection. 接続に対するリモートインターフェイスのポート番号。

var localAddress: String?

The IP address string of the local interface for the connection. 接続に対するローカルインターフェイスのIPアドレス文字列。

var localPort: Int?

The port number of the local interface for the connection. 接続に対するローカルインターフェイスのポート番号。

var negotiatedTLSCipherSuite: tls_ciphersuite_t?

The TLS cipher suite the task negotiated with the endpoint for the connection. TLS暗号スイート、その接続に対するエンドポイントと交渉するタスク。

var negotiatedTLSProtocolVersion: tls_protocol_version_t?

The TLS protocol version the task negotiated with the endpoint for the connection. TLS暗号プロトコルバージョン、その接続に対するエンドポイントと交渉するタスク。

var isCellular: Bool

A Boolean value that indicates whether the connection operates over a cellular interface. あるブール値、それは接続がセルラーインターフェイス越しに作動するかどうかを指し示します。

var isExpensive: Bool

A Boolean value that indicates whether the connection operates over an expensive interface. あるブール値、それは接続が高くつくインターフェイス越しに作動するかどうかを指し示します。

var isConstrained: Bool

A Boolean value that indicates whether the connection operates over an interface marked as constrained. あるブール値、それは制約されると印されるインターフェイス越しに接続が作動するかどうかを指し示します。

var isProxyConnection: Bool

A Boolean value that indicastes whether the task used a proxy connection to fetch the resource. あるブール値、それはタスクがリソースを取って来るためにプロキシ接続を使用したどうかを指し示しています。

var isReusedConnection: Bool

A Boolean value that indicates whether the task used a persistent connection to fetch the resource. あるブール値、それはタスクがリソースを取って来るために高くつく接続を使用したどうかを指し示しています。

var isMultipath: Bool

A Boolean value that indicates whether the connection uses a successfully negotiated multipath protocol. あるブール値、それは接続がある首尾よく交渉されたマルチバスプロトコルを使うかどうかを指し示します。

var resourceFetchType: URLSessionTaskMetrics.ResourceFetchType

A value that indicates whether the resource was loaded, pushed, or retrieved from the local cache. ある値、それはリソースがローカルキャッシュからロード、プッシュ、または回収されたかどうかを指し示します。

enum URLSessionTaskMetrics.ResourceFetchType

The manner in which a resource is fetched. それにおいてリソースが取って来られたところの流儀。

var domainResolutionProtocol: URLSessionTaskMetrics.DomainResolutionProtocol

enum URLSessionTaskMetrics.DomainResolutionProtocol