🩺 헬스체크 설정 가이드 | 장애를 언제 알아챌까?

프로브 간격 (period)

초

프로브 타임아웃 (timeout)

초

실패 임계 — 연속 실패 횟수

회

성공 임계 — 복귀 인정 연속 성공 횟수

회

정상일 때 응답시간 p99 (선택)

프로브 1회가 타임아웃될 확률 (선택)

넣으면 정상인데 실패로 판정될 평균 간격을 함께 계산합니다. 프로브 실패가 서로 독립이라고 가정한 단순 계산입니다.

계산 모델: 쿠버네티스처럼 프로브가 간격(periodSeconds)마다 시작되고, 장애가 직전 프로브 성공 직후에 시작된 최악의 경우를 씁니다. 그래서 감지 시간은 실패 임계 × 간격 + 마지막 프로브의 타임아웃이며, 시작 대기 계산(실패 임계 × 간격)과 같은 기준입니다. 공인된 권장 간격·타임아웃·임계값은 없어서 이 페이지는 권장값을 제시하지 않습니다.

헬스체크 설정값이 만드는 결과를 역산합니다

컨테이너 오케스트레이터는 프로브로 애플리케이션 상태를 확인합니다. 간격·타임아웃·실패 임계·성공 임계를 넣으면 장애가 시작된 뒤 비정상으로 판정되기까지 걸리는 최악 시간과, 정상인데도 실패로 판정될 가능성을 함께 계산합니다. 간격을 짧게 잡으면 빨리 알아채지만 오탐이 늘고, 길게 잡으면 그 반대가 됩니다.

계산은 Kubernetes 처럼 프로브가 간격마다 시작되는 모델을 씁니다. 최악 감지 시간은 실패 임계 × 간격 + 타임아웃이고, 결과 영역에 적용한 식을 그대로 출력합니다. 시작 허용 시간은 Kubernetes 문서가 startup 프로브에 대해 밝힌 실패 임계 × 간격 식을 씁니다. liveness 는 재시작, readiness 는 트래픽 차단, startup 은 느린 초기화 보호로 역할이 서로 다릅니다. 2026년 10월 기준입니다.

공인된 권장 간격·타임아웃·임계값은 없습니다. 워크로드마다 응답시간 분포가 달라서 이 페이지는 권장값을 제시하지 않고 입력한 설정값의 결과만 보여 줍니다. 오탐 간격은 프로브 실패가 서로 독립이라는 가정의 단순 계산이며, 실제로는 부하가 겹쳐 연속 실패가 몰립니다. 프로브 종류별 기본값 조회나 설정 파일 생성은 지원하지 않습니다.

자주 묻는 질문

실패 임계를 1회로 두면 어떻게 될까?

일시적인 응답 지연 한 번에 바로 비정상으로 판정됩니다. 감지는 가장 빠르지만 정상 상태에서 실패로 판정되는 오탐도 가장 잦아집니다.

타임아웃이 응답시간보다 짧으면 어떻게 될까?

정상 응답도 타임아웃으로 끊깁니다. p99 응답시간을 넣으면 타임아웃과의 여유를 밀리초로 보여 주므로 여유가 0 이하인지 먼저 확인하세요.

liveness 와 readiness 를 같은 값으로 둬도 될까?

역할이 달라 결과가 달라집니다. liveness 실패는 재시작이고 readiness 실패는 트래픽 차단이므로, 재시작까지 가는 liveness 쪽을 더 느슨하게 두는 구성이 많습니다.

🩺헬스체크 주기·타임아웃 설정 가이드

관련된 도구

컨테이너 메모리 리밋 설정 가이드

쿠버네티스 리소스 요청·제한 설정 가이드

헬스체크 설정값이 만드는 결과를 역산합니다

자주 묻는 질문

관련된 도구

컨테이너 메모리 리밋 설정 가이드

쿠버네티스 리소스 요청·제한 설정 가이드

헬스체크 설정값이 만드는 결과를 역산합니다

자주 묻는 질문

같은 카테고리 도구