Orbit 상태 페이지

상태 페이지는 프로젝트가 정상 작동 중인지, 최근 성능은 어떤지, 배포한 내용이 무엇인지를 보여주는 공개적이고 로그인이 필요 없는 URL입니다. 이를 활성화하면 매분마다 프로젝트를 ping하는 가동 시간 확인이 시작되므로, 페이지를 게시하는 것의 부작용으로 모니터링을 얻게 됩니다.

상태 페이지 설정 위치

Orbit을 열고 프로젝트를 클릭한 후 프로젝트 탭 스트립의 Observability 그룹에서 Status page를 선택합니다. 페이지의 제목은 Public status page입니다.

켜기

1. Enable public status page를 켭니다.
2. Public slug를 선택합니다. 이것은 공개 URL의 일부가 되므로 제품 이름 같은 인식할 수 있는 것을 선택합니다.
3. 선택적으로 Ping path를 설정합니다. 기본값은 /입니다.
4. 공개 페이지 상단에 표시될 Page title과 Tagline을 입력합니다.
5. Show recent deploys와 Show recent incidents를 표시할지 결정합니다.
6. Save settings을 클릭합니다.

저장되면 페이지에 Live 배지가 표시되고 상태 페이지가 게시되었으며 매분마다 ping하고 있음을 확인합니다. 링크를 통해 공개 페이지로 이동하여 방문자에게 보이는 모습을 확인할 수 있습니다.

Slug 규칙

slug는 소문자, 숫자 및 하이픈으로 구성되어야 하며 최대 80자이고 하이픈으로 시작하거나 끝날 수 없습니다. Slug는 계정뿐만 아니라 모든 Orbit 전체에서 고유하므로 일반적인 단어는 이미 사용 중일 수 있습니다. 이미 사용 중인 경우 저장하면 slug가 이미 사용 중이라는 메시지가 반환되고 다른 것을 선택합니다.

slug는 신중하게 선택하십시오: 문서와 지원 응답에 입력할 공개 주소이며, 나중에 변경하면 이에 대한 모든 링크가 끊어집니다.

방문자가 보는 것

공개 페이지는 프로젝트의 자체 탭과 동일한 데이터로부터 구축됩니다:

• Current status: 최신 배포로부터, Operational, Building, Deploying, Queued, Awaiting Approval, Build Failed, Cancelled 또는 Rolled Back입니다.
• Uptime: 분 단위 확인으로부터 롤링 24시간, 7일 및 30일 기간에 대해 계산됩니다.
• Recent deployments: 해당 섹션을 활성화한 경우 성공률을 포함합니다.
• 30-day statistics: 성공률, 평균 빌드 시간 및 총 배포.
• Core Web Vitals: 수집 중인 경우 지난 30일에 대한 p75입니다.
• Incidents: 프로젝트 타임라인에서 표시한 주석으로부터 추출됩니다.

페이지는 자동으로 새로 고쳐지므로 사건 중에 페이지를 열어둔 고객은 다시 로드하지 않고도 업데이트를 볼 수 있습니다.

사건은 타임라인으로부터 옵니다

incidents 섹션은 별도의 편집기가 아닙니다. 프로젝트의 Timeline에서 Incident 종류의 주석을 표시하므로 정전 중의 워크플로우는: incident 주석을 표시하면 공개적으로 표시됩니다.

이는 의도적입니다. 이는 내부 타임라인과 공개 커뮤니케이션이 두 기록을 유지하는 사람 없이 동기화 상태를 유지한다는 의미입니다. 작성 방법은 Orbit Timeline Annotations를 참조하십시오.

가동 시간 확인

상태 페이지를 활성화하면 프로젝트의 프로덕션 URL을 설정한 ping 경로에서 매분마다 한 번 가져오는 확인이 시작됩니다. 각 결과는 저장되고 공개 페이지의 가동 시간 백분율은 해당 기록으로부터 계산됩니다.

확인은 90일 동안 유지되며 이전 확인은 자동으로 제거됩니다.

좋은 Ping 경로 선택하기

기본값 /은 대부분의 프로젝트에 적합합니다. 다른 것을 선택해야 하는 두 가지 이유:

• 홈 페이지가 무겁습니다. 경량 경로는 매분마다 한 번 poll하기 위한 더 공정하고 저렴한 것입니다.
• 홈 페이지는 위로 있지만 앱이 깨져 있을 수 있습니다. 캐시된 정적 셸은 API가 다운 중일 때 200을 기꺼이 반환합니다. /api/health과 같은 실제로 애플리케이션을 실행하는 경로는 사실을 알려줍니다.

이미 자동 롤백을 위해 configured된 health check가 있다면 여기서 동일한 경로를 사용하면 두 신호가 일관성 있게 유지됩니다. Health check 설정은 Deploying Your Project를 참조하십시오.

상태 페이지 제거

Remove page를 클릭하고 확인합니다. 확인은 명시적입니다: 모든 가동 시간 기록이 삭제됩니다.

일시 멈출 가치가 있습니다. 페이지 제거는 일시 멈추기 단추가 아닙니다. 확인이 중지되고 공개 URL이 작동하지 않으며 누적된 가동 시간 기록이 함께 없어집니다. 페이지를 일시적으로 보이지 않게만 하려면 숨겨진 모드가 없습니다: enable 토글을 끄고 제거하는 것보다 configuration을 그대로 두는 것이 더 적합한지 고려하십시오.

페이지가 제거될 때 slug가 해제되므로 나중에 다른 사람이 이를 요청할 수 있습니다.

실용적 조언

필요하기 전에 게시하십시오. 정전 중에 만든 상태 페이지는 아무도 북마크하지 않은 상태 페이지입니다. 모든 것이 정상일 때 링크를 바닥글, 문서 및 지원 서명에 넣습니다.

과도한 약속을 하지 마십시오. 페이지의 가동 시간 수치는 한 경로에 대한 1분 확인으로부터 나옵니다. 이는 정직한 모니터링이지 계약상 SLA가 아니며 이렇게 제시되어서는 안 됩니다.

tagline을 짧게 유지하십시오. 이미 답답해하는 사람이 열 때 제목 아래에 표시됩니다. 서비스가 무엇인지 설명하는 한 줄이고 그 외에는 아무것도 없습니다.

문제 해결

가동 시간이 0% 또는 실제보다 훨씬 낮게 표시됩니다. ping 경로가 non-2xx 응답을 반환하고 있습니다. 비공개 브라우저 창에서 열어보십시오: 로그인 페이지로 리다이렉트, 더 이상 존재하지 않는 경로의 404 또는 geo-block이 일반적인 원인입니다.

공개 URL이 404입니다. 페이지는 저장되었지만 enable 토글이 꺼져 있거나 링크의 slug가 저장된 것과 일치하지 않습니다. 설정 페이지에서 링크를 복사하십시오.

slug가 거부됩니다. 이미 사용 중이거나, 유효하지 않은 문자를 포함하거나, 하이픈으로 시작하거나 끝납니다.

공개 페이지에 vitals가 나타나지 않습니다. Vitals는 사이트의 collector 스크립트로부터 나옵니다. Orbit Web Vitals를 참조하십시오.

하나가 있었는데도 incident가 나타나지 않습니다. 주석이 Incident 종류여야 하고 Show recent incidents 스위치가 켜져 있어야 합니다.

다음 이동할 위치

• Orbit Timeline Annotations incident 업데이트 게시하기.
• Orbit Webhooks 고객보다 먼저 알림 받기.
• Orbit Web Vitals 공개적으로 표시되는 성능 수치 확인하기.