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

# テンプレート化されたクエリ
<a name="cloudwatch-templated-queries"></a>

 メトリクスクエリにサーバー、アプリケーション、センサー名などの詳細をハードコーディングする代わりに、変数を使用することができます。変数は、ダッシュボードの上部にドロップダウン選択ボックスとして表示されます。これらのドロップダウンボックスを使用して、ダッシュボードに表示されるデータを変更できます。

 テンプレート作成とさまざまな種類のテンプレート変数の概要については、「[テンプレート](templates-and-variables.md#templates)」を参照してください。

## クエリ変数
<a name="cloudwatch-query-variable"></a>

 CloudWatch データソースでは、以下の**クエリ**を**変数**編集ビューのクエリフィールドで指定することができます。これらを使用して、変数のオプションリストに `region`、`namespaces`、`metric names`、`dimension keys/values` などの項目を埋めることができます。

 クエリのデータソースに設定されたデフォルトのリージョンを使用するように、`region` の代わりに、`default`を指定することができます。


|  名前  |  説明  | 
| --- | --- | 
|  regions()  |  すべての AWS リージョンのリストを返します。 | 
|  namespaces()  |  CloudWatch がサポートする名前空間のリストを返します。 | 
|  metrics(namespace, [region])  |  名前空間内のメトリクスのリストを返します。(カスタムメトリクスにリージョンを指定するか "default" を使用します。)  | 
|  dimension\_keys(namespace)  |  名前空間のディメンションキーのリストを返します。 | 
|  dimension\_values(region, namespace, metric, dimension\_key, [filters])  |  指定された region、namespace、metric または dimension\_key に一致するディメンション値のリストを返します。または、ディメンション filters を使用してより具体的な結果を取得することもできます。 | 
|  ebs\_volume\_ids(region, instance\_id)  |  指定された region、instance\_id に一致するボリューム ID のリストを返します。 | 
|  ec2\_instance\_attribute(region, attribute\_name, filters)  |  指定された region、attribute\_name、filters に一致する属性のリストを返します。 | 
|  resource\_arns(region, resource\_type, tags)  |  指定された region、resource\_type、tags に一致する ARN のリストを返します。 | 
|  statistics()  |  すべての標準統計のリストを返します。 | 

 CloudWatch が提供するメトリクスの詳細については、「[CloudWatch メトリクスを発行するAWS サービス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html)」を参照してください。

### テンプレート化されたクエリの例
<a name="cloudwatch-examples-templated-queries"></a>

 次の表は、個々の AWS サービスのリソースのリストを返すディメンションクエリの例を示しています。


|  クエリ  |  サービス  | 
| --- | --- | 
|  dimension\_values(us-east-1,AWS/ELB,RequestCount,LoadBalancerName)  |  Elastic Load Balancing  | 
|  dimension\_values(us-east-1,AWS/ElastiCache,CPUUtilization,CacheClusterId)  |  Amazon ElastiCache  | 
|  dimension\_values(us-east-1,AWS/Redshift,CPUUtilization,ClusterIdentifier)  |  Amazon Redshift  | 
|  dimension\_values(us-east-1,AWS/RDS,CPUUtilization,DBInstanceIdentifier)  |  Amazon RDS  | 
|  dimension\_values(us-east-1,AWS/S3,BucketSizeBytes,BucketName)  |  Amazon Simple Storage Service (Amazon S3)  | 
|  dimension\_values(us-east-1,CWAgent,disk\_used\_percent,device,{"InstanceId":"$instance\_id"})  |  CloudWatch エージェント  | 
|  resource\_arns(eu-west-1,elasticloadbalancing:loadbalancer,{"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]})  |  Elastic Load Balancing  | 
|  resource\_arns(eu-west-1,ec2:instance,{"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]})  |  Amazon EC2  |