이 문서에서는 Cloud Monitoring에서 Prometheus Query Language(PromQL)를 사용하는 방법을 설명합니다. PromQL은 차트와 대시보드를 만들 수 있도록 측정항목 탐색기 메뉴 기반 인터페이스와 Monitoring 쿼리 언어(MQL) 인터페이스의 대안을 제공합니다.
PromQL을 사용하여 다음 소스에서 Cloud Monitoring 데이터를 쿼리하고 차트로 작성할 수 있습니다.
- Cloud Monitoring 시스템 측정항목 목록에 설명된 측정항목을 작성하는 Google Kubernetes Engine 또는 Compute Engine과 같은 Google Cloud 서비스
- 로그 기반 측정항목 및 Cloud Monitoring 사용자 정의 측정항목과 같은 사용자 정의 측정항목
- Google Cloud의 Prometheus를 위한 완전 관리형 멀티 클라우드 솔루션인 Google Cloud Managed Service for Prometheus. PromQL의 지원을 포함한 관리형 서비스에 대한 자세한 내용은 Google Cloud Managed Service for Prometheus를 참조하세요.
Grafana와 같은 도구를 사용하여 Cloud Monitoring에 수집된 측정항목 데이터를 차트로 표시할 수도 있습니다. 사용 가능한 측정항목에는 측정항목 목록에 설명된 Prometheus용 관리형 서비스 및 Cloud Monitoring 측정항목의 측정항목이 포함됩니다. Prometheus API를 기반으로 Grafana 및 기타 도구를 설정하는 방법은 Grafana에 대한 Prometheus용 관리형 서비스를 참조하세요.
Grafana 대시보드를 Cloud Monitoring으로 가져올 수도 있습니다.
이름 지정 규칙
Prometheus 측정항목 모델과 이름 지정 규칙은 Cloud Monitoring에서 사용하는 것과 다릅니다. PromQL을 사용하여 Monitoring 측정항목 데이터를 쿼리하려면 Cloud Monitoring 이름을 PromQL 호환 이름으로 변환해야 합니다. 이름 지정 규칙은 Cloud Monitoring 측정항목을 PromQL에 매핑을 참조하세요.
Cloud Monitoring에서 PromQL에 액세스
Google Cloud 콘솔의 다음 페이지에 있는 코드 탭에서 PromQL을 사용할 수 있습니다.
- 측정항목 탐색기
- 커스텀 대시보드를 만들 때 차트 추가
편집기 액세스 및 사용 방법은 PromQL 편집기 사용을 참조하세요.
Prometheus 규칙 및 알림
PromQL을 사용하여 Prometheus용 관리형 서비스에서 Prometheus 스타일 알림을 사용하여 Cloud Monitoring의 모든 측정항목에 대한 기록 및 알림 규칙을 만들 수 있습니다. 자세한 내용은 관리형 규칙 평가 및 알림 또는 자체 배포 규칙 평가 및 알림을 참조하세요.
PromQL 학습
PromQL 사용에 대한 기본사항을 학습하려면 오픈소스 문서를 참조하는 것이 좋습니다. 다음은 시작하는 데 도움이 되는 리소스입니다.
PromQL 차이점
Cloud Monitoring용 PromQL은 업스트림 PromQL과 약간 다르게 작동할 수 있습니다. 이러한 차이점 목록은 PromQL 차이점을 참조하세요.