翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS SDK for Java 2.x: 包括的なメトリクスリファレンス
を使用すると AWS SDK for Java 2.x、アプリケーションのサービスクライアントからメトリクスを収集し、それらのメトリクスを Amazon CloudWatch に発行 (出力) できます。
これらのテーブルは、収集できるメトリクスと HTTP クライアントの使用要件を示しています。
SDK のメトリクスの有効化と設定の詳細については、SDK メトリクスの有効化を参照してください。
各リクエストで収集されたメトリクス
| メトリクス名 | 説明 | [Type] (タイプ) | 
|---|---|---|
| ApiCallDuration | API コールの期間。これには、行われたすべての通話試行が含まれます。 | 期間* | 
| ApiCallSuccessful | API コールが成功した場合は true、それ以外の場合は false。 | ブール値 | 
| CredentialsFetchDuration | API コールの署名認証情報を取得する期間。 | 期間* | 
| EndpointResolveDuration | API コールに使用されるエンドポイントを解決する期間。 | 期間* | 
| MarshallingDuration | SDK リクエストを HTTP リクエストにマーシャリングする期間。 | 期間* | 
| OperationName | 呼び出されるサービスオペレーションの名前。 | 文字列 | 
| RetryCount | SDK がリクエストの実行中に実行した再試行の数。0 は、リクエストが最初に機能し、再試行されなかったことを意味します。 再試行動作の設定の詳細については、「」を参照してください再試行戦略。 | 整数 | 
| ServiceId | サービスの一意の ID。 | 文字列 | 
| ServiceEndpoint | サービスのエンドポイント。 | [URI] | 
| TokenFetchDuration | API コールの署名認証情報を取得する期間。 | 期間* | 
リクエストの各試行について収集されたメトリクス
各 API コールでは、レスポンスが受信されるまでに複数回試行する必要がある場合があります。これらのメトリクスは、各試行について収集されます。
コアメトリクス
| メトリクス名 | 説明 | [Type] (タイプ) | 
|---|---|---|
| AwsExtendedRequestId | サービスリクエストの拡張リクエスト ID。 | 文字列 | 
| AwsRequestId | サービスリクエストのリクエスト ID。 | 文字列 | 
| BackoffDelayDuration | この API コールが試行されるまで SDK が待機した時間。値は、クライアントで | 期間* | 
| ErrorType | 呼び出しの試行で発生したエラーのタイプ。 以下の値を指定できます。 
 | 文字列 | 
| ReadThroughput | として定義されるクライアントの読み取りスループット このメトリクスは、  | 倍精度 | 
| ServiceCallDuration | サービスへの接続 (または接続プールから接続の取得)、シリアル化されたリクエストの送信、初期レスポンス (HTTP ステータスコードやヘッダーなど) の受信にかかる時間。これには、サービスからレスポンス全体を読み取る時間は含まれません。 | 期間* | 
| SigningDuration | HTTP リクエストに署名する期間。 | 期間* | 
| TimeToFirstByte | サービスへの HTTP リクエストの送信 (接続の取得を含む) から、レスポンス内のヘッダーの最初のバイトの受信までの時間。 | 期間* | 
| TimeToLastByte | サービスへの HTTP リクエストの送信 (接続の取得を含む) からレスポンスの最後のバイトの受信までの時間。 ストリーミングレスポンスを返APIs の場合、このメトリクスは  | 期間* | 
| UnmarshallingDuration | SDK レスポンスへの HTTP レスポンスのマーシャリングを解除する期間。 注: ストリーミングオペレーションの場合、これにはレスポンスペイロードを読み取る時間は含まれません。 | 期間* | 
HTTP メトリクス
| メトリクス名 | 説明 | [Type] (タイプ) | HTTP クライアントが必要* | 
|---|---|---|---|
| AvailableConcurrency | ターゲットサーバーへの新しい接続を確立せずに HTTP クライアントがサポートする追加の同時リクエストの数。 HTTP/1 オペレーションの場合、これはサービスで確立されたアイドル状態の TCP 接続の数に等しくなります。HTTP/2 オペレーションの場合、これはアイドルストリームの数に等しくなります。 注: この値は HTTP クライアントの実装によって異なります。 
 値は個々の HTTP クライアントインスタンスに限定され、同じ JVM 内の他の HTTP クライアントからの同時実行を除外します。 | 整数 | アパッチ、Netty、CRT | 
