Amazon CloudSearch
Developer Guide (API Version 2013-01-01)

Monitoring an Amazon CloudSearch Domain with Amazon CloudWatch

Amazon CloudSearch automatically sends metrics to Amazon CloudWatch so that you can gather and analyze performance statistics. You can monitor these metrics by using the Amazon CloudSearch console, or by using the CloudWatch console, AWS CLI, or AWS SDKs. Each of your domain's search instances sends metrics to CloudWatch at one-minute intervals. The metrics are archived for two weeks; after that period, the data is discarded.

There is no charge for the Amazon CloudSearch metrics that are reported through CloudWatch. If you set alarms on the metrics, you will be billed at standard CloudWatch rates. You can use the metrics in all regions supported by Amazon CloudSearch.

Not all statistics, such as Average or Sum, are applicable for every metric. However, all of these values are available through the Amazon CloudSearch console, or by using the CloudWatch console, AWS CLI, or AWS SDKs for all metrics. In the following table, each metric has a list of Valid Statistics that is applicable to that metric.

Amazon CloudSearch Metrics

The AWS/CloudSearch namespace includes the following metrics.

Metric Description


The number of search requests successfully processed by a search instance.

Units: Count

Valid statistics: Maximum, Sum


The number of searchable documents in the domain's search index.

Units: Count

Valid statistics: Maximum


The percentage of the search instance's index capacity that has been used. The Maximum value indicates the percentage of the domain's index capacity that has been used.

Units: Percent

Valid statistics: Average, Maximum


The number of partitions the index is distributed across.

Units: Count

Valid statistics: Minimum, Maximum

Dimensions for Amazon CloudSearch Metrics

Amazon CloudSearch sends the ClientId and DomainName dimensions to CloudWatch.

Dimension Description


The AWS account ID.


The name of the search domain.

Viewing CloudWatch Metrics for an Amazon CloudSearch Domain

The Amazon CloudSearch console graphs the metrics reported to CloudWatch. You can also access the metrics through the CloudWatch console, AWS CLI, and AWS SDKs. For more information, see Viewing, Graphing, and Publishing Metrics in the Amazon CloudWatch Developer Guide.

To view metrics for a search domain using the Amazon CloudSearch console

  1. Sign in to the AWS Management Console and open the Amazon CloudSearch console at

  2. In the navigation pane, click the name of the domain, and then click the domain's Monitoring link.