啟用 的指標 AWS SDK for Java - AWS SDK for Java 1.x

截至 2024 年 7 月 31 日, AWS SDK for Java 1.x 已進入維護模式,並將end-of-support在 2025 年 12 月 31 日送達。我們建議您遷移至 AWS SDK for Java 2.x,以繼續接收新功能、可用性改進和安全性更新。

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

啟用 的指標 AWS SDK for Java

AWS SDK for Java 可以使用 Amazon CloudWatch 產生視覺化和監控的指標,以測量:

  • 存取應用程式的效能 AWS

  • 搭配 使用JVMs時, 的效能 AWS

  • 執行期環境詳細資訊,例如堆積記憶體、執行緒數目和已開啟的檔案描述符

如何啟用 Java SDK 指標產生

您需要新增下列 Maven 相依性,才能讓 SDK將指標傳送至 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 指標預設為停用。若要為本機開發環境啟用此功能,請在啟動 時包含指向 AWS 安全憑證檔案的系統屬性JVM。例如:

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

您需要指定憑證檔案的路徑,以便 SDK可以將收集的資料點上傳到 CloudWatch 以供日後分析。

注意

如果您使用 Amazon EC2 執行個體中繼資料服務 AWS 從 Amazon EC2 執行個體存取 ,則不需要指定憑證檔案。在這種情況下,您只需指定:

-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 大約每分鐘一次。上傳指標後,您可以使用 將其視覺化,AWS Management Console並針對記憶體洩漏、檔案描述符洩漏等潛在問題設定警示。

可用的指標類型

預設指標集分為三個主要類別:

AWS 請求指標
  • 涵蓋HTTP請求/回應的延遲、請求數量、例外狀況和重試次數等領域。

    RequestMetric 131111
AWS 服務 指標
  • 包含 AWS 服務特定資料,例如 S3 上傳和下載的輸送量和位元組數。

    ServiceMetric 131111
機器指標
  • 涵蓋執行期環境,包括堆積記憶體、執行緒數目和開啟的檔案描述符。

    MachineMetric 131111

    如果您想要排除機器指標,請excludeMachineMetrics新增至系統屬性:

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

詳細資訊