AWS SDK for Java 1.x は 2025 年 12 月 31 日にend-of-supportしました。新しい機能、可用性の向上、セキュリティ更新のために、[AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html) に移行することをお勧めします。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# のメトリクスの有効化 AWS SDK for Java
は、以下を測定する [Amazon CloudWatch](https://aws.amazon.com/cloudwatch/) を使用して可視化とモニタリングのメトリクスを生成 AWS SDK for Java できます。
+ アクセス時のアプリケーションのパフォーマンス AWS
+ で使用した場合の JVMsのパフォーマンス AWS
+ ヒープメモリ、スレッド数、開かれたファイル記述子などのランタイム環境の詳細
## Java SDK メトリクス生成を有効にする方法
SDK が CloudWatch にメトリクスを送信できるようにするには、次の Maven 依存関係を追加する必要があります。
```
com.amazonaws
aws-java-sdk-bom
1.12.490*
pom
import
com.amazonaws
aws-java-sdk-cloudwatchmetrics
provided
```
\$1 バージョン番号を [Maven Central](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) で入手可能な 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、メトリクスデータポイントが生成され、統計概要のためにキューに入れられ、約 1 分に 1 回 CloudWatch に非同期でアップロードされます。メトリクスがアップロードされたら、[AWS マネジメントコンソール](https://console.aws.amazon.com/console/home) を使用して可視化し、メモリリーク、ファイル記述子リークなどの潜在的な問題にアラームを設定できます。
## 利用可能なメトリクスのタイプ
デフォルトのメトリクスのセットは 3 つの主要なカテゴリに分かれています。
AWS リクエストメトリクス
+ HTTP リクエスト/応答のレイテンシー、リクエスト数、例外および再試行などのエリアを扱います。
![\[RequestMetric 131111\]](http://docs.aws.amazon.com/ja_jp/sdk-for-java/v1/developer-guide/images/RequestMetric-131111.png)
AWS のサービス メトリクス
+ S3 のアップロードとダウンロードのスループットやバイト数など、インクルード AWS のサービス固有のデータ。
![\[ServiceMetric 131111\]](http://docs.aws.amazon.com/ja_jp/sdk-for-java/v1/developer-guide/images/ServiceMetric-131111.png)
マシンメトリクス
+ ヒープメモリ、スレッド数、および開いているファイル記述子を含むランタイム環境を扱います。
![\[MachineMetric 131111\]](http://docs.aws.amazon.com/ja_jp/sdk-for-java/v1/developer-guide/images/MachineMetric-131111.png)
マシンメトリクスを除外する場合は、システムプロパティに `excludeMachineMetrics` を追加します。
```
-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,excludeMachineMetrics
```
## 詳細情報
+ 事前定義されたコアメトリクスタイプの詳細な一覧については、[amazonaws/metrics package summary](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/metrics/package-summary.html) を参照してください。
+ を使用した CloudWatch の操作については、[「 を使用した CloudWatch の例 AWS SDK for Java](examples-cloudwatch.md) AWS SDK for Java 」を参照してください。
+ パフォーマンスチューニングの詳細については、[「 をチューニング AWS SDK for Java して耐障害性を向上させる](https://aws.amazon.com/blogs/developer/tuning-the-aws-sdk-for-java-to-improve-resiliency)」ブログ記事を参照してください。