Enabling Metrics for the AWS SDK for Java

原創

2020-05-30 18:44

譯文↓↓↓

用於Java的AWS開發工具包可以使用CloudWatch生成可視化和監控指標來衡量如下內容：

·訪問AWS時應用程序的性能

·與AWS一起使用時JVM的性能

·運行環境的詳細信息，如堆內存、線程數以及打開的文件描述符

如何啓動SDK生成指標

SDK在默認情況下是不啓用的。要在本地開發環境中啓用它，需要在啓動JVM時包含一個指向AWS安全憑證文件的系統屬性。如下所示：

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

您需要指定憑證文件的路徑，以便SDK可以上傳數據點到CloudWatch供以後分析。

注意

如果使用EC2實例的元數據服務從EC2訪問AWS，則不需要指定憑證文件(credential file)。這種情況下，只需指定如下信息：

-Dcom.amazonaws.sdk.enableDefaultMetrics

所有捕捉到的指標位於命名空間AWSSDK/Java下，並且會上傳到CloudWatch的默認地區(us-east-1)。要改變地區，請在系統屬性中使用cloudwatchRegion指定。例如，將CloudWatch地區設置爲us-west-2，方式如下：

-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/
aws.properties,cloudwatchRegion=us-west-2

一旦啓用，每當由SDK向AWS發出服務請求時，指標數據點將會生成，排隊進行統計總結，每分鐘約一次的頻率異步上傳到CloudWatch。一旦指標被上傳，您可以通過AWS管理控制檯查看並對潛在問題設置警報，如內存泄漏、文件描述符泄露等等。

可用指標類型

默認指標設置被分成三種主要類型：

① AWS請求指標

涵蓋如HTTP請求/響應的延遲，請求數量，異常與重試。

② AWS服務指標

包括AWS特定服務的數據，例如S3上傳和下載的吞吐量與字節數。

③ 機器指標

涵蓋運行時環境，包括堆內存、線程數以及打開的文件描述符。

如果不想包含機器指標，請在系統屬性中添加excludeMachineMetrics:

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