使用來自 AWS SDK for Java

使用 AWS SDK for Java 2.x，您可以收集有關應用程式中服務用戶端的指標、分析輸出 Amazon CloudWatch，然後對其採取行動。

依預設，SDK 中的指標收集處於停用狀態。本主題可協助您啟用和設定它。

必要條件

您必須先完成下列步驟，才能啟用和使用量度：

• 完成「設定 AWS SDK for Java 2. x」中的步驟。

• 設定您的專案相依性 (例如，在您的pom.xml2.14.0或build.gradle檔案中) 以使用 AWS SDK for Java.

  若要啟用度量發佈至 CloudWatch，請同時在專案的相依性中加入 artifactId cloudwatch-metric-publisher 與版本號碼2.14.0或更新版本。

  例如：

  <project>
    <dependencyManagement>
     <dependencies>
        <dependency>
          <groupId>software.amazon.awssdk</groupId>
          <artifactId>bom</artifactId>
          <version>2.14.0</version>
          <type>pom</type>
          <scope>import</scope>
        </dependency>
     </dependencies>
    </dependencyManagement>
    <dependencies>
     <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>cloudwatch-metric-publisher</artifactId>
        <version>2.14.0</version>
     </dependency>
    </dependencies>
  </project>

• 啟用 cloudwatch:PutMetricData IAM 身分的許可，以允許 SDK for Java 寫入指標。

如何啟用指標收集

您可以在應用程式中為服務用戶端或個別要求啟用指標。

為特定要求啟用量度

下列程式碼片段顯示如何為要求啟用 CloudWatch 量度發行者 Amazon DynamoDB。它使用默認指標發布者配置。

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

啟用特定服務用戶端的指標

下列程式碼片段顯示如何使用服務用戶端的預設設定啟用 CloudWatch 指標發行者。

MetricPublisher metricsPub = CloudWatchMetricPublisher.create();

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

下列程式碼片段示範如何針對特定服務用戶端的指標發行者使用自訂組態。自訂項目包括載入特定認證設定檔、指定與服務用戶端不同的區域，以及自訂發行者傳送指標的頻率 CloudWatch。

MetricPublisher metricsPub = CloudWatchMetricPublisher.builder()
    .cloudWatchClient(CloudWatchAsyncClient.builder()
                                           .region(Region.US_WEST_2)
                                           .credentialsProvider(ProfileCredentialsProvider.create("cloudwatch"))
                                           .build())
    .uploadFrequency(Duration.ofMinutes(5))
    .build();

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

指標何時可用？

一般而言，在 SDK for Java 出指標後 5-10 分鐘內即可使用。如需準確的 up-to-date 指標和指標，請在從 Java 應用程式發出指標後至少 10 分鐘檢查 Cloudwatch。

我們會收集哪些資訊？

量度集合包括下列項目：

• API 請求數量，包括它們是否成功或失敗

• 您在 API 要求中呼叫的 AWS 服務相關資訊，包括傳回的例外狀況

• 各種操作（例如編組，簽名和 HTTP 請求）的持續時間

• HTTP 從屬端測量結果，例如開啟的連線數目、擱置的要求數目，以及使用的 HTTP 從屬端名稱

注意

可用的測量結果因 HTTP 用戶端而異。

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

我該如何使用這些資訊？

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

如需詳細資訊，請參閱使用 Amazon CloudWatch 指南中的使用量度和使用 Amazon CloudWatch 警示。Amazon CloudWatch