( AWS SDK for Java v1) 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 メトリクスはデフォルトでは無効になっています。これをローカル開発環境で有効にするには、JVM の起動時に AWS セキュリティ認証情報ファイルをポイントするシステムプロパティを含めます。例:
-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties
SDK が収集したデータポイントを にアップロードして CloudWatch 後で分析できるように、認証情報ファイルへのパスを指定する必要があります。
注記
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 による回復性の向上
」ブログ記事を参照してください。