| ConcurrencyAcquireDuration | 接続プールからチャネルを取得する期間。 HTTP/1 オペレーションの場合、チャネルは TCP 接続に等しくなります。HTTP/2 オペレーションの場合、チャネルは HTTP/2 ストリームチャネルに等しくなります。 新しいチャネルの取得には、次の時間が含まれる場合があります。 
 | 期間* | アパッチ、Netty、CRT | 
| HttpClientName | リクエストに使用される HTTP の名前。 | 文字列 | アパッチ、Netty、CRT | 
| HttpStatusCode | HTTP レスポンスのステータスコード。 | 整数 | いずれか | 
| LeasedConcurrency | HTTP クライアントが現在実行しているリクエストの数。 HTTP/1 オペレーションの場合、これは サービスとのアクティブな TCP 接続の数 (アイドル接続を除く) に等しくなります。HTTP/2 オペレーションの場合、これは サービスでアクティブな HTTP ストリームの数に等しくなります (アイドルストリーム容量を除く)。 注: この値は HTTP クライアントの実装によって異なります。 
 値は個々の HTTP クライアントインスタンスに限定され、同じ JVM 内の他の HTTP クライアントからの同時実行を除外します。 | 整数 | アパッチ、Netty、CRT | 
| LocalStreamWindowSize | このリクエストを実行するストリームのローカル HTTP/2 ウィンドウサイズ。 | 整数 | Netty | 
| MaxConcurrency | HTTP クライアントがサポートする同時リクエストの最大数。 HTTP/1 オペレーションの場合、これは HTTP クライアントがプールできる TCP 接続の最大数に等しくなります。HTTP/2 オペレーションの場合、これは HTTP クライアントがプールできるストリームの最大数に等しくなります。 注: この値は HTTP クライアントの実装によって異なります。 
 値は個々の HTTP クライアントインスタンスに限定され、同じ JVM 内の他の HTTP クライアントからの同時実行を除外します。 | 整数 | アパッチ、Netty、CRT | 
| PendingConcurrencyAcquires | HTTP クライアントからの同時実行を待機するリクエストの数。 HTTP/1 オペレーションの場合、これは TCP 接続が接続プールを確立または返すのを待っているリクエストの数に等しくなります。HTTP/2 オペレーションの場合、これは接続プールからの新しいストリーム (場合によっては新しい HTTP/2 接続) を待っているリクエストの数に等しくなります。 注: この値は HTTP クライアントの実装によって異なります。 
 値は個々の HTTP クライアントインスタンスに限定され、同じ JVM 内の他の HTTP クライアントからの同時実行を除外します。 | 整数 | アパッチ、Netty、CRT | 
| RemoteStreamWindowSize | このリクエストを実行するストリームのリモート HTTP/2 ウィンドウサイズをバイト単位で指定します。 | 整数 | Netty | 
列で使用される用語の意味は次のとおりです。
- 
               Apache: アパッチベースの HTTP クライアント ( ApacheHttpClient)
- 
               Netty: Netty ベースの HTTP クライアント ( NettyNioAsyncHttpClient)
- 
               CRT: AWS CRT ベースの HTTP クライアント ( AwsCrtAsyncHttpClient)
- 
               すべて: メトリクスデータの収集は HTTP クライアントに依存しません。これには URLConnection ベースの HTTP クライアント ( UrlConnectionHttpClient) が含まれます。