3.2. API 서비스 확장을 위한 주요 성능 지표


스케일링은 증가된 부하를 처리하는 리소스를 추가합니다. 이 작업은 주로 수평 확장(포드 또는 인스턴스 추가) 또는 수직 확장(Pod 또는 인스턴스에 CPU 또는 메모리 리소스 추가)을 통해 수행됩니다. 적절한 확장을 통해 고가용성을 보장하고 로드 중인 성능을 유지 관리합니다.

구성 요소가 용량에 도달하고 현재 요청 부하를 효율적으로 처리할 수 없음을 나타내는 다음 주요 성능 지표 중 하나 이상을 관찰할 때 서비스를 확장하는 것이 좋습니다.

  • 높은 API 대기 시간
  • CPU 사용량이 높습니다.
  • 트래픽이 많은 기간에 발생하는 오류

3.2.1. 높은 API 대기 시간

API 요청에 대한 높은 대기 시간을 유지하는 것은 주요 성능 지표입니다. 모든 요청은 프록시 역할을 하고 해당 서비스에 요청을 전달하는 플랫폼 게이트웨이를 통해 이루어집니다. API 요청의 URL에 있는 경로에 따라 요청이 대상 서비스로 전송됩니다.

  • 플랫폼 게이트웨이: /api/gateway
  • 자동화 컨트롤러: /api/controller
  • event-driven Ansible: /api/eda
  • Event-Driven Ansible Event Streams: /eda-event-streams/api/eda/v1/external_event_stream/
  • 자동화 허브: /api/galaxy

Envoy 프록시 로그를 통해 다양한 경로에서 대기 시간을 모니터링하면 스케일링이 필요한 서비스를 확인할 수 있습니다. 이러한 경로는 OpenShift Container Platform의 플랫폼 게이트웨이 Pod의 프록시 컨테이너 또는 VM 기반 설치 및 컨테이너 기반 설치의 플랫폼 게이트웨이 노드의 프록시 로그에 있습니다. 대상 API 임계값을 초과하는 대기 시간(예: 99번째 백분율 >1500ms)은 경고를 트리거하거나 웹 서비스를 확장해야 함을 나타냅니다.

3.2.2. CPU 사용량이 높습니다.

서비스의 API Pod가 일관되게 높은 CPU 사용량을 표시하면 수신 요청을 적시에 처리할 수 없어 요청이 백로그될 수 있습니다. 다음 지표는 높은 CPU 사용률을 제안합니다.

  • 서비스의 WSGI 로그에서 처리 시간이 포함된 Envoy 프록시 로그의 총 요청 시간
  • 높은 총 Envoy 대기 시간
  • 요청이 처리되기 전에 큐에서 대기 중입니다.

3.2.3. 오류 코드

플랫폼 게이트웨이의 프록시 컨테이너(OpenShift Container Platform) 또는 프록시 로그(VM 기반 및 컨테이너 기반 설치용)의 오류 코드는 서비스를 확장해야 함을 나타냅니다. 종종 과부하되고 적절한 방식으로 요청을 서비스할 수 없는 서비스에 의해 대기 시간이 길어지고 종종 대기 시간이 길어집니다.

  • 업스트림 인증 실패: Envoy 로그의 502 UAEX (업스트림 인증 확장) 응답은 요청의 인증 단계에서 문제를 나타냅니다. 이는 인증 서비스가 과부하되거나 시간 초과 또는 손상된 응답을 반환하는 것을 의미합니다.
  • 특정 서비스에 대한 업스트림 서비스 Unhealthy: 503 UH (Upstream Service Unhealthy) 응답은 Envoy가 해당 서비스의 pod 중 하나 이상을 비정상으로 표시했으며 트래픽을 전송하지 않음을 의미합니다. 이는 업스트림 Pod가 상태 점검에 실패할 때 발생합니다. 상태 점검은 클라이언트 트래픽과 동일한 요청 큐를 공유하므로 시간 내 상태 점검에 응답할 수 없는 과부하된 Pod는 로드 밸런싱 풀에서 일시적으로 제거됩니다.
  • 업스트림 연결 실패: 특정 서비스의 요청에 대한 503 UF (업스트림 연결 실패)는 Envoy가 업스트림 Pod에 연결하려고 시도했지만 연결에 실패했습니다. 이는 업스트림 서비스가 압도되어 새 연결을 허용할 수 없는 경우에 발생할 수 있습니다. Envoy 응답 플래그( HTTP 응답 코드를 따르는 문자 코드)에 대한 자세한 내용은 액세스 로깅 을 참조하십시오.
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동