AWS SDK for Java 1.x は 2024 年 7 月 31 日にメンテナンスモードに移行し、2025 年 12 月 31 end-of-support
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
のメトリクスの有効化 AWS SDK for Java
AWS SDK for Java は、以下を測定する Amazon CloudWatch
-
アクセス時のアプリケーションのパフォーマンス AWS
-
で使用JVMsした場合の のパフォーマンス AWS
-
ヒープメモリ、スレッド数、開かれたファイル記述子などのランタイム環境の詳細
Java SDKメトリクス生成を有効にする方法
が にメトリクスを送信できるようにするにはSDK、次の Maven 依存関係を追加する必要があります CloudWatch。
<dependencyManagement> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-bom</artifactId> <version>
1.12.490
*</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-cloudwatchmetrics</artifactId> <scope>provided</scope> </dependency> <!-- Other SDK dependencies. --> </dependencies>
* バージョン番号を Maven Central
AWS SDK for Java メトリクスはデフォルトでは無効になっています。ローカル開発環境で有効にするには、 の起動時に AWS セキュリティ認証情報ファイルを指すシステムプロパティを含めますJVM。例:
-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties
が収集したデータポイントを にアップロードして CloudWatch 後で分析できるようにSDK、認証情報ファイルへのパスを指定する必要があります。
注記
Amazon EC2 インスタンスメタデータサービスを使用して Amazon EC2 インスタンス AWS から にアクセスする場合は、認証情報ファイルを指定する必要はありません。この場合、指定する必要があるのは以下だけです。
-Dcom.amazonaws.sdk.enableDefaultMetrics
でキャプチャされたすべてのメトリクス AWS SDK for Java は、 名前空間 AWSSDK/Java の下にあり、 CloudWatch デフォルトのリージョン (us-east-1) にアップロードされます。リージョンを変更するには、システムプロパティの cloudwatchRegion
属性を使用して指定します。例えば、 CloudWatch リージョンを us-east-1 に設定するには、以下を使用します。
-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,cloudwatchRegion={region_api_default}
この機能を有効にすると、 AWS から へのサービスリクエストがあるたびに AWS SDK for Java、メトリクスデータポイントが生成され、統計サマリーのキューに入れられ、 CloudWatch 約 1 分に 1 回まで非同期的にアップロードされます。メトリクスがアップロードされたら、AWS Management Console
利用可能なメトリクスのタイプ
デフォルトのメトリクスのセットは 3 つの主要なカテゴリに分かれています。
- AWS リクエストメトリクス
-
-
HTTP リクエスト/レスポンスのレイテンシー、リクエスト数、例外、再試行などの領域をカバーします。
-
- AWS サービス メトリクス
-
-
S3 のアップロードとダウンロードのスループットやバイト数など、 AWS サービス固有のデータを含めます。
-
- マシンメトリクス
-
-
ヒープメモリ、スレッド数、および開いているファイル記述子を含むランタイム環境を扱います。
マシンメトリクスを除外する場合は、システムプロパティに
excludeMachineMetrics
を追加します。-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,excludeMachineMetrics
-
詳細情報
-
事前定義されたコアメトリクスタイプの詳細な一覧については、amazonaws/metrics package summary を参照してください。
-
の使用については、「 CloudWatch の使用例 AWS SDK for Java 」を参照してください。 CloudWatch AWS SDK for Java
-
パフォーマンスチューニングの詳細については、「 のチューニング AWS SDK for Java による回復性の向上
」ブログ記事を参照してください。