Stats 문서 원본 보기

'''Stats'''는 [[플레이시티 블록]]의 서버 활동 통계를 수집하고 집계하기 위한 자체 개발 [[마인크래프트/플러그인|마인크래프트 플러그인]]이다. 명령어 사용, 접속 활동, 월드 편집 관련 이벤트 등을 기록하여 서버 운영 상태를 파악하고, 이상 행동이나 반복 작업을 확인하는 데 활용한다.

== 주요 기능 ==
Stats의 주요 기능은 서버 운영에 필요한 활동 데이터를 정리하는 것이다.

* 서버 활동 통계 수집
* 명령어 별칭 정규화
* 데이터베이스 배치 저장
* 월드 편집 작업과 위험 행동 감지 보조
* 관리자용 상태 확인
* 수동 저장과 설정 재불러오기

통계 데이터는 단순 접속자 수를 세는 용도에 그치지 않는다. 도시건축 서버에서는 월드 편집 명령어, 대규모 작업, 반복적인 명령어 사용, 운영자 작업 기록이 서버 안정성과 직결될 수 있으므로, 이러한 활동을 일정한 기준으로 남겨 두는 것이 중요하다.

== 명령어 ==
관리자가 사용할 수 있는 기본 명령어는 다음과 같다.

<pre>
/stats reload
/stats status
/stats db
/stats flush
</pre>

{| class="wikitable"
! 명령어 !! 용도
|-
| `/stats reload`
| 설정을 다시 불러온다.
|-
| `/stats status`
| 플러그인 상태와 수집 상태를 확인한다.
|-
| `/stats db`
| 데이터베이스 연결 또는 저장 상태를 확인한다.
|-
| `/stats flush`
| 대기 중인 통계 데이터를 즉시 저장한다.
|}

== 운영 참고 ==
Stats는 서버 내부 운영 데이터를 다루므로, 공개 문서에는 기능과 목적을 중심으로 기록하고 실제 데이터베이스 접속 정보나 내부 테이블 구조는 공개하지 않는다.

운영 중에는 다음 항목을 확인하는 것이 좋다.

* 데이터가 정상적으로 저장되는지
* 배치 저장 중 오류가 없는지
* 월드 편집 관련 이벤트가 과도하게 누락되지 않는지
* 통계 수집이 서버 성능에 영향을 주지 않는지
* 개인정보나 민감한 운영 정보가 외부에 노출되지 않는지

== 플레이시티 블록에서의 활용 ==
플레이시티 블록은 도시건축 서버이기 때문에 일반 생존 서버보다 건축 활동과 명령어 사용량이 운영 판단에 더 큰 의미를 가진다. Stats는 이러한 활동을 장기적으로 확인할 수 있게 하며, 서버 설정 변경이나 플러그인 업데이트 이후 활동 패턴이 달라졌는지도 비교할 수 있다.

== 같이 보기 ==
* [[플레이시티 블록]]
* [[플레이시티 블록/서버]]
* [[마인크래프트/플러그인]]
* [[WorldEdit]]
* [[FastAsyncWorldEdit]]
* [[Plan]]

[[분류:플레이시티 블록]]
[[분류:마인크래프트/플러그인]]