Skip to Content
MineBoard Docs is released 🎉
서버 상태 체크API 및 저장 데이터

공개 반영 데이터

사용자에게 보이는 정보

사용자는 상태 체크 결과로 아래 정보를 보게 됩니다.

  • 현재 온라인 여부
  • 현재 접속자 수와 최대 접속 가능 인원
  • 최근 응답 속도
  • 버전 정보
  • MOTD
  • 최근 상태 변화 이력

에디션과 응답 형식에 따라 일부 항목은 제공 범위가 다를 수 있습니다.

최근 응답 속도는 상태 점검 작업이 실행된 위치를 기준으로 측정되는 참고값입니다.
즉, 사용자가 실제로 접속할 때의 체감 지연 시간과는 다를 수 있으며, 실행 환경이 달라지면 수치 비교 자체의 의미도 제한적일 수 있습니다.

어떻게 반영되나요?

상태 점검 결과는 내부적으로 두 종류의 데이터로 나뉘어 저장됩니다.

  • 지금 화면에 바로 쓸 최신 상태
  • 차트와 추세 확인에 쓰는 상태 이력

1차 점검에서 문제가 생기면 곧바로 화면을 오프라인으로 바꾸기보다,
재확인 과정을 거친 뒤 최종 상태를 확정합니다.

공개 문서에서 다루지 않는 내용

아래 내용은 운영 보안과 직접 연결되므로 공개 문서에서는 상세히 다루지 않습니다.

  • 내부 점검 경로
  • 인증 방식과 비밀값
  • 배포 지역이나 실행 위치
  • 내부 저장소 구조와 식별자 이름
  • 운영 상수값과 임계치

사용자 관점에서 이해하면 되는 핵심

  • 서버 상태는 단발성 확인이 아니라, 확인과 재확인을 거쳐 반영됩니다.
  • 일시적인 네트워크 문제로 서버가 바로 오프라인처럼 보이지 않도록 설계되어 있습니다.
  • 차트와 상세 상태는 같은 점검 결과를 바탕으로 일관되게 갱신됩니다.
  • Java와 Bedrock은 서로 다른 방식으로 확인하지만, 사용자 경험은 최대한 동일하게 유지됩니다.
Last updated on