바이브 코딩 →

헬스 체크Health Check Endpoint

헬스 체크(Health Check)는 서버의 맥박 재기 같은 것 — 서버나 서비스가 정상적으로 살아 있는지 짧은 응답으로만 확인하는 전용 주소(엔드포인트)예요.

간호사가 맥박을 재면 몇 초 만에 일단 괜찮은지 알 수 있죠. 헬스 체크는 서버의 맥박이에요. 보통 사이트 주소 뒤에 /health 같은 경로를 만들어 두고, 그 주소로 요청을 보내면 서버가 정상(OK)이라고 짧게 답하게 해요. 응답이 없거나 오류가 오면 뭔가 문제가 생겼다는 신호예요.

강의에서는 고객을 받기 전 사이트 다운 모니터링을 설정하면서 헬스 체크가 나와요. Claude에게 모니터링 준비를 부탁하면 서버 상태만 확인하는 /health 주소를 만들어 주고, 이 주소를 Uptime Robot 같은 감시 서비스에 등록해 일정 간격으로 확인하게 해요. 사이트가 멈추면 알림이 와서 손님보다 먼저 문제를 알 수 있어요. 헬스 체크 주소를 따로 만드는 이유는 메인 페이지를 계속 불러오면 무겁고, 화면이 떠도 DB 연결이 끊긴 경우를 놓칠 수 있기 때문이에요.

초보가 헷갈리는 건 사이트가 열리면 정상이라는 생각이에요. 첫 화면은 캐시로 보일 수 있어서 실제로는 로그인이나 결제가 안 될 수도 있어요. 그래서 헬스 체크에서 DB 연결 같은 핵심 기능까지 간단히 확인하게 만들면 더 정확해요. 다만 헬스 체크 응답에 비밀번호나 내부 설정을 담으면 안 되고, 정상인지 아닌지만 알려 주는 게 안전해요.

💡 대표 예시

  • 다운 모니터링 — Claude가 만든 /health 주소를 Uptime Robot에 등록한다
  • 장애 알림 — 헬스 체크 응답이 끊기면 메일이나 메시지로 알림을 받는다
  • DB 점검 — 헬스 체크에서 데이터베이스 연결까지 확인하도록 고친다
  • 정보 보호 — 응답에는 정상 여부만 담고 내부 설정은 빼 둔다

🔗 관련 용어

이 개념, 직접 적용해볼까요?

AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.