14장. CLI를 사용하여 모니터링 API에 액세스

OpenShift Container Platform 4.12에서는 CLI(명령줄 인터페이스)에서 일부 모니터링 구성 요소에 대한 웹 서비스 API에 액세스할 수 있습니다.

중요

특정 상황에서 API 끝점에 액세스하면 특히 끝점을 사용하여 대량의 메트릭 데이터를 검색, 전송 또는 쿼리하는 경우 클러스터의 성능과 확장성이 저하될 수 있습니다.

이러한 문제를 방지하려면 다음 권장 사항을 따르십시오.

  • 끝점을 자주 쿼리하지 마십시오. 쿼리를 30초마다 최대 1개로 제한합니다.
  • Prometheus의 /federate 엔드포인트를 통해 모든 메트릭 데이터를 검색하지 마십시오. 제한된 집계 데이터 세트를 검색하려는 경우에만 쿼리합니다. 예를 들어 각 요청에 대해 1,000개 미만의 샘플을 검색하면 성능 저하 위험을 최소화할 수 있습니다.

14.1. 모니터링 웹 서비스 API 액세스 정보

다음 모니터링 스택 구성 요소에 대해 명령줄에서 웹 서비스 API 끝점에 직접 액세스할 수 있습니다.

  • Prometheus
  • Alertmanager
  • Thanos Ruler
  • Thanos Querier
참고

Thanos Ruler 및 Thanos Querier 서비스 API에 액세스하려면 요청 계정에 cluster-monitoring-view 클러스터 역할을 계정에 바인딩하여 부여할 수 있는 네임스페이스 리소스에 대한 액세스 권한이 있어야 합니다.

모니터링 구성 요소에 대한 웹 서비스 API 끝점에 액세스하는 경우 다음 제한 사항을 유의하십시오.

  • 전달자 토큰 인증을 사용하여 API 엔드포인트에만 액세스할 수 있습니다.
  • 경로의 /api 경로의 끝점에만 액세스할 수 있습니다. 웹 브라우저에서 API 끝점에 액세스하려고 하면 애플리케이션을 사용할 수 없는 오류가 발생합니다. 웹 브라우저에서 모니터링 기능에 액세스하려면 OpenShift Container Platform 웹 콘솔을 사용하여 모니터링 대시보드를 검토합니다.