本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 範本查詢
<a name="cloudwatch-templated-queries"></a>

 您可以在指標查詢中使用變數，而不是硬式編碼詳細資訊，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。

 [範本](templates-and-variables.md#templates) 如需範本功能的簡介和不同類型的範本變數，請參閱 。

## 查詢變數
<a name="cloudwatch-query-variable"></a>

 CloudWatch 資料來源提供下列查詢，您可以在**變數**編輯檢視的**查詢**欄位中指定。您可以使用這些項目來填入變數的選項清單，例如 `region`、`metric names`、 `namespaces`和 `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、metric、 namespace或 的維度值清單dimension\$1key。或者，您可以使用維度filters來取得更具體的結果。 | 
|  ebs\$1volume\$1ids(region, instance\$1id)  |  傳回符合指定 region、 的磁碟區 IDs 清單instance\$1id。 | 
|  ec2\$1instance\$1attribute(region, attribute\$1name, filters)  |  傳回符合指定 region、attribute\$1name、 的屬性清單filters。 | 
|  resource\$1arns(region, resource\$1type, tags)  |  傳回符合指定 region、 resource\$1type和 的 ARNs 清單tags。 | 
|  statistics()  |  傳回所有標準統計資料的清單。 | 

 如需 CloudWatch 提供的指標詳細資訊，請參閱[AWS 發佈 CloudWatch 指標的 服務](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)  |  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)  |  Elastic Load Balancing  | 
|  resource\$1arns(eu-west-1,ec2:instance,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1)  |  Amazon EC2  |