업타임 모니터링이란? 웹사이트와 API의 가용성 확인하기

HTTP 프로브가 확인하는 범위, 실패가 알림으로 이어지는 조건, 실행 주기와 지역 선택, 가용성 집계 기준을 설명합니다.

모범 사례
웹사이트와 서비스 가용성 모니터링을 표현한 일러스트

홈페이지가 200 OK를 반환해도 뒤에서 호출하는 API는 실패할 수 있습니다. 한 지역에서는 접속되는데 다른 지역에서는 시간 초과가 날 수도 있습니다. 업타임 모니터링은 정해진 위치에서 주기적으로 요청을 보내고 웹사이트나 서비스가 기대대로 응답하는지 기록합니다. 담당자에게 언제 알릴지는 알림 규칙으로 정합니다.

가용성 프로브의 동작 방식

프로브는 설정된 URL에 요청을 보내고 결과를 확인합니다.

  • 상태 코드. 엔드포인트의 계약에 맞춥니다. 일반 페이지는 200 OK, 본문이 없는 성공 응답은 204 No Content가 예입니다. 리디렉션을 따라갈지도 정합니다. 연결 시간 초과나 TLS 핸드셰이크 실패는 HTTP 상태 코드를 받기 전에 발생할 수 있습니다.
  • 응답 시간. 요청에 걸린 시간을 기록합니다. 구간별 데이터가 있다면 DNS 조회, 연결, TLS, 첫 바이트 수신 시간으로 조사 범위를 좁힐 수 있습니다.
  • 시간 초과. 엔드포인트의 예상 소요 시간과 도구에서 지원하는 설정 범위를 기준으로 실패 판정 시간을 정합니다.

한 번 실패했다면 그 시도에서 문제가 관측된 것입니다. 재시도, 연속 실패 확인, 여러 지역의 비교, 인시던트 생성은 설정된 규칙에 따릅니다. 알림을 보낼 대상과 온콜 담당자 배정은 별도로 설정합니다.

상태 코드와 응답 내용을 함께 확인하기

애플리케이션이 정상 페이지와 데이터베이스 오류 페이지에 같은 200을 반환할 수 있습니다. 둘을 구분하려면 응답 본문을 검사합니다. 본문을 확인할 때는 GET을 사용합니다. HEAD 응답에는 본문이 없습니다.

  • 가입 진입점을 나타내는 안정적인 표식을 확인합니다.
  • “데이터베이스 연결 실패” 같은 오류 문구가 없는지 확인합니다.
  • 정상 응답에 꾸준히 나타나는 경우 <div id="pricing"> 같은 요소 표식을 확인합니다.

정상 응답을 식별할 표식이 있다면 상태 코드와 본문 조건을 함께 사용합니다. 공통 헤더가 오류 페이지에도 표시될 수 있고, 언어나 버전이 바뀌면 문구 검사에서 오탐이 생길 수 있습니다. JavaScript 렌더링이나 클릭 동작은 브라우저 프로브로 확인합니다.

실패 감지부터 복구까지

  1. 실패 기록. 감지 조건을 충족하면 이상 이벤트를 생성합니다.
  2. 담당자 알림. 구성된 채널로 전달합니다. 확인하지 않은 건을 언제 누구에게 에스컬레이션할지는 온콜 일정과 알림 규칙에 따릅니다.
  3. 확인 및 조사. 담당자가 팀의 인시던트 절차에 따라 대응을 맡습니다.
  4. 복구 확인. 복구 조건을 적용하고 팀 절차에 따라 인시던트 상태를 갱신하거나 종료합니다. 첫 실패와 복구 샘플은 각각 프로브가 해당 상태를 관측한 시점을 보여 줍니다.

알림에는 처음 실패를 관측한 시각, 오류 유형, 영향을 받은 프로브 위치, 확인할 수 있는 시간 데이터와 로그 링크를 포함합니다. 상태 코드 불일치, TLS 실패, 본문 누락은 초기에 확인할 지점이 서로 다릅니다.

어떤 엔드포인트를 감시할까

