翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon CloudWatch による Amazon CloudSearch ドメインのモニターリング
<a name="cloudwatch-monitoring"></a>

パフォーマンス統計を収集、分析できるように、Amazon CloudSearch は Amazon CloudWatch に自動的にメトリクスを送信します。Amazon CloudSearch コンソール、または CloudWatch コンソール、AWS CLI、または AWS SDK を使用して、これらのメトリクスをモニタリングできます。ドメイン内の検索インスタンスはそれぞれ、1 分ごとにメトリクスを CloudWatch に送信します。2 週間分のメトリクスがアーカイブされ、それより古いデータは破棄されます。

CloudWatch を経由して報告される Amazon CloudSearch メトリクスには料金はかかりません。メトリクスにアラームを設定している場合は、[CloudWatch の標準料金](https://aws.amazon.com/cloudwatch/pricing/)が請求されます。メトリクスは Amazon CloudSearch でサポートされているすべてのリージョンで使用できます。

**Topics**
+ [Amazon CloudSearch メトリクス](#cloudsearch-metrics)
+ [Amazon CloudSearch メトリクスのディメンション](#cloudsearch-metric-dimensions)
+ [Amazon CloudSearch の SDK for Java メトリクスの生成](#java-sdk-metrics)
+ [Amazon CloudSearch ドメインの CloudWatch メトリクスの表示](#viewing-metrics)

*Average* や *Sum* など、すべての統計が必ずしも常にすべてのメトリクスに適用可能であるとは限りません。ただし、これらの値はすべて Amazon CloudSearch コンソール経由で利用できます。また、すべてのメトリクスで CloudWatch コンソール、AWS CLI、AWS SDK を使用することによっても利用できます。次の表は、各メトリクスに適用可能な有効な統計のリストを示します。

## Amazon CloudSearch メトリクス
<a name="cloudsearch-metrics"></a>

`AWS/CloudSearch` 名前空間には、次のメトリクスが含まれます。


| メトリクス | 説明 | 
| --- | --- | 
|  `SuccessfulRequests`  |  検索インスタンスによって正常に処理された検索リクエストの数。 単位: カウント 有効な統計: 最大、合計  | 
|  `SearchableDocuments`  |  ドメインの検索インデックス内の検索可能ドキュメントの数。 単位: カウント 有効な統計: 最大  | 
|  `IndexUtilization`  |  使用された検索インスタンスのインデックス容量の割合。最大値は、使用されているドメインのインデックス容量の割合を示します。 単位: パーセント 有効な統計: 平均、最小、最大  | 
|  `Partitions`  |  インデックスが分散されるパーティションの数。 単位: カウント 有効な統計: 平均、最小、最大  | 

## Amazon CloudSearch メトリクスのディメンション
<a name="cloudsearch-metric-dimensions"></a>

Amazon CloudSearch は、ClientId ディメンションとDomainName ディメンションを CloudWatch に送信します。


| ディメンション | 説明 | 
| --- | --- | 
| `ClientId` |  AWS アカウント ID。  | 
| `DomainName` |  検索ドメインの名前。  | 

## Amazon CloudSearch の SDK for Java メトリクスの生成
<a name="java-sdk-metrics"></a>

 AWS SDK for Java は、Amazon CloudSearch クライアントのパフォーマンスメトリクスを生成し、視覚化のために CloudWatch に送信できます。この機能を有効にする Java VM 引数については、*「AWS SDK for Java デベロッパーガイド」*の[「AWS SDK for Java の SDK メトリクスの有効化」](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/generating-sdk-metrics.html)を参照してください。

次のコードを使用してメトリクスの生成をテストできます。このコードは、新しい CloudWatch クライアントを作成し、2,500 件の検索を実行します。SDK は 1 分ごとにしかメトリクスを送信しないため、長期間実行されるクライアントが最適です。このコードは[デフォルトの認証情報プロバイダーチェーン](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 コンソールの **[Metrics]** (メトリクス) ページを開き、**[Custom Namespaces]** (カスタム名前空間) セクションの下にある **[AWSSDK/Java]** を参照してください。このメトリクスは表示までに数分かかることがあります。

## Amazon CloudSearch ドメインの CloudWatch メトリクスの表示
<a name="viewing-metrics"></a>

Amazon CloudSearch コンソールは CloudWatch に報告されるメトリクスをグラフ化します。メトリクスは、CloudWatch [ コンソール](https://console.aws.amazon.com/cloudwatch)、AWS CLI、AWS SDK からアクセスすることもできます。詳細については、*「Amazon CloudWatch デベロッパーガイド」*の[「メトリクスの表示、グラフ化、公開」](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/working_with_metrics.html)を参照してください。

**Amazon CloudSearch コンソールを使用した検索ドメインのメトリクスの表示**

1. Amazon CloudSearch コンソール ([https://console.aws.amazon.com/cloudsearch](https://console.aws.amazon.com/cloudsearch)) を開きます。

1. 左側のナビゲーションペインから **[ドメイン]** を選択します。

1. ドメイン名をクリックし、**[モニタリング]** タブに移動します。