8장. 메트릭 쿼리
메트릭을 쿼리하여 클러스터 구성 요소 및 자체 워크로드가 수행하는 방법에 대한 데이터를 볼 수 있습니다.
8.1. 메트릭 쿼리 정보
OpenShift Container Platform 모니터링 대시보드를 사용하면 Pacemaker에서 표시되는 메트릭을 검사하기 위해 Prometheus Query Language(PromQL) 쿼리를 실행할 수 있습니다. 이 기능을 사용하면 클러스터 상태 및 모니터링 중인 모든 사용자 정의 워크로드에 대한 정보가 제공됩니다.
클러스터 관리자는 모든 핵심 OpenShift Container Platform 및 사용자 정의 프로젝트에 대한 메트릭을 쿼리할 수 있습니다.
개발자는 메트릭을 쿼리할 때 프로젝트 이름을 지정해야 합니다. 선택한 프로젝트의 메트릭을 확인하는 데 필요한 권한이 있어야 합니다.
8.1.1. 클러스터 관리자로서 모든 프로젝트의 메트릭 쿼리
클러스터 관리자 또는 모든 프로젝트에 대한 보기 권한이 있는 사용자로 Metrics UI에서 모든 기본 OpenShift Container Platform 및 사용자 정의 프로젝트에 대한 메트릭에 액세스할 수 있습니다.
사전 요구 사항
-
cluster-admin
클러스터 역할 또는 모든 프로젝트에 대한 보기 권한이 있는 사용자로 클러스터에 액세스할 수 있습니다. -
OpenShift CLI(
oc
)가 설치되어 있습니다.
절차
- OpenShift Container Platform 웹 콘솔에서 관리자 화면을 선택합니다.
-
Observe
Metrics 를 선택합니다. - 커서에 표시기 삽입을 선택하여 사전 정의된 쿼리 목록을 확인합니다.
사용자 정의 쿼리를 생성하려면 표현식 필드에 PromQL(Prometheus Query Language) 쿼리를 추가합니다.
참고PromQL 표현식을 입력하면 드롭다운 목록에 자동 완성 제안이 표시됩니다. 이러한 제안에는 함수, 메트릭, 라벨, 시간 토큰이 있습니다. 키보드 화살표를 사용하여 이러한 제안된 항목 중 하나를 선택한 다음 Enter를 눌러 식에 항목을 추가할 수 있습니다.You can use the keyboard arrows to select one of these suggested items and then press Enter to add the item to your expression. 또한 제안된 항목에 마우스 포인터를 이동하여 해당 항목에 대한 간략한 설명을 볼 수도 있습니다.
- 여러 쿼리를 추가하려면 쿼리 추가를 선택합니다.
- 기존 쿼리를 복제하려면 쿼리 옆에 있는 를 선택한 다음 쿼리 중복 을 선택합니다.
- 쿼리를 삭제하려면 쿼리 옆에 있는 를 선택한 다음 쿼리 삭제를 선택합니다.
- 쿼리 실행을 비활성화하려면 쿼리 옆에 있는 를 선택하고 쿼리 비활성화를 선택합니다.
생성한 쿼리를 실행하려면 쿼리 실행 을 선택합니다. 쿼리의 메트릭은 플롯에 시각화됩니다. 쿼리가 유효하지 않으면 UI에 오류 메시지가 표시됩니다.
참고대량의 데이터에서 작동하는 쿼리 시간이 초과되거나 시계열 그래프에 있을 때 브라우저가 과부하될 수 있습니다. 이를 방지하려면 그래프 숨기기를 선택하고 메트릭 테이블만 사용하여 쿼리를 조정합니다. 그런 다음 실행 가능한 쿼리를 검색한 후 플롯을 활성화하여 그래프를 그립니다.
- 선택 사항: 이제 페이지 URL에 실행한 쿼리가 포함되어 있습니다. 나중에 이 쿼리 세트를 다시 사용하려면 이 URL을 저장합니다.
추가 리소스
- PromQL 쿼리 생성에 대한 자세한 내용은 Prometheus 쿼리 설명서를 참조하십시오.
8.1.2. 개발자로 사용자 정의 프로젝트의 메트릭 쿼리
사용자 정의 프로젝트의 메트릭에 대해 개발자 또는 프로젝트에 대한 보기 권한이 있는 사용자로 액세스할 수 있습니다.
개발자 관점에서 Metrics UI에는 선택한 프로젝트에 대한 사전 정의된 CPU, 메모리, 대역폭 및 네트워크 패킷 쿼리가 포함되어 있습니다. 프로젝트에 대한 CPU, 메모리, 대역폭, 네트워크 패킷 및 애플리케이션 메트릭에 대해 사용자 정의 Prometheus Query Language(PromQL) 쿼리를 실행할 수도 있습니다.
개발자는 관리자 관점이 아닌 개발자 관점만 사용할 수 있습니다. 개발자는 웹 콘솔의 사용자 정의 프로젝트에 대해 한 번에 한 프로젝트의 메트릭 만 쿼리할 수 있습니다.
사전 요구 사항
- 개발자로 또는 메트릭을 확인하는 프로젝트에 대한 보기 권한이 있는 사용자로 클러스터에 액세스할 수 있습니다.
- 사용자 정의 프로젝트에 대한 모니터링을 활성화했습니다.
- 사용자 정의 프로젝트에 서비스를 배포했습니다.
-
서비스에서 모니터링 방법을 정의하는 데 사용할
ServiceMonitor
CRD(사용자 정의 리소스 정의(Custom Resource Definition))가 생성되었습니다.
프로세스
- OpenShift Container Platform 웹 콘솔에서 개발자 화면을 선택합니다.
-
Observe
Metrics 를 선택합니다. - Project: 목록에서 메트릭을 보려는 프로젝트를 선택합니다.
- 쿼리 선택 목록에서 쿼리를 선택하거나 PromQL 표시를 선택하여 선택한 쿼리에 따라 사용자 정의 PromQL 쿼리를 만듭니다.
선택 사항: 쿼리 선택 목록에서 사용자 지정 쿼리를 선택하여 새 쿼리를 입력합니다. 입력하는 경우 드롭다운 목록에 자동 완성 제안이 표시됩니다. 이러한 제안에는 함수 및 메트릭이 포함됩니다. 제안된 항목을 클릭하여 선택합니다.
참고개발자 관점에서는 한 번에 하나의 쿼리만 실행할 수 있습니다.
추가 리소스
- PromQL 쿼리 생성에 대한 자세한 내용은 Prometheus 쿼리 설명서를 참조하십시오.
8.1.3. 시각화된 메트릭 살펴보기
쿼리를 실행하면 대화형 플롯에 메트릭이 표시됩니다. 플롯의 X축은 시간을 나타내며, Y축은 메트릭 값을 나타냅니다. 각 메트릭은 그래프에 색상이 지정된 선으로 표시됩니다. 대화형으로 플롯을 조작하고 메트릭을 살펴볼 수 있습니다.
절차
관리자 관점에서:
처음에 활성화된 모든 쿼리의 모든 메트릭이 플롯에 표시됩니다. 표시된 메트릭을 선택할 수 있습니다.
참고기본적으로 쿼리 테이블은 모든 메트릭과 해당 현재 값을 나열하는 확장된 보기를 표시합니다. 쿼리에 대해 확장된 보기를 최소화하려면 ˅를 선택할 수 있습니다.
- 쿼리에서 모든 메트릭을 숨기려면 쿼리에 대해 을 클릭하고 모든 시리즈 숨기기를 클릭합니다.
- 특정 메트릭을 숨기려면 쿼리 테이블로 이동하여 메트릭 이름 근처에 있는 색상이 지정된 사각형을 클릭합니다.
플롯을 확장하고 시간 범위를 변경하려면 다음 중 하나를 수행하십시오.
- 수평으로 플롯을 클릭하고 드래그하여 시간 범위를 시각적으로 선택합니다.
- 왼쪽 상단 코너의 메뉴를 사용하여 시간 범위를 선택합니다.
- 시간 범위를 재설정하려면 확대/축소 재설정을 선택합니다.
- 특정 시점에서 모든 쿼리에 대한 출력을 표시하려면 해당 시점에서 플롯에 마우스 커서를 유지합니다. 쿼리 출력이 팝업 상자에 나타납니다.
- 플롯을 숨기려면 그래프 숨기기를 선택합니다.
Developer 관점에서:
플롯을 확장하고 시간 범위를 변경하려면 다음 중 하나를 수행하십시오.
- 수평으로 플롯을 클릭하고 드래그하여 시간 범위를 시각적으로 선택합니다.
- 왼쪽 상단 코너의 메뉴를 사용하여 시간 범위를 선택합니다.
- 시간 범위를 재설정하려면 확대/축소 재설정을 선택합니다.
- 특정 시점에서 모든 쿼리에 대한 출력을 표시하려면 해당 시점에서 플롯에 마우스 커서를 유지합니다. 쿼리 출력이 팝업 상자에 나타납니다.
추가 리소스
- PromQL 인터페이스 사용에 대한 자세한 내용은 메트릭 쿼리 를 참조하십시오.
- 관리자로 모든 프로젝트의 메트릭에 액세스하는 방법에 대한 자세한 내용은 관리자 권한으로 모든 프로젝트의 메트릭 쿼리 를 참조하십시오.
- 개발자 또는 권한 있는 사용자로 비 클러스터 메트릭에 액세스하는 방법에 대한 자세한 내용은 개발자로 사용자 정의 프로젝트의 메트릭 쿼리 를 참조하십시오.