本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

從 發佈 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();

如需完整的實作詳細資訊、相依性和組態選項，請參閱上述設定指南。

何時可使用指標？

指標通常會在適用於 Java 的 SDK 發出後 5-10 分鐘內提供。如需準確且up-to-date指標，請在從 Java 應用程式發出指標後至少 10 分鐘檢查 Cloudwatch。

會收集哪些資訊？

指標集合包括下列項目：

如需完整清單，請參閱服務用戶端指標。

如何使用此資訊？

您可以使用 SDK 收集的指標來監控應用程式中的服務用戶端。您可以查看整體用量趨勢、識別異常、檢閱傳回的服務用戶端例外狀況，或深入了解特定問題。使用 Amazon CloudWatch Logs，您也可以建立警示，在應用程式到達您定義的條件時立即通知您。

如需詳細資訊，請參閱《Amazon CloudWatch Logs 使用者指南》中的使用 Amazon CloudWatch Logs 指標和 Amazon CloudWatch使用 Amazon CloudWatch Logs Amazon CloudWatch 警示。