本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 模板化查询
<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`。

 您可以在查询中指定 `default` 代替 `region`，以使用数据来源中配置的默认区域。


|  Name  |  说明  | 
| --- | --- | 
|  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)  |  返回与指定值 IDs region匹配的音量列表instance\$1id。 | 
|  ec2\$1instance\$1attribute(region, attribute\$1name, filters)  |  返回与指定的 region、attribute\$1name、filters 匹配的属性列表。 | 
|  resource\$1arns(region, resource\$1type, tags)  |  返回与指定regionresource\$1type、和 ARNs 匹配的列表tags。 | 
|  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 服务的资源列表的维度查询示例。


|  Query  |  服务  | 
| --- | --- | 
|  dimension\$1values(us-east-1,AWS/ELB,RequestCount,LoadBalancerName)  |  Elastic Load Balancing  | 
|  dimension\$1values(us-east-1,AWS/ElastiCache,CPUUtilization,CacheClusterId)  |  亚马逊 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)  |  Elastic Load Balancing  | 
|  resource\$1arns(eu-west-1,ec2:instance,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1)  |  Amazon EC2  |