쿠버네티스 HPA 레플리카 계산기
현재 레플리카 수와 메트릭 값을 넣으면 HorizontalPodAutoscaler가 계산할 원하는 레플리카 수를 그대로 재현합니다.
개
개
개
원하는 레플리카 수
4개
3개 → 4개로 계산됨
비율 (현재÷목표)1.286
공식 계산값 (허용 오차 반영 전)4개
허용 오차 안(±10%)아니요 — 재계산
desiredReplicas = ceil[현재 레플리카 × (현재 메트릭 ÷ 목표 메트릭)]. 비율이 0.9~1.1(목표의 ±10%) 사이면 흔들림(flapping)을 막기 위해 HPA가 레플리카 수를 바꾸지 않습니다(기본 허용 오차 10%).
계산된 값은 항상 최소·최대 레플리카 범위로 잘립니다. 실제 클러스터에서는 컨트롤러 동기화 주기(기본 15초)·안정화 윈도우 같은 이 계산기가 다루지 않는 요인도 함께 작동합니다.
사용 방법
- 1현재 레플리카 수와 관측된 메트릭 값(예: CPU 사용률)을 입력합니다.
- 2목표 메트릭 값(HPA 매니페스트의 target)을 입력합니다.
- 3최소·최대 레플리카 수를 입력하면 그 범위로 잘린 최종 값을 확인합니다.
자주 묻는 질문
쿠버네티스 공식 문서의 알고리즘을 그대로 씁니다: desiredReplicas = ceil[currentReplicas × (currentMetricValue ÷ desiredMetricValue)]. 예를 들어 레플리카 3개, CPU 사용률이 목표 70%인데 실제 90%면 ceil(3×90/70) = ceil(3.86) = 4개로 늘어납니다.
흔들림(flapping)을 막기 위한 허용 오차(tolerance)가 있기 때문입니다. 관측값÷목표값 비율이 0.9~1.1(목표의 ±10%) 사이면 HPA는 레플리카 수를 그대로 둡니다. 쿠버네티스 1.33부터 이 허용 오차를 설정할 수 있게 됐지만 기본값은 여전히 10%입니다.
공식대로 계산한 값이 그대로 적용되는 것이 아니라 HPA 매니페스트에 정한 minReplicas·maxReplicas 범위로 항상 잘립니다. 트래픽이 갑자기 튀어도 비용이 무한정 늘지 않게, 반대로 0개까지 줄어 서비스가 끊기지 않게 막는 안전장치입니다.
같습니다. CPU·메모리 사용률뿐 아니라 초당 요청 수 같은 커스텀 메트릭도 currentMetricValue÷desiredMetricValue 비율만 정해지면 같은 공식으로 계산됩니다.
알아두면 좋은 점
- 공식과 기본 허용 오차(10%)는 쿠버네티스 공식 문서(kubernetes.io)를 WebSearch로 교차 확인했습니다(2026-09).
- 안정화 윈도우(stabilization window)·스케일다운 정책 같은 세부 튜닝 옵션은 다루지 않습니다. 핵심 공식만 계산합니다.
- 실제 클러스터의 동작은 컨트롤러 동기화 주기(기본 15초)·여러 메트릭을 동시에 쓸 때의 최댓값 선택 등 이 계산기가 다루지 않는 요인에 따라 달라질 수 있습니다.
함께 보면 좋은 도구
마지막 검증: 2026년 9월 4일 · 결과는 참고용 추정치입니다.