翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon CloudSearch ドメインのモニタリング
AWS マネジメントコンソールを使用すると、検索ドメインのステータスと設定を簡単にモニタリングし、Amazon CloudSearch の使用状況を表示できます。 AWS CLI および AWS SDKs を使用して、特定のドメインに関する設定情報を取得することもできます。
**Topics**
+ [Amazon CloudSearch ドメインに関する情報の取得](getting-domain-info.md)
+ [Amazon CloudWatch による Amazon CloudSearch ドメインのモニターリング](cloudwatch-monitoring.md)
+ [を使用した Amazon CloudSearch 設定 API コールのログ記録 AWS CloudTrail](logging-config-api-calls.md)
+ [Amazon CloudSearch の使用状況と料金の追跡](tracking-usage.md)
# Amazon CloudSearch ドメインに関する情報の取得
各検索ドメインについて、以下の情報を取得できます。
+ **ドメイン名** — ドメインの名前。
+ **ARN** — ドメインの Amazon リソースネーム (ARN)。
+ **ドキュメントエンドポイント** — ドキュメントの更新を送信するために使用できるエンドポイント。
+ **検索エンドポイント** — 検索リクエストを送信するために使用できるエンドポイント。
+ **検索可能ドキュメント** — インデックスが作成されたドキュメントの数。
+ **アクセスポリシー** — ドメインのドキュメントエンドポイントおよび検索エンドポイントについて設定されたアクセスポリシー。
+ **分析スキーム** — ドメインのインデックスフィールドに適用できるテキスト分析スキーム。
+ **インデックスフィールド** — 設定された各インデックスフィールドの名前と型。
+ **式** — 検索結果をソートするために使用できる式。
+ **サジェスタ** — 不完全なクエリについて候補を取得するために使用できるサジェスタ。
ドメインが最初に作成されたときには、ドメインのステータスにはドメインが現在アクティブ化中であり、その他の情報は使用できないことが示されます。ドメインのドキュメントエンドポイントと検索エンドポイントが利用可能になると、ドメインのステータスには、データの追加や検索リクエストの送信に使用できるエンドポイントのアドレスが表示されます。インデックス作成のためのデータを送信していない場合、検索可能なドキュメントの数は 0 です。
[Amazon CloudSearch console](#getting-domain-info-console) によってドメインに関するすべての情報を表示できます。`aws cloudsearch describe-domains` コマンドまたは AWS SDK を使用する場合、ドメインの ARN は、ドメインのアクセスポリシー内に示されます。
検索可能ドキュメントの数を取得するには、コンソールを使用するか、`matchall` リクエストをドメインの検索エンドポイントに送信します。
```
q=matchall&q.parser=structured&size=0
```
**Topics**
+ [Amazon CloudSearch console](#getting-domain-info-console)
+ [を使用した Amazon CloudSearch ドメイン情報の取得 AWS CLI](#getting-domain-info-clt)
+ [DescribeDomains](#getting-domain-info-sdk)
## Amazon CloudSearch コンソールを使用したドメイン情報の取得
Amazon CloudSearch コンソールを使用して、お客様のすべてのドメインに関する情報を表示できます。コンソールのダッシュボードには、作成したドキュメントの概要 (ドメイン名、ステータス、検索可能ドキュメントの数など) が表示されます。最新の情報を使ってテーブルを更新するには、ページ上部の **[Refresh]** (更新) ボタンをクリックします。
ドメインは 5 つの状態のいずれかになります。
+ **ロード中** — ドメインは作成されたばかりであり、初期化中です。ドキュメントのアップロードを開始する前に、ドメインのステータスが PROCESSING、NEEDS INDEXING、または ACTIVE に変わるまで待つ必要があります。
+ **アクティブ** — ドメインは実行中であり、設定されたすべてのフィールドについてインデックスが作成されました。
+ **インデックス作成が必要** — インデックスの再構築を必要とするドメインの設定に変更を加えました。ドメインを検索する場合、これらの変更は結果に反映されません。変更が完了したら、**[アクション]**、**[インデックス作成を実行]** を選択してインデックスを再構築します。
+ **処理中** — 設定の変更をドメインに適用しています。ドメインを検索する場合、最新の設定の変更が結果に反映されない可能性があります。
+ **削除中** — ドメインとその内容を削除することを選択した場合、ドメインとそのすべてのリソースは削除中になります。削除が完了すると、そのドメインはドメインのリストから削除されます。
Amazon CloudSearch ダッシュボードから、次の操作を実行できます。
+ 検索ドメインのステータスを表示する
+ 特定のドメイン向けダッシュボードにアクセスする
+ Amazon CloudSearch ドキュメントやその他のリソースにアクセスする
**特定のドメインに関する詳細情報を表示するには**
1. Amazon CloudSearch コンソール ([https://console.aws.amazon.com/cloudsearch/home](https://console.aws.amazon.com/cloudsearch/home)) を開きます。
1. 左側のナビゲーションペインから **[ドメイン]** を選択します。
ドメインダッシュボードには、選択されたドメインのステータスの概要が表示されます。ドメインダッシュボードから、次の操作を実行できます。
+ ドメインのステータスを表示する
+ ドキュメントをドメインにアップロードする
+ ドメインを検索する
+ ドメインの設定ページにアクセスする
+ ドメインの削除
## を使用した Amazon CloudSearch ドメイン情報の取得 AWS CLI
検索ドメインのステータスを取得するには、`aws cloudsearch describe-domains` コマンドを使用します。ドメインに設定されたアクセスポリシー、可用性オプション、スケーリングオプションなどの特定の情報を取得するには、オプションごとに個別の `describe` コマンドを使用します。のインストールとセットアップの詳細については AWS CLI、[AWS Command Line Interface 「 ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)」を参照してください。
**ドメインのステータス情報を取得するには**
+ すべてのドメインに関する情報を取得するには、`aws cloudsearch describe-domains` コマンドを実行します。特定のドメインに関する情報を取得するには、`--domain-names` オプションを使用して目的のドメインを指定します。例えば、次のリクエストは、`movies` ドメインのステータスを取得します。
```
aws cloudsearch describe-domains --domain-names movies
{
"DomainStatusList": [
{
"SearchInstanceType": "search.small",
"DomainId": "965407640801/movies",
"Created": true,
"Deleted": false,
"SearchInstanceCount": 1,
"DomainName": "movies",
"SearchService": {
"Endpoint": "search-movies-m4fcjhuxgj6i76smhyiz7pfxsu.us-east-1.cloudsearch.amazonaws.com"
},
"RequiresIndexDocuments": false,
"Processing": true,
"DocService": {
"Endpoint": "doc-movies-m4fcjhuxgj6i76smhyiz7pfxsu.us-east-1.cloudsearch.amazonaws.com"
},
"ARN": "arn:aws:cloudsearch:us-east-1:965407640801:domain/movies",
"SearchPartitionCount": 1
}
]
}
```
`describe-domains` コマンドは、ドメインの検索可能ドキュメント数を返しません。検索可能ドキュメントの数を取得するには、コンソールを使用するか、`matchall` リクエストをドメインの検索エンドポイントに送信します。
```
q=matchall&q.parser=structured&size=0
```
**ドメインに設定された分析スキームを取得するには**
+ `aws cloudsearch describe-analysis-schemes` コマンドを実行します。例えば、次のリクエストは、`movies` ドメインに設定された分析スキームを取得します。
```
aws cloudsearch describe-analysis-schemes --domain-name movies
{
"AnalysisSchemes": [
{
"Status": {
"PendingDeletion": false,
"State": "Active",
"CreationDate": "2014-03-28T19:27:30Z",
"UpdateVersion": 31,
"UpdateDate": "2014-03-28T19:27:30Z"
},
"Options": {
"AnalysisSchemeLanguage": "en",
"AnalysisSchemeName": "samplescheme",
"AnalysisOptions": {
"AlgorithmicStemming": "none",
"Synonyms": "{\"aliases\":{\"youth\":[\"young adult\"]},\"groups\":[[\"tool box\",\"toolbox\"],[\"band saw\",\"bandsaw\"],[\"drill press\",\"drillpress\"]]}",
"StemmingDictionary": "{}",
"Stopwords": "[]"
}
}
}
]
}
```
**ドメインに設定された可用性オプションを取得するには**
+ `aws cloudsearch describe-availability-options` コマンドを実行します。例えば、次のリクエストは、`movies` ドメインに設定された可用性オプションを取得します。ドメインでマルチ AZ が有効になっている場合、`Options` 値は `true` に設定されています。
```
aws cloudsearch describe-availability-options --domain-name movies
{
"AvailabilityOptions": {
"Status": {
"PendingDeletion": false,
"State": "Processing",
"CreationDate": "2014-04-30T20:42:57Z",
"UpdateVersion": 13,
"UpdateDate": "2014-05-01T00:17:45Z"
},
"Options": true
}
}
```
**ドメインに設定された式を取得するには**
+ `aws cloudsearch describe-expressions` コマンドを実行します。例えば、次のリクエストは、`movies` ドメインに設定された式を取得します。
```
aws cloudsearch describe-expressions --domain-name movies
{
"Expression": {
"Status": {
"PendingDeletion": false,
"State": "Processing",
"CreationDate": "2014-05-01T01:15:18Z",
"UpdateVersion": 52,
"UpdateDate": "2014-05-01T01:15:18Z"
},
"Options": {
"ExpressionName": "popularhits",
"ExpressionValue": "((0.3*popularity)/10.0)+(0.7* _score)"
}
}
}
```
## AWS SDK を使用したドメイン情報の取得
AWS SDK では (Android および iOS SDK を除く)、`DescribeDomains` も含めて、 設定 API で定義されたすべての Amazon CloudSearch アクションがサポートされています。AWS SDK のインストールと使用の詳細については、[「AWS Software Development Kits」](https://aws.amazon.com/code)(AWS ソフトウェアデベロップメントキット) を参照してください。
`DescribeDomains` アクションは、ドメインの検索可能ドキュメント数を返しません。検索可能ドキュメントの数を取得するには、コンソールを使用するか、`matchall` リクエストをドメインの検索エンドポイントに送信します。
```
q=matchall&q.parser=structured&size=0
```
# Amazon CloudWatch による Amazon CloudSearch ドメインのモニターリング
パフォーマンス統計を収集、分析できるように、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 メトリクス
`AWS/CloudSearch` 名前空間には、次のメトリクスが含まれます。
| メトリクス | 説明 |
| --- | --- |
| `SuccessfulRequests` | 検索インスタンスによって正常に処理された検索リクエストの数。 単位: カウント 有効な統計: 最大、合計 |
| `SearchableDocuments` | ドメインの検索インデックス内の検索可能ドキュメントの数。 単位: カウント 有効な統計: 最大 |
| `IndexUtilization` | 使用された検索インスタンスのインデックス容量の割合。最大値は、使用されているドメインのインデックス容量の割合を示します。 単位: パーセント 有効な統計: 平均、最小、最大 |
| `Partitions` | インデックスが分散されるパーティションの数。 単位: カウント 有効な統計: 平均、最小、最大 |
## Amazon CloudSearch メトリクスのディメンション
Amazon CloudSearch は、ClientId ディメンションとDomainName ディメンションを CloudWatch に送信します。
| ディメンション | 説明 |
| --- | --- |
| `ClientId` | AWS アカウント ID。 |
| `DomainName` | 検索ドメインの名前。 |
## Amazon CloudSearch の SDK for Java メトリクスの生成
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 メトリクスの表示
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. ドメイン名をクリックし、**[モニタリング]** タブに移動します。
# を使用した Amazon CloudSearch 設定 API コールのログ記録 AWS CloudTrail
Amazon CloudSearch は AWS CloudTrail、Amazon CloudSearch のユーザー、ロール、または のサービスによって実行されたアクションを記録する AWS サービスである と統合されます。CloudTrail は、Amazon CloudSearch のすべての設定 API コールをイベントとしてキャプチャします。
**注記**
CloudTrail は、[ドキュメントサービス API](document-service-api.md) や[検索 API](search-api.md) ではなく、`CreateDomain` や `UpdateServiceAccessPolicies` などの[設定 API](configuration-api.md) への呼び出しのみをキャプチャします。
キャプチャされる呼び出しには、Amazon CloudSearch コンソール、CLI、または SDK からの呼び出しが含まれます 追跡を作成する場合は、Amazon CloudSearch のイベントなど、Amazon S3 バケットへの CloudTrail イベントの継続的な配信を有効にすることができます。追跡を設定しない場合でも、CloudTrail コンソールの **[Event history]** (イベント履歴) で最新のイベントを表示できます。CloudTrail で収集された情報を使用して、Amazon CloudSearch に対するリクエスト、リクエスト元の IP アドレス、リクエスト者、リクエスト日時などの詳細を確認できます。
CloudTrail の詳細については、 [「AWS CloudTrail ユーザーガイド」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)を参照してください。
## CloudTrail の Amazon CloudSearch 情報
CloudTrail は、 AWS アカウントの作成時にアカウントで有効になります。Amazon CloudSearch でアクティビティが発生すると、そのアクティビティはイベント**履歴**の他の AWS サービスイベントとともに CloudTrail イベントに記録されます。最近のイベントは、 AWS アカウントで表示、検索、ダウンロードできます。詳細については、[CloudTrail イベント履歴でのイベントの表示](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)を参照してください。
Amazon CloudSearch のイベントなど、 AWS アカウント内のイベントの継続的な記録については、証跡を作成します。追跡により、CloudTrail はログファイルを Simple Storage Service (Amazon S3) バケットに配信できます。**デフォルトでは、コンソールで作成した証跡がすべての AWS リージョンに適用されます。証跡は、 AWS パーティション内のすべてのリージョンからのイベントをログに記録し、指定した Amazon S3 バケットにログファイルを配信します。さらに、CloudTrail ログで収集されたイベントデータをさらに分析して処理するように他の AWS サービスを設定できます。詳細については、次を参照してください:
+ [証跡の作成のための概要](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail がサポートするサービスと統合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [CloudTrail 用 Amazon SNS 通知の構成](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [「複数のリージョンから CloudTrail ログファイルを受け取る」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)および[「複数のアカウントから CloudTrail ログファイルを受け取る」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
すべての Amazon CloudSearch 設定 API アクションは CloudTrail によって記録され、[Amazon CloudSearch の設定 API リファレンス](configuration-api.md) に記載されます。
各イベントまたはログエントリには、リクエストの生成者に関する情報が含まれます。アイデンティティ情報は、以下を判別するのに役立ちます。
+ リクエストがルートまたは AWS Identity and Access Management (IAM) ユーザー認証情報を使用して行われたかどうか。
+ リクエストがロールまたはフェデレーションユーザーのテンポラリなセキュリティ認証情報を使用して行われたかどうか。
+ リクエストが別の AWS サービスによって行われたかどうか。
詳細については、「[CloudTrail userIdentity 要素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)」を参照してください。
## Amazon CloudSearch ログファイルエントリについて
「トレイル」は、指定した Amazon S3 バケットにイベントをログファイルとして配信するように設定できます。CloudTrail のログファイルは、単一か複数のログエントリを含みます。イベントは、任意の出典からの単一のリクエストを表し、リクエストされたアクション、アクションの日時、リクエストパラメータなどに関する情報が含まれます。CloudTrail ログファイルは、パブリック API コールの順序付けられたスタックトレースではないため、特定の順序では表示されません。
以下の例は、`CreateDomain` アクションを示す CloudTrail ログエントリです。
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::123456789012:user/test-user",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "test-user",
"sessionContext": {
"attributes": {
"mfaAuthenticated": "false",
"creationDate": "2018-08-21T23:31:33Z"
}
},
"invokedBy": "signin.amazonaws.com"
},
"eventTime": "2018-08-21T23:32:15Z",
"eventSource": "cloudsearch.amazonaws.com",
"eventName": "CreateDomain",
"awsRegion": "us-west-1",
"sourceIPAddress": "123.123.123.123",
"userAgent": "signin.amazonaws.com",
"requestParameters": {
"domainName": "test-domain"
},
"responseElements": {
"domainStatus": {
"aRN": "arn:aws:cloudsearch:us-west-1:123456789012:domain/test-domain",
"searchInstanceCount": 0,
"docService": {},
"requiresIndexDocuments": false,
"deleted": false,
"searchService": {},
"domainId": "123456789012/test-domain",
"processing": false,
"created": true,
"searchPartitionCount": 0,
"domainName": "test-domain"
}
},
"requestID": "12345678-1234-1234-1234-987654321098",
"eventID": "87654321-4321-4321-4321-987654321098",
"eventType": "AwsApiCall",
"recipientAccountId": "123456789012"
}
```
# Amazon CloudSearch の使用状況と料金の追跡
AWS アカウントアクティビティページを使用して、Amazon CloudSearch の使用状況と料金を追跡できます。
**Amazon CloudSearch の使用状況の情報を取得するには**
1. [aws.amazon.com](https://aws.amazon.com/) に移動し、**[マイアカウント]**、**[請求とコスト管理]** を選択します。
1. **[Cost & Usage Reports]** を選択し、**AWS [使用状況レポート]** を選択します。
1. [サービス] ドロップダウンから **[Amazon CloudSearch]** を選択します。
1. レポートに含める情報を指定し、ダウンロードするデータ形式の [ダウンロード] ボタンをクリックします。レポートは XML 形式または CSV 形式でダウンロードできます。