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

# PromQL을 사용하여 Amazon CloudWatch 지표 쿼리
<a name="cloudwatch-promql"></a>

Amazon CloudWatch PromQL 엔드포인트를 가리키는 Amazon Managed Service for Prometheus 데이터 소스를 구성하여 PromQL을 사용하여 Amazon CloudWatch 지표를 쿼리할 수 있습니다. 이 접근 방식을 사용하면 PromQL 구문을 사용하여 OpenTelemetry Protocol(OTLP)을 통해 CloudWatch에 수집된 지표를 쿼리할 수 있습니다.

AWS 리소스 보강은 `aws_account_id`, `aws_region`및 리소스 태그와 같은 레이블을 지표에 자동으로 추가합니다. 이러한 레이블은 PromQL 쿼리에서 필터링 및 집계에 사용할 수 있습니다.

CloudWatch PromQL 데이터 소스를 구성하기 전에 다음 요구 사항을 확인합니다.
+ [CloudWatch 수집의 OpenTelemetry 지표](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OpenTelemetry-Sections.html)는 CloudWatch 계정에서 활성화됩니다.
+ Amazon Managed Grafana 워크스페이스 버전 12.4 이상.
+ Amazon Managed Service for Prometheus 플러그인 버전 3.0.0 이상.
+ `cloudwatch:GetMetricData` 및에 대한 IAM 권한`cloudwatch:ListMetrics`.

**CloudWatch PromQL 데이터 소스를 구성하려면**

1. Amazon Managed Grafana 워크스페이스의 탐색 창에서 **연결을** 선택한 다음 **데이터 소스를** 선택합니다.

1. **데이터 소스 추가**를 선택한 다음 **Amazon Managed Service for Prometheus**를 선택합니다.

1. **Prometheus 서버 URL**에 리전의 CloudWatch PromQL 엔드포인트를 입력합니다`https://monitoring.{{region}}.amazonaws.com`.

1. **인증**에서 인증 방법으로 **SigV4**를 선택합니다.

1. **SigV4 인증 세부 정보의** **서비스에**를 입력합니다**monitoring**.

1. **저장 및 테스트를** 선택하여 연결을 확인합니다.

데이터 소스를 저장한 후 탐색 및 대시보드에서 PromQL 쿼리를 사용하여 OTLP를 통해 수집된 CloudWatch 지표를 쿼리할 수 있습니다.

![필터로 사용할 수 있는 보강된 AWS 레이블이 있는 컨테이너 CPU 사용률에 대한 PromQL 쿼리를 보여주는 Amazon Managed Grafana 탐색 보기](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/images/grafana-cloudwatch-promql.png)


Amazon CloudWatch의 OpenTelemetry 지표 수집 및 PromQL 쿼리에 대한 자세한 내용은 AWS 클라우드 운영 블로그의 [ Amazon CloudWatch에서 OpenTelemetry 및 PromQL 지원 소개](https://aws.amazon.com/blogs/mt/introducing-opentelemetry-promql-support-in-amazon-cloudwatch/)를 참조하세요.