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

# 使用 Amazon CloudWatch 監控 Amazon CloudSearch 網域
<a name="cloudwatch-monitoring"></a>

Amazon CloudSearch 會自動將指標傳送至 Amazon CloudWatch，以便您可以收集和分析效能統計資料。您可以使用 Amazon CloudSearch 主控台，或使用 CloudWatch 主控台、AWS CLI 或 AWS SDKs來監控這些指標。每個網域的搜尋執行個體都會每隔一分鐘將指標傳送至 CloudWatch。指標將封存兩週，之後即會捨棄資料。

透過 CloudWatch 報告的 Amazon CloudSearch 指標不收取費用。 CloudWatch 如果您設定指標的警示，則會按標準 [CloudWatch 費率](https://aws.amazon.com/cloudwatch/pricing/)向您收費。您可以在 Amazon CloudSearch 支援的所有區域中使用指標。

**Topics**
+ [Amazon CloudSearch 指標](#cloudsearch-metrics)
+ [Amazon CloudSearch 指標的維度](#cloudsearch-metric-dimensions)
+ [為 Amazon CloudSearch 產生適用於 Java 的 SDK 指標](#java-sdk-metrics)
+ [檢視 Amazon CloudSearch 網域的 CloudWatch 指標](#viewing-metrics)

並非所有統計數字，例如 *Average* 或 *Sum*，皆適用於所有指標。不過，所有這些值都可以透過 Amazon CloudSearch 主控台，或使用 CloudWatch 主控台、AWS CLI 或 AWS SDKs來取得所有指標。在下表中，每個指標皆有適用於該指標的有效統計資訊列表。

## Amazon CloudSearch 指標
<a name="cloudsearch-metrics"></a>

`AWS/CloudSearch` 命名空間包含下列指標。


| 指標 | Description | 
| --- | --- | 
|  `SuccessfulRequests`  |  搜尋執行個體成功處理的搜尋請求數量。 單位：Count 有效統計資料：Maximum、Sum  | 
|  `SearchableDocuments`  |  網域搜尋索引中可搜尋的文件數量。 單位：Count 有效的統計資訊：上限  | 
|  `IndexUtilization`  |  已使用的搜尋執行個體索引容量百分比。最大值表示已使用的網域索引容量百分比。 單位：百分比 有效統計資料：平均值、最大值  | 
|  `Partitions`  |  索引分配的分割區數量。 單位：Count 有效統計資料：最小值、最大值  | 

## Amazon CloudSearch 指標的維度
<a name="cloudsearch-metric-dimensions"></a>

Amazon CloudSearch 會將 ClientId 和 DomainName 維度傳送至 CloudWatch。


| 維度 | Description | 
| --- | --- | 
| `ClientId` |  AWS 帳戶 ID。  | 
| `DomainName` |  搜尋網域的名稱。  | 

## 為 Amazon CloudSearch 產生適用於 Java 的 SDK 指標
<a name="java-sdk-metrics"></a>

 適用於 Java 的 AWS SDK 可以為您的 Amazon CloudSearch 用戶端產生效能指標，並將其傳送至 CloudWatch 進行視覺化。如需啟用此功能的 Java VM 引數，請參閱《 *適用於 Java 的 AWS SDK 開發人員指南*》中的[啟用適用於 Java 的 AWS 開發套件的指標](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/generating-sdk-metrics.html)。

您可使用以下程式碼測試指標產生情形。此程式碼會建立新的 CloudWatch 用戶端，並執行 2，500 次搜尋。由於開發套件每分鐘只傳送一次指標，長時間執行的用戶端最為適宜。此程式碼係使用[預設登入資料供應者鏈結](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/credentials.html#credentials-default)。

```
import com.amazonaws.client.builder.AwsClientBuilder;
import com.amazonaws.services.cloudsearchdomain.AmazonCloudSearchDomain;
import com.amazonaws.services.cloudsearchdomain.AmazonCloudSearchDomainClientBuilder;
import com.amazonaws.services.cloudsearchdomain.model.SearchRequest;

public class Metrics {

  public static void main(String[] args) {

    String search_endpoint = "https://search-domain-id.us-west-1.cloudsearch.amazonaws.com";
    String region = "us-west-1";

    AwsClientBuilder.EndpointConfiguration endpointConfig = new AwsClientBuilder
        .EndpointConfiguration(search_endpoint, region);
        
    AmazonCloudSearchDomainClientBuilder builder = AmazonCloudSearchDomainClientBuilder
        .standard()
        .withEndpointConfiguration(endpointConfig);
        
    AmazonCloudSearchDomain client = builder.build();
        
    String query;
    SearchRequest request = new SearchRequest();
    com.amazonaws.services.cloudsearchdomain.model.SearchResult test = client.search(request);
                
    for (int i = 0; i < 2500; i++) {
      query = "test";
      request.setQuery(query);
      test = client.search(request);
      System.out.println(test.toString());
    }
  }
}
```

若要驗證 SDK 正在將指標傳送至 CloudWatch，請檢查 CloudWatch 主控台的**指標**頁面，並在**自訂命名空間**區段下尋找 **AWSSDK/Java**。指標可能要過幾分鐘後才會顯示。

## 檢視 Amazon CloudSearch 網域的 CloudWatch 指標
<a name="viewing-metrics"></a>

Amazon CloudSearch 主控台會繪製向 CloudWatch 報告的指標圖表。您也可以透過 [CloudWatch 主控台](https://console.aws.amazon.com/cloudwatch)、AWS CLI 和 AWS SDKs存取指標。如需詳細資訊，請參閱《*Amazon CloudWatch 開發人員指南*》中的[檢視、繪製和發佈指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/working_with_metrics.html)。

**使用 Amazon CloudSearch 主控台檢視搜尋網域的指標**

1. 開啟位於 https：//[https://console.aws.amazon.com/cloudsearch](https://console.aws.amazon.com/cloudsearch) 的 Amazon CloudSearch 主控台。

1. 從左側導覽窗格中選擇**網域**。

1. 按一下網域名稱，然後前往**監控**索引標籤。