截至 2024 年 7 月 31 日, AWS SDK for Java 1.x 已進入維護模式,並將end-of-support
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
啟用 的指標 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
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請求/回應的延遲、請求數量、例外狀況和重試次數等領域。
-
- AWS 服務 指標
-
-
包含 AWS 服務特定資料,例如 S3 上傳和下載的輸送量和位元組數。
-
- 機器指標
-
-
涵蓋執行期環境,包括堆積記憶體、執行緒數目和開啟的檔案描述符。
如果您想要排除機器指標,請
excludeMachineMetrics
新增至系統屬性:-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,excludeMachineMetrics
-
詳細資訊
-
如需預先定義核心指標類型的完整清單,請參閱 amazonaws/metrics 套件摘要。
-
了解如何 CloudWatch 使用 範例 AWS SDK for Java 中的 CloudWatch 使用 AWS SDK for Java。
-
進一步了解如何調整 AWS SDK for Java 以改善復原能力
部落格文章的效能調校。