사용자가 의존하는 경로부터 나열하고 각 경로에 맞는 검사를 정합니다.

  • 홈페이지와 주요 랜딩 페이지.
  • 로그인과 가입 엔드포인트.
  • 주문이나 결제 콜백 같은 핵심 API. 반복 호출로 실제 거래가 발생할 수 있다면 테스트 엔드포인트나 격리된 환경을 사용합니다.
  • /healthz 같은 상태 확인 엔드포인트. 실제로 어떤 의존성을 확인하는지 살펴봅니다.
  • CDN의 JavaScript와 CSS 같은 주요 정적 리소스.

집계 기준을 정하고 가용률 계산하기

시간 기준 가용률은 집계 대상 전체 시간에서 중단 시간을 뺀 뒤 집계 대상 전체 시간으로 나눈 값입니다. 30일 전체를 포함하면 99.9%의 허용 중단 시간은 43.2분, 99.99%의 경우 4.32분입니다.

프로브 성공률은 선택한 지역과 기간에서 평가 결과가 있는 샘플 중 조건을 통과한 비율입니다. 누락 샘플과 유지보수 제외 기준은 별도로 보고합니다. 짧은 장애는 두 검사 사이에 발생해 관측되지 않을 수 있습니다. 서비스 가용성 SLI에는 실제 요청의 성공 비율을 쓰기도 합니다. 프로브 성공률을 사용자가 영향을 받은 시간으로 바로 환산할 수는 없습니다.

설정 후 성공과 실패 확인하기

Guance HTTP 합성 테스트(영문)에서 예상 상태 코드와 응답 내용 조건을 설정합니다. 두 조건이 모두 필요하면 기본 모드에서 All을 선택합니다. 프로브 위치와 실행 주기도 지정합니다. 문서상 HTTP 작업의 가장 짧은 사전 설정 주기는 1분이며 Commercial Plan 이상에서 사용할 수 있습니다. Test 버튼은 요청 설정을 확인합니다. 선택한 노드에서 연결할 수 있는지는 예약 실행 결과로 확인합니다.

합성 테스트 이상 감지(영문)에서 평가 주기, 조회 구간, 임계값, 복구 조건을 설정하고 알림 정책(영문)을 연결합니다. 프로브 실행과 감지 평가는 별도의 주기로 동작합니다. 연속 트리거 조건은 감지 평가 횟수를 셉니다. 통제된 환경에서 성공, 실패, 복구를 재현해 예상한 이벤트와 알림이 발생하는지 확인합니다.

가용률을 집계할 때 프로브 주기와 노드, 보고 기간, 유지보수 처리 기준을 함께 기록합니다. SLA에 사용하려면 계약 정의와 실제 서비스 영향을 확인합니다.

자주 묻는 질문

검사 주기가 짧을수록 좋은가요?

실패 샘플을 일찍 확보할 가능성이 커집니다. 고정된 1분 주기에서 성공 직후 장애가 발생하고 연속 두 번의 예약 검사 실패가 필요하다면, 두 번째 실패 검사는 약 2분 뒤에 시작됩니다. 여기에 요청 시간 초과, 감지 평가, 알림 전달에 걸리는 시간도 더해질 수 있습니다. 허용 감지 시간과 지원 주기, 요청 부하, 비용을 고려해 설정합니다.

왜 여러 지역에서 확인하나요?

지역을 비교하면 특정 경로의 문제인지 더 넓은 장애인지 구분하는 데 도움이 됩니다. 사용자 분포를 기준으로 여러 지역의 실패 임계값과 시간 창을 설정합니다. 다른 지역이 정상이어도 해당 지역의 사용자가 영향을 받으면 지역별 알림을 보낼 수 있습니다.

내부 서비스는 어떻게 확인하나요?

대상에 접근할 수 있는 네트워크에 Guance 자체 호스팅 노드(영문)를 배치합니다. 해당 노드의 DataKit 합성 테스트 수집기에서 내부 네트워크 작업을 허용하고, 설정된 작업 서비스와 데이터 업로드 목적지에도 접근할 수 있어야 합니다. 노드를 선택한 뒤 워크스페이스에서 예약 실행 결과를 확인합니다.

참고 자료. HTTP HEAD 규격(영문) · Google SRE의 SLI 설명(영문) · Guance 가용성 모니터링(중국어 간체)

맞춤형 플랜 상담

문의하기

커뮤니티 가입

WeChat으로 스캔하여
커뮤니티에 가입하세요

Guance 사용해 보기

온라인에서 바로 시작하고 사용한 만큼만 결제하세요.

시작하기

Guance 요금제 선택

코드 저장소