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

# テンプレート化されたクエリ
<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\$1keys(namespace)  |  名前空間のディメンションキーのリストを返します。 | 
|  dimension\$1values(region, namespace, metric, dimension\$1key, [filters])  |  指定された region、namespace、metric または dimension\$1key に一致するディメンション値のリストを返します。または、ディメンション filters を使用してより具体的な結果を取得することもできます。 | 
|  ebs\$1volume\$1ids(region, instance\$1id)  |  指定された region、instance\$1id に一致するボリューム ID のリストを返します。 | 
|  ec2\$1instance\$1attribute(region, attribute\$1name, filters)  |  指定された region、attribute\$1name、filters に一致する属性のリストを返します。 | 
|  resource\$1arns(region, resource\$1type, tags)  |  指定された region、resource\$1type、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\$1values(us-east-1,AWS/ELB,RequestCount,LoadBalancerName)  |  エラスティックロードバランシング  | 
|  dimension\$1values(us-east-1,AWS/ElastiCache,CPUUtilization,CacheClusterId)  |  Amazon ElastiCache  | 
|  dimension\$1values(us-east-1,AWS/Redshift,CPUUtilization,ClusterIdentifier)  |  Amazon Redshift  | 
|  dimension\$1values(us-east-1,AWS/RDS,CPUUtilization,DBInstanceIdentifier)  |  Amazon RDS  | 
|  dimension\$1values(us-east-1,AWS/S3,BucketSizeBytes,BucketName)  |  Amazon Simple Storage Service (Amazon S3)  | 
|  dimension\$1values(us-east-1,CWAgent,disk\$1used\$1percent,device,\$1"InstanceId":"\$1instance\$1id"\$1)  |  CloudWatch エージェント  | 
|  resource\$1arns(eu-west-1,elasticloadbalancing:loadbalancer,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1)  |  エラスティックロードバランシング  | 
|  resource\$1arns(eu-west-1,ec2:instance,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1)  |  Amazon EC2  |