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

から SDK メトリクスを発行する AWS SDK for Java 2.x

AWS SDK for Java 2.x を使用すると、アプリケーション内のサービスクライアントとリクエストに関するメトリクスを収集し、Amazon CloudWatch Logs で出力を分析し、それに対応できます。

デフォルトでは、SDK でメトリクスの収集が無効になっています。このトピックは、それを有効にして設定するのに役立ちます。

SDK メトリクスの開始方法

アプリケーションでメトリクス収集を有効にするには、ユースケースに基づいてMetricPublisherインターフェイスの適切な実装を選択し、詳細なセットアップ手順に従います。

長時間実行されるアプリケーションの場合：

AWS Lambda 関数の場合：

トラブルシューティングとコンソール出力の場合：

クイック実装プレビュー

各ユースケースでメトリクスを有効にする方法は次のとおりです。

長時間実行されるアプリケーション：

MetricPublisher metricsPub = CloudWatchMetricPublisher.create();
DynamoDbClient ddb = DynamoDbClient.builder()
    .overrideConfiguration(c -> c.addMetricPublisher(metricsPub))
    .build();

Lambda 関数：

EmfMetricLoggingPublisher emfPublisher = EmfMetricLoggingPublisher.builder()
    .namespace("MyApp")
    .build();
DynamoDbClient dynamoDb = DynamoDbClient.builder()
    .overrideConfiguration(c -> c.addMetricPublisher(emfPublisher))
    .build();

開発とデバッグ：

MetricPublisher loggingPublisher = LoggingMetricPublisher.create();
S3Client s3 = S3Client.builder()
    .overrideConfiguration(c -> c.addMetricPublisher(loggingPublisher))
    .build();

実装の詳細、依存関係、設定オプションの詳細については、上記のセットアップガイドを参照してください。

メトリクスが利用可能になるまでの時間

メトリクスは通常、SDK for Java によって発行されてから 5 ～ 10 分以内に利用可能になります。正確で最新のメトリクスを利用するには、Java アプリケーションからメトリクスが発行されてから 10 分以上経過後、Cloudwatch を確認してください。

収集される情報

メトリクスの収集には、次のものが含まれます。

詳細なリストについては、サービスクライアントのメトリクスを参照してください。

この情報の使用方法

SDK が収集するメトリクスを使用して、アプリケーションのサービスクライアントをモニタリングできます。全体的な使用傾向の確認や、異常の特定ができるほか、返されたサービスクライアントの例外を確認したり、特定の問題を理解するために詳しく確認したりすることもできます。Amazon CloudWatch Logs を使用して、アプリケーションが定義した条件に達したらすぐに通知するアラームを作成することもできます。

詳細については、Amazon CloudWatch Logs ユーザーガイド」の「Amazon CloudWatch Logs メトリクスAmazon CloudWatchの使用」および「Amazon CloudWatch Logs アラーム Amazon CloudWatchの使用」を参照してください。