기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 템플릿 기반 쿼리
<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에서 제공하는 지표에 대한 자세한 내용은 [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\_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  |