Class

NSURLSessionTaskTransactionMetrics

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

Declaration 宣言

@interface NSURLSessionTaskTransactionMetrics : NSObject

Overview 概要

Each NSURLSessionTaskTransactionMetrics 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. 各NSURLSessionTaskTransactionMetricsオブジェクトは、対応しているタスクのリクエストと応答に対応している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 NSURLSessionTaskTransactionMetrics. 図 1 はあるURLセッションタスクに対する一連のイベントを示します、それらはNSURLSessionTaskTransactionMetricsによってキャプチャされた時間的指標に対応します。

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 proxyConnection 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 リクエストと応答にアクセスする

request

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

response

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

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

fetchStartDate

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

domainLookupStartDate

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

domainLookupEndDate

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

connectStartDate

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

secureConnectionStartDate

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

secureConnectionEndDate

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

connectEndDate

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

requestStartDate

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

requestEndDate

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

responseStartDate

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

responseEndDate

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

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

countOfRequestBodyBytesBeforeEncoding

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

countOfRequestBodyBytesSent

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

countOfRequestHeaderBytesSent

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

countOfResponseBodyBytesAfterDecoding

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

countOfResponseBodyBytesReceived

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

countOfResponseHeaderBytesReceived

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

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

networkProtocolName

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

remoteAddress

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

remotePort

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

localAddress

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

localPort

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

negotiatedTLSCipherSuite

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

negotiatedTLSProtocolVersion

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

cellular

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

expensive

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

constrained

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

proxyConnection

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

reusedConnection

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

multipath

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

resourceFetchType

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

NSURLSessionTaskMetricsResourceFetchType

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

domainResolutionProtocol

NSURLSessionTaskMetricsDomainResolutionProtocol