翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS SDK for Java 2.x: 包括的なメトリクスのリファレンス
<a name="metrics-list"></a>

を使用すると AWS SDK for Java 2.x、アプリケーションのサービスクライアントからメトリクスを収集し、それらのメトリクスを [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) に発行 (出力) できます。

これらのテーブルは、収集できるメトリクスと HTTP クライアントの使用要件を示しています。

SDK のメトリクスの有効化と設定の詳細については、[SDK メトリクスの有効化](metrics.md)を参照してください。

## 各リクエストで収集されたメトリクス
<a name="metrics-perrequest"></a>


| メトリクス名 | 説明 | タイプ | 
| --- | --- | --- | 
|  ApiCallDuration  |  API コールが行われた時間。これには、試行されたすべての呼び出しが含まれます。  |  時間\$1  | 
|  ApiCallSuccessful  |  API コールが成功した場合は true、それ以外の場合は false。  |  ブール値  | 
|  CredentialsFetchDuration  |  API コールの署名認証情報を取得するまでの時間。  |  時間\$1  | 
| EndpointResolveDuration | API コールに使用されるエンドポイントを解決するまでの時間。 | 時間\$1 | 
|  MarshallingDuration  |  SDK リクエストを HTTP リクエストにマーシャリングするまでの時間。  |  時間\$1  | 
|  OperationName  |  呼び出されるサービスオペレーションの名前。  |  String  | 
|  RetryCount  |  SDK がリクエストの実行中に再試行した回数。0 は、リクエストが最初に成功し、再試行されなかったことを意味します。 再試行動作の設定については、「[再試行戦略](retry-strategy.md#retry-strategies)」を参照してください。  |  整数  | 
|  ServiceId  |  サービスの一意の ID。  |  String  | 
|  ServiceEndpoint  |  サービスのエンドポイント。  |  [URI]  | 
|  TokenFetchDuration  | API コールの署名認証情報を取得するまでの時間。 | 時間\$1 | 

\$1[java.time.Duration](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/time/Duration.html).

## リクエストの各試行について収集されたメトリクス
<a name="metrics-perattempt"></a>

各 API コールでは、レスポンスが受信されるまでに複数回試行する必要がある場合があります。これらのメトリクスは、各試行について収集されます。

### コアメトリクス
<a name="metrics-perattempt-core"></a>


| メトリクス名 | 説明 | タイプ | 
| --- | --- | --- | 
|  AwsExtendedRequestId  |  サービスリクエストの拡張リクエスト ID。  |  String  | 
|  AwsRequestId  |  サービスリクエストのリクエスト ID。  |  String  | 
|  BackoffDelayDuration  |  この API コールが試行される前に SDK が待機した時間。値は、クライアントで設定された `[https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/retries/api/BackoffStrategy.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/retries/api/BackoffStrategy.html)` に基づきます。詳細については、このガイドの「[再試行戦略](retry-strategy.md#retry-strategies)」セクションを参照してください。  |  時間\$1  | 
| ErrorType |  呼び出しの試行で発生したエラーのタイプ。 以下の値を指定できます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/metrics-list.html)  | String | 
| ReadThroughput |  `NumberOfResponseBytesRead / (TTLB - TTFB)` として定義されるクライアントの読み取りスループット。この値は 1 秒あたりのバイト数です。 このメトリクスは、 `ResponseTransformer` または `AsyncResponseTransformer` 内から読み取られたバイトのみを測定することに注意してください。トランスフォーマーの結果としてレスポンスストリームが返される場合など、トランスフォーマーの外部で読み取られるデータは計算に含まれません。  | Double | 
| WriteThroughput |  クライアントの書き込みスループット。 として定義されます`RequestBytesWritten / (LastByteWrittenTime - FirstByteWrittenTime)`。この値は 1 秒あたりのバイト数です。 このメトリクスは、SDK がリクエストボディを HTTP クライアントに提供するレートを測定します。接続設定、TLS ハンドシェイク時間、サーバー処理時間は含まれません。このメトリクスは、S3 PutObject などのストリーミング本文を持つリクエストに対してのみ報告されます。 このメトリクスは、HTTP クライアントレイヤーでのバッファリングを考慮しないことに注意してください。HTTP クライアントが送信前にデータをバッファする場合、実際のネットワーク送信レートが低下する可能性があります。このメトリクスは、ネットワークスループットの上限を表します。  | Double | 
|  ServiceCallDuration  |  サービスへの接続 (または接続プールからの接続の取得）、シリアル化されたリクエストの送信、最初のレスポンス (HTTP ステータスコードやヘッダーなど) の受信にかかる時間。これには、サービスからレスポンス全体を読み取る時間は含まれません。  |  時間\$1  | 
|  SigningDuration  |  HTTP リクエストに署名するまでの時間。  |  時間\$1  | 
| TimeToFirstByte | サービスへの HTTP リクエストの送信 (接続の取得を含む) から、レスポンス内のヘッダーの最初のバイトを受信するまでの時間。 | 時間\$1 | 
| TimeToLastByte |  サービスへの HTTP リクエストの送信 (接続の取得を含む) から、レスポンス内の最後のバイトを受信するまでの時間。 ストリーミングレスポンスを返す API の場合、このメトリクスは `ResponseTransformer` または `AsyncResponseTransformer` が完了するまでが対象となります。  | 時間\$1 | 
|  UnmarshallingDuration  |  SDK 応答に対する HTTP 応答のマーシャリングを解除するまでの時間。 注: ストリーミングオペレーションの場合、これにはレスポンスのペイロードを読み取る時間は含まれません。  |  時間\$1  | 

\$1[java.time.Duration](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/time/Duration.html).

### HTTP メトリクス
<a name="metrics-perattempt-http"></a>


| メトリクス名 | 説明 | タイプ | HTTP クライアントが必須です\$1 | 
| --- | --- | --- | --- | 
|  AvailableConcurrency  |  ターゲットサーバーへの新しい接続を確立せずに HTTP クライアントがサポートできる追加の同時リクエストの数。 HTTP/1 オペレーションの場合、これはサービスで確立されたアイドル状態の TCP 接続の数に等しくなります。HTTP/2 オペレーションの場合、これはアイドルストリームの数に等しくなります。 注: この値は HTTP クライアントの実装によって異なります。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/metrics-list.html) 値は個々の HTTP クライアントインスタンスに限定され、同じ JVM 内の他の HTTP クライアントからの同時実行を除外します。  |  整数  | アパッチ、Netty、CRT | 
|  ConcurrencyAcquireDuration  |  接続プールからチャンネルを取得するまでの時間。 HTTP/1 オペレーションの場合、チャネルは TCP 接続に等しくなります。HTTP/2 オペレーションの場合、チャネルは HTTP/2 ストリームチャネルに等しくなります。 新しいチャネルの取得には、次の時間が含まれる場合があります。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/metrics-list.html)  |  時間\$1  |  アパッチ、Netty、CRT  | 
|  HttpClientName  |  リクエストに使用されている HTTP の名前。  |  String  |  アパッチ、Netty、CRT  | 
|  HttpStatusCode  |  HTTP レスポンスの ステータスコード。  |  整数  |  いずれか  | 
|  LeasedConcurrency  |  HTTP クライアントが現在実行しているリクエストの数。 HTTP/1 オペレーションの場合、これは サービスとのアクティブな TCP 接続の数 (アイドル接続を除く) に等しくなります。HTTP/2 オペレーションの場合、これはサービスに対してアクティブな HTTP ストリームの数に等しくなります (アイドルストリーム容量を除く）。 注: この値は HTTP クライアントの実装によって異なります。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/metrics-list.html) 値は個々の HTTP クライアントインスタンスに限定され、同じ JVM 内の他の HTTP クライアントからの同時実行を除外します。  |  整数  |  アパッチ、Netty、CRT  | 
|  LocalStreamWindowSize  |  このリクエストを実行したストリームのローカル HTTP/2 ウィンドウサイズ (バイト)。  |  整数  |  Netty  | 
|  MaxConcurrency  |  HTTP クライアントによってサポートされる同時リクエストの最大数。 HTTP/1 オペレーションの場合、これは HTTP クライアントがプールできる TCP 接続の最大数に等しくなります。HTTP/2 オペレーションの場合、これは HTTP クライアントがプールできるストリームの最大数に等しくなります。 注: この値は HTTP クライアントの実装によって異なります。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/metrics-list.html) 値は個々の HTTP クライアントインスタンスに限定され、同じ JVM 内の他の HTTP クライアントからの同時実行を除外します。  |  整数  |  アパッチ、Netty、CRT  | 
|  PendingConcurrencyAcquires  |  HTTP クライアントからの同時実行を待機するリクエストの数。 HTTP/1 のオペレーションの場合、これは TCP 接続の確立待を待っている、または接続プールからの返却を待っているリクエスト数に等しくなります。HTTP/2 オペレーションの場合、これは接続プールからの新しいストリーム (場合によっては新しい HTTP/2 接続) を待っているリクエストの数に等しくなります。 注: この値は HTTP クライアントの実装によって異なります。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/metrics-list.html) 値は個々の HTTP クライアントインスタンスに限定され、同じ JVM 内の他の HTTP クライアントからの同時実行を除外します。  |  整数  |  アパッチ、Netty、CRT  | 
|  RemoteStreamWindowSize  |  このリクエストを実行したストリームのリモート HTTP/2 ウィンドウサイズ (バイト)  |  整数  |  Netty  | 

\$1[java.time.Duration](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/time/Duration.html).

列で使用されている用語の意味は以下のとおりです。
+ Apache: アパッチベースの HTTP クライアント (`[ApacheHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/apache/ApacheHttpClient.html)`)
+ Netty: Netty ベースの HTTP クライアント (`[NettyNioAsyncHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/nio/netty/NettyNioAsyncHttpClient.html)`)
+ CRT: AWS CRT ベースの HTTP クライアント (`[AwsCrtAsyncHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/crt/AwsCrtAsyncHttpClient.html)`)
+ 任意:メトリクスデータの収集は HTTP クライアントに依存しません。これには URLConnection ベースの HTTP クライアント (`[UrlConnectionHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/urlconnection/UrlConnectionHttpClient.html)`) も含まれます。