AWS SDK for Java 2.x: 包括的なメトリクスリファレンス - AWS SDK for Java 2.x

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

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 コールの署名認証情報を取得する期間。 期間*

*java.time.Duration

リクエストの各試行について収集されたメトリクス

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

コアメトリクス

メトリクス名 説明 [Type] (タイプ)

AwsExtendedRequestId

サービスリクエストの拡張リクエスト ID。

文字列

AwsRequestId

サービスリクエストのリクエスト ID。

文字列

BackoffDelayDuration

この API コールが試行されるまで SDK が待機した時間。値は、クライアントでBackoffStrategy設定された に基づいています。詳細については、このガイドの再試行戦略「」セクションを参照してください。

期間*

ErrorType

呼び出しの試行で発生したエラーのタイプ。

以下の値を指定できます。

  • Throttling: サービスがスロットリングエラーで応答しました。

  • ServerError: サービスはスロットリング以外のエラーで応答しました。

  • ConfiguredTimeout: API コールレベルまたは API コール試行レベルでクライアントタイムアウトが発生しました。

  • IO: I/O エラーが発生しました。

  • Other: 上記のカテゴリリストの 1 つに該当しないその他のエラーはキャッチオールです。

文字列
ReadThroughput

として定義されるクライアントの読み取りスループットNumberOfResponseBytesRead / (TTLB - TTFB)。この値は 1 秒あたりのバイト数です。

このメトリクスは、 ResponseTransformerまたは 内から読み取られたバイトのみを測定することに注意してくださいAsyncResponseTransformer。トランスフォーマーの結果としてレスポンスストリームが返されるなど、トランスフォーマーの外部で読み取られるデータは計算に含まれません。

倍精度

ServiceCallDuration

サービスへの接続 (または接続プールから接続の取得)、シリアル化されたリクエストの送信、初期レスポンス (HTTP ステータスコードやヘッダーなど) の受信にかかる時間。これには、サービスからレスポンス全体を読み取る時間は含まれません。

期間*

SigningDuration

HTTP リクエストに署名する期間。

期間*

TimeToFirstByte サービスへの HTTP リクエストの送信 (接続の取得を含む) から、レスポンス内のヘッダーの最初のバイトの受信までの時間。 期間*
TimeToLastByte

サービスへの HTTP リクエストの送信 (接続の取得を含む) からレスポンスの最後のバイトの受信までの時間。

ストリーミングレスポンスを返APIs の場合、このメトリクスは ResponseTransformerまたは AsyncResponseTransformerが完了するまでにまたがることに注意してください。

期間*

UnmarshallingDuration

SDK レスポンスへの HTTP レスポンスのマーシャリングを解除する期間。

注: ストリーミングオペレーションの場合、これにはレスポンスペイロードを読み取る時間は含まれません。

期間*

*java.time.Duration

HTTP メトリクス

メトリクス名 説明 [Type] (タイプ) HTTP クライアントが必要*

AvailableConcurrency

ターゲットサーバーへの新しい接続を確立せずに HTTP クライアントがサポートする追加の同時リクエストの数。

HTTP/1 オペレーションの場合、これはサービスで確立されたアイドル状態の TCP 接続の数に等しくなります。HTTP/2 オペレーションの場合、これはアイドルストリームの数に等しくなります。

注: この値は HTTP クライアントの実装によって異なります。

  • Apache クライアント: 値は HTTP クライアント全体に適用されます

  • Netty クライアント: 値はエンドポイントごとに適用されます

  • AWS CRT ベースのクライアント: 値はエンドポイントごとに適用されます

値は個々の HTTP クライアントインスタンスに限定され、同じ JVM 内の他の HTTP クライアントからの同時実行を除外します。

整数

アパッチ、Netty、CRT

ConcurrencyAcquireDuration

接続プールからチャネルを取得する期間。

HTTP/1 オペレーションの場合、チャネルは TCP 接続に等しくなります。HTTP/2 オペレーションの場合、チャネルは HTTP/2 ストリームチャネルに等しくなります。

新しいチャネルの取得には、次の時間が含まれる場合があります。

  1. クライアントの最大同時実行数設定によって制限されている同時実行許可を待っています。

  2. プールに既存の接続がない場合は、新しい接続を確立します。

  3. TLS が有効になっている場合は、TLS ハンドシェイクとネゴシエーションを実行します。

期間*

アパッチ、Netty、CRT

HttpClientName

リクエストに使用される HTTP の名前。

文字列

アパッチ、Netty、CRT

HttpStatusCode

HTTP レスポンスのステータスコード。

整数

いずれか

LeasedConcurrency

HTTP クライアントが現在実行しているリクエストの数。

HTTP/1 オペレーションの場合、これは サービスとのアクティブな TCP 接続の数 (アイドル接続を除く) に等しくなります。HTTP/2 オペレーションの場合、これは サービスでアクティブな HTTP ストリームの数に等しくなります (アイドルストリーム容量を除く)。

注: この値は HTTP クライアントの実装によって異なります。

  • Apache クライアント: 値は HTTP クライアント全体に適用されます

  • Netty クライアント: 値はエンドポイントごとに適用されます

  • AWS CRT ベースのクライアント: 値はエンドポイントごとに適用されます

値は個々の HTTP クライアントインスタンスに限定され、同じ JVM 内の他の HTTP クライアントからの同時実行を除外します。

整数

アパッチ、Netty、CRT

LocalStreamWindowSize

このリクエストを実行するストリームのローカル HTTP/2 ウィンドウサイズ。

整数

Netty

MaxConcurrency

HTTP クライアントがサポートする同時リクエストの最大数。

HTTP/1 オペレーションの場合、これは HTTP クライアントがプールできる TCP 接続の最大数に等しくなります。HTTP/2 オペレーションの場合、これは HTTP クライアントがプールできるストリームの最大数に等しくなります。

注: この値は HTTP クライアントの実装によって異なります。

  • Apache クライアント: 値は HTTP クライアント全体に適用されます

  • Netty クライアント: 値はエンドポイントごとに適用されます

  • AWS CRT ベースのクライアント: 値はエンドポイントごとに適用されます

値は個々の HTTP クライアントインスタンスに限定され、同じ JVM 内の他の HTTP クライアントからの同時実行を除外します。

整数

アパッチ、Netty、CRT

PendingConcurrencyAcquires

HTTP クライアントからの同時実行を待機するリクエストの数。

HTTP/1 オペレーションの場合、これは TCP 接続が接続プールを確立または返すのを待っているリクエストの数に等しくなります。HTTP/2 オペレーションの場合、これは接続プールからの新しいストリーム (場合によっては新しい HTTP/2 接続) を待っているリクエストの数に等しくなります。

注: この値は HTTP クライアントの実装によって異なります。

  • Apache クライアント: 値は HTTP クライアント全体に適用されます

  • Netty クライアント: 値はエンドポイントごとに適用されます

  • AWS CRT ベースのクライアント: 値はエンドポイントごとに適用されます

値は個々の HTTP クライアントインスタンスに限定され、同じ JVM 内の他の HTTP クライアントからの同時実行を除外します。

整数

アパッチ、Netty、CRT

RemoteStreamWindowSize

このリクエストを実行するストリームのリモート HTTP/2 ウィンドウサイズをバイト単位で指定します。

整数

Netty

*java.time.Duration

列で使用される用語の意味は次のとおりです。

  • Apache: アパッチベースの HTTP クライアント (ApacheHttpClient)

  • Netty: Netty ベースの HTTP クライアント (NettyNioAsyncHttpClient)

  • CRT: AWS CRT ベースの HTTP クライアント (AwsCrtAsyncHttpClient

  • すべて: メトリクスデータの収集は HTTP クライアントに依存しません。これには URLConnection ベースの HTTP クライアント (UrlConnectionHttpClient) が含まれます。