장애 상황에 상태 페이지가 필요한 이유와 구축 방법

서비스가 중단돼도 열 수 있는 상태 페이지를 구성합니다. 게시 경로와 구성 요소를 정하고 모니터링 결과를 고객 공지로 전달하는 방법을 살펴봅니다.

모범 사례
여러 리전의 서비스가 하나의 대시보드에 연결된 일러스트

한 리전에서 결제 요청이 타임아웃되기 시작했다고 가정해 봅시다. 당직자는 합성 테스트가 실패했다는 사실을 볼 수 있지만, 고객은 이미 주문이 접수됐는지 묻고 있습니다. 상태 페이지에 영향 범위, 마지막으로 확인한 내용, 다음 공지 시각을 올리면 지원팀과 고객이 같은 정보를 볼 수 있습니다. 진단에 필요한 세부 정보는 대응팀 채널에서 관리합니다.

상태 페이지는 읽는 경로와 게시하는 경로가 모두 살아 있어야 합니다. 서비스가 중단돼도 고객이 페이지를 열 수 있고, 권한이 있는 담당자는 공지를 올릴 수 있어야 합니다. 디자인이나 호스팅을 정하기 전에 두 경로를 먼저 살펴봅니다.

본 서비스가 멈춰도 페이지를 열 수 있게 하기

status.example.com은 기억하기 쉬운 주소입니다. 본 서비스가 중단돼도 페이지가 열리는지는 그 뒤의 의존성에 달려 있습니다. 호스팅을 분리해도 권한 DNS, CDN 계정이나 게시 담당자의 로그인 시스템을 함께 쓸 수 있습니다. 외부 네트워크에서 페이지를 읽어 보고, 본 서비스나 평소 쓰는 로그인 시스템에 문제가 생긴 상황을 가정해 게시 절차도 연습합니다. 승인받은 대체 연락 수단은 대응 문서에 남겨 둡니다.

직접 개발하면 게시 절차를 원하는 대로 설계할 수 있으며, 호스팅과 업데이트, 인증서는 팀이 관리합니다. 오픈소스를 자체 호스팅하면 구현의 출발점이 생기지만 운영과 유지보수는 필요합니다. 관리형 서비스를 쓰더라도 도메인 설정과 접근 권한, 공지 절차는 정해야 합니다. 분리하려는 장애를 기준으로 각 방식의 책임 범위를 확인하세요. Atlassian의 장애 커뮤니케이션 가이드(영어)

사용자가 판단할 수 있는 단위로 나누기

결제, 주문 내역, API처럼 고객에게 익숙한 기능 단위로 상태를 나눕니다. 리전이나 제품에 따라 사용자가 할 수 있는 일이 달라진다면 그 차이도 보여 줍니다. 결제는 실패하지만 주문 내역은 볼 수 있다면, 단일 장애 배너보다 두 기능의 상태가 따로 보이는 편이 유용합니다. 모바일에서도 현재 영향과 최신 공지를 바로 읽을 수 있게 합니다. 로고와 색상은 페이지를 알아보는 데 도움이 되며, 가독성과 빠른 로딩을 우선합니다.

공개 페이지에 올릴 정보와 특정 고객 또는 내부 채널에만 전달할 정보를 나눕니다. 영향 범위, 안내가 승인된 우회 방법, 다음 공지 시각은 공개할 수 있습니다. 고객별 조사 결과, 요청 식별자, 내부 진단 정보는 적절한 별도 채널에 둡니다. 주소를 공개 목록에서 빼도 링크를 공유할 수 있으므로, 제한된 대상에게만 보여 주려면 그 대상에 맞는 접근 제어 기능을 선택합니다.

모니터링 결과를 고객 공지로 이어가기

가상의 결제 장애를 생각해 봅시다. 1분마다 실행하는 HTTP 합성 테스트가 싱가포르에서 10:01과 10:02 UTC에 연속 실패하고, 도쿄의 테스트는 성공합니다. 이 예에서는 당직자에게 알립니다. 10:04 UTC까지 운영 요청 데이터로 싱가포르의 결제 타임아웃과 주문 내역의 정상 동작을 확인했으므로, 공지 담당자는 고객 영향을 공개할 수 있습니다. 합성 테스트 결과 자체는 특정 위치에서 실행한 특정 점검의 결과입니다.

시각 (UTC) 공개 공지 예시
10:05 싱가포르에서 결제 요청이 타임아웃되는 문제를 조사하고 있습니다. 주문 내역은 이용할 수 있습니다. 다음 공지는 10:20 UTC까지 올리겠습니다.
10:20 영향을 줄이기 위한 조치를 적용했고 결제 결과를 확인하고 있습니다. 다음 공지는 10:35 UTC까지 올리겠습니다.
10:35 싱가포르의 결제가 복구됐습니다. 10:35 UTC까지 15분간 정상 결제 결과를 확인했습니다. 문제가 계속되면 지원팀에 문의해 주세요.

15분마다 공지하고 15분간 복구를 확인한 것은 이 예에서 정한 기준입니다. 실제로는 사용자 영향과 사용자가 내려야 하는 판단에 맞춰 주기를 정합니다. 공지 담당자와 대체 담당자를 미리 지정합니다. 복구 예상 시간이 아직 없어도, 확인한 사실과 다음 공지 시각은 안내할 수 있습니다. Google SRE의 장애 대응 역할과 공지 지침(영어)

구성 요소 상태와 장애 기록을 구분하기

Guance HTTP 합성 테스트 결과는 영향 범위를 조사하는 데 쓸 수 있습니다. Guance 사용자 지정 상태 페이지를 설정하려면 페이지 구성 권한과 서비스 수준 목표(SLO)를 읽을 권한이 필요합니다. 게시하기 전에 서비스 하나 이상에 공개 표시를 켜고, 활성 상태이며 그룹화 차원을 지정하지 않은 SLO를 연결합니다. 서비스 상태는 연결된 SLO 달성률과 기준으로 계산합니다. 게시된 점검 기록은 해당 업무 날짜에 연결된 서비스를 점검 중으로 표시할 수 있습니다. 장애 기록에는 고객이 겪은 영향과 팀이 한 조치를 적습니다.

장애 기록에는 같은 워크스페이스에서 읽을 수 있는 공개 노트를 연결합니다. 이미 게시된 상태 페이지 기록에 연결된 노트의 제목이나 본문을 수정해 저장하면 공개 페이지에 최신 내용이 반영됩니다. 업무 날짜, 영향받은 서비스, 표시 설정을 바꿀 때는 공개 설정을 갱신해야 합니다. 각 단계에서 문구와 미리 보기를 확인합니다. 더 긴 기간을 보는 SLO가 목표를 충족하더라도, 그사이에 발생한 결제 장애는 장애 기록으로 안내할 수 있습니다.

장애가 나기 전에 페이지 알려 두기

도움말 센터와 푸터에 주소를 두고 지원팀이 답변할 때도 같은 링크를 쓰게 합니다. 권한이 있는 담당자가 초안에서 공지를 게시하고, 외부 연결로 공개 페이지를 확인하는 과정을 연습합니다. 장애 기록을 보관할 기간을 정하고, 가용성 차트에는 어떤 구성 요소와 기간을 집계했는지 표시합니다. 차트에 표시하는 기간과 장애 기록을 보관하는 기간은 구분해서 안내합니다.

서비스 상태 페이지의 기본 · 상태 페이지 사례 · 장애 공지 템플릿

맞춤형 플랜 상담

문의하기

커뮤니티 가입

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

Guance 사용해 보기

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

시작하기

Guance 요금제 선택

코드 저장소