のメトリクスの有効化 AWS SDK for Java - AWS SDK for Java 1.x

AWS SDK for Java 1.x は 2024 年 7 月 31 日にメンテナンスモードに移行し、2025 年 12 月 31 end-of-support日に に到達します。新しい機能、可用性の向上、およびセキュリティアップデートを引き続き受け取るAWS SDK for Java 2.xには、 に移行することをお勧めします。

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

のメトリクスの有効化 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 でSDK利用可能な の最新バージョンに置き換えます。

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 リクエスト/レスポンスのレイテンシー、リクエスト数、例外、再試行などの領域をカバーします。

    RequestMetric 131111
AWS サービス メトリクス
  • S3 のアップロードとダウンロードのスループットやバイト数など、 AWS サービス固有のデータを含めます。

    ServiceMetric 131111
マシンメトリクス
  • ヒープメモリ、スレッド数、および開いているファイル記述子を含むランタイム環境を扱います。

    MachineMetric 131111

    マシンメトリクスを除外する場合は、システムプロパティに excludeMachineMetrics を追加します。

    -Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,excludeMachineMetrics

詳細情報