# Query Studio에서 PromQL 쿼리 실행(미리 보기)
<a name="CloudWatch-PromQL-QueryStudio"></a>

**참고**  
Query Studio는 현재 추가 비용 없이 미리 보기 기능으로 제공됩니다. 지원되는 리전은 [지원되는 AWS 리전](CloudWatch-PromQL.md#CloudWatch-PromQL-Regions) 섹션을 참조하세요.

Query Studio는 CloudWatch 콘솔의 대화형 쿼리 환경으로, CloudWatch 지표에 대해 PromQL 쿼리를 작성, 실행 및 시각화할 수 있습니다. Query Studio를 사용하여 OTLP 및 AWS 벤딩 지표를 통해 수집된 지표를 탐색하고, 시각화를 생성하고, 경보를 설정하고, CloudWatch 대시보드에 위젯을 추가할 수 있습니다.

CloudWatch API를 사용하여 프로그래밍 방식으로 또는 Query Studio에서 대화형으로 PromQL 쿼리를 실행할 수 있습니다.

## Query Studio에서 PromQL 쿼리 실행
<a name="CloudWatch-PromQL-QueryStudio-RunQuery"></a>

**Query Studio에서 PromQL 쿼리 실행**

1. [CloudWatch 콘솔](https://console.aws.amazon.com/cloudwatch/)을 엽니다.

1. 탐색 창에서 **Query Studio(미리 보기)**를 선택합니다.

1. 쿼리 편집기 도구의 드롭다운 메뉴에서 **PromQL**을 선택합니다.

1. **빌더** 모드를 사용하여 지표 이름, 레이블 및 집계 함수를 찾아보고 선택합니다.

1. 또는 **편집기** 모드를 통해 PromQL 쿼리(예: `{"http.server.active_requests"}`)를 입력합니다.

1. (선택 사항) 페이지 상단의 시간 간격 선택기를 사용하여 시간 범위를 조정합니다.

1. **실행**을 선택하여 쿼리를 실행하고 결과를 확인합니다.

Query Studio는 결과를 시계열 그래프로 표시합니다. 그래프 보기와 테이블 보기 간에 전환하여 데이터를 분석할 수 있습니다.

## Query Studio에서 경보 생성
<a name="CloudWatch-PromQL-QueryStudio-Alarms"></a>

단일 시계열을 반환하는 PromQL 쿼리를 실행한 후 Query Studio에서 직접 CloudWatch 경보를 생성할 수 있습니다. 작업 메뉴에서 **경보 생성**을 선택하여 쿼리 결과를 기반으로 경보 임계값, 평가 기간 및 알림 작업을 구성합니다. 자세한 내용은 [경보에서 PromQL 사용](CloudWatch-PromQL-Alarms.md) 섹션을 참조하세요.

## 대시보드에 시각화 추가
<a name="CloudWatch-PromQL-QueryStudio-Dashboards"></a>

모든 Query Studio 시각화를 CloudWatch 대시보드에 추가할 수 있습니다. 쿼리를 실행하고 결과를 확인한 후 **대시보드에 추가**를 선택하면 시각화를 대시보드 위젯으로 저장합니다. 위젯은 대시보드의 새로 고침 간격에 따라 PromQL 쿼리를 계속 실행하여 대시보드를 최신 상태로 유지합니다.