適用於 Java 的 AWS SDK 1.x 已於 2025 年 12 月 31 日end-of-support。我們建議您遷移至 [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)，以繼續接收新功能、可用性改善和安全性更新。

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

# 啟用 的指標 適用於 Java 的 AWS SDK
<a name="generating-sdk-metrics"></a>

 適用於 Java 的 AWS SDK 可以使用 [Amazon CloudWatch](https://aws.amazon.com/cloudwatch/) 產生視覺化和監控的指標，以測量：
+ 存取應用程式的效能 AWS 
+ 搭配 使用時，JVMs的效能 AWS 
+ 執行時間環境詳細資訊，例如堆積記憶體、執行緒數目和開啟的檔案描述項

## 如何啟用 Java SDK 指標產生
<a name="how-to-enable-sdk-java-metric-generation"></a>

您需要新增下列 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>
```

 \$1將版本編號取代為 [Maven Central](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) 提供的最新版本 SDK。

適用於 Java 的 AWS SDK 指標*預設為停用*。若要為本機開發環境啟用此功能，請在啟動 JVM 時包含指向 AWS 安全登入資料檔案的系統屬性。例如：

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

您需要指定登入資料檔案的路徑，讓 SDK 可以將收集的資料點上傳到 CloudWatch 以供日後分析。

**注意**  
如果您使用 Amazon EC2 執行個體中繼資料服務 AWS 從 Amazon EC2 執行個體存取 ，則不需要指定登入資料檔案。在這種情況下，您只需指定：  

```
-Dcom.amazonaws.sdk.enableDefaultMetrics
```

擷取的所有指標 適用於 Java 的 AWS SDK 都位於命名空間 **AWSSDK/Java** 下，並上傳至 CloudWatch 預設區域 (*us-east-1*)。若要變更區域，請使用系統屬性中的 `cloudwatchRegion` 屬性來指定區域。例如，若要將 CloudWatch 區域設定為 *us-east-1*，請使用：

```
-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,cloudwatchRegion={region_api_default}
```

啟用此功能後，每次 AWS 有來自 的服務請求時 適用於 Java 的 AWS SDK，都會產生指標資料點、排入統計摘要佇列，並以非同步方式上傳至 CloudWatch，大約每分鐘一次。上傳指標後，您可以使用 將其視覺化，[AWS 管理主控台](https://console.aws.amazon.com/console/home)並針對記憶體洩漏、檔案描述項洩漏等潛在問題設定警示。

## 可用的指標類型
<a name="available-metric-types"></a>

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

 AWS 請求指標  
+ 涵蓋 HTTP 請求/回應的延遲、請求數量、例外狀況和重試等領域。  
![\[RequestMetric 131111\]](http://docs.aws.amazon.com/zh_tw/sdk-for-java/v1/developer-guide/images/RequestMetric-131111.png)

 AWS 服務 指標  
+ 包含 AWS 服務特定資料，例如 S3 上傳和下載的輸送量和位元組數。  
![\[ServiceMetric 131111\]](http://docs.aws.amazon.com/zh_tw/sdk-for-java/v1/developer-guide/images/ServiceMetric-131111.png)

機器指標  
+ 涵蓋執行時間環境，包括堆積記憶體、執行緒數目和開啟的檔案描述項。  
![\[MachineMetric 131111\]](http://docs.aws.amazon.com/zh_tw/sdk-for-java/v1/developer-guide/images/MachineMetric-131111.png)

  如果您想要排除機器指標，請將 `excludeMachineMetrics`新增至系統屬性：

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

## 詳細資訊
<a name="more-information"></a>
+ 如需預先定義核心[指標類型的完整清單，請參閱 amazonaws/metrics 套件摘要](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/metrics/package-summary.html)。
+ 了解如何使用 CloudWatch 範例中的 使用 適用於 Java 的 AWS SDK CloudWatch。 [CloudWatch 適用於 Java 的 AWS SDK](examples-cloudwatch.md)
+ 進一步了解[調校 適用於 Java 的 AWS SDK 以改善彈性](https://aws.amazon.com/blogs/developer/tuning-the-aws-sdk-for-java-to-improve-resiliency)部落格文章中的效能調校。