Skip to Content
MineBoard Docs is released 🎉
서버 상태 체크공개 상태 데이터

공개 상태 데이터

사용자에게 보이는 정보

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

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

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

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

어떻게 반영되나요?

상태 점검 결과는 화면의 용도에 따라 아래 데이터로 나뉘어 반영됩니다.

  • 서버 카드와 상세 페이지에 바로 표시할 최신 상태
  • 최근 변화와 통계를 계산할 상세 상태 이력
  • 장기간 접속 인원 추세를 보여주기 위한 일별 최대 접속자 집계

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

서버 상태 조회 도구

MineBoard의 서버 상태 조회 도구에서는 서버 이름이나 등록된 주소로 공개 서버를 검색할 수 있습니다.

  • 공개 상태이며 현재 운영 중인 서버만 조회할 수 있습니다.
  • 일반 검색 결과에는 최근 30일 안에 상태 정보가 수집된 서버가 포함됩니다.
  • 최근 7일의 온라인 여부, 접속 인원 및 지연 시간을 차트로 확인할 수 있습니다.
  • 최근 7일의 체크 결과를 기준으로 업타임, 최대 동시 접속자 및 평균 지연 시간을 계산합니다.
  • 최근 1년의 일별 최대 동시 접속자를 히트맵으로 확인할 수 있습니다.

최근 1년 데이터는 가능한 경우 사용자의 접속 환경에 맞는 지원 시간대를 기준으로 날짜를 구분합니다. 시간대를 판단할 수 없으면 UTC를 기준으로 사용합니다.

최근 1년 집계 데이터가 아직 없거나 일시적으로 조회되지 않더라도 최근 7일의 상세 상태 데이터는 별도로 표시될 수 있습니다.

상태 정보가 없거나 오래된 경우

아직 상태 점검 결과가 한 번도 저장되지 않은 서버는 접속 인원과 최대 인원이 0, 지연 시간과 마지막 체크 시각이 빈 값으로 표시될 수 있습니다. 이 상태는 재확인까지 실패해 오프라인으로 확정된 경우와 구분해야 합니다.

또한 마지막 상태 정보가 오래된 서버는 일반 상태 조회 검색 결과에서 제외될 수 있습니다. 서버 소유자는 운영 대시보드에서 마지막 체크 시각과 상태 체크 중단 여부를 확인해 주세요.

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

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

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

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

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