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

( AWS SDK for Java v1) end-of-support の今後の を発表しましたAWS SDK for Java v2 に移行することをお勧めします。日付、その他の詳細、移行方法については、リンク先の発表内容を参照してください。

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

のメトリクスの有効化 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 メトリクスはデフォルトでは無効になっています。これをローカル開発環境で有効にするには、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 リクエスト/応答のレイテンシー、リクエスト数、例外および再試行などのエリアを扱います。

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

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

    MachineMetric 131111

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

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

詳細情報