로그란?

로그에는 서버의 실행 정보와 실행 중 생긴 오류와 경고가 기록된다. 고수들이 기능이 왜 제대로 동작하지 않는지 분석할 때 반드시 보는 자료이기도 하다.

보통 서버의 최신 로그는 서버 루트 디렉터리/logs/latest.log에 저장되며, 콘솔 출력과 같은 내용이다.

매일 00:00에 서버는 최신 로그 latest.log를 날짜 이름의 gz 압축 파일로 묶는다. 해당 날짜의 압축 파일을 압축 프로그램으로 풀면 읽을 수 있다.

로그 내용은 아무 텍스트 편집기로나 열어 보면 된다(시스템 기본 메모장은 추천하지 않는다. 대부분의 텍스트 편집기는 키워드를 강조 표시해 준다).

로그 구성

로그는 보통 “[시간] [스레드 / 로그 레벨]: 로그 내용”으로 이루어진다. 예를 들면 다음과 같다.

[00:01:32] [Server thread/WARN]: [PvPManager] Error loading Vault! No Economy plugin found
[00:02:34] [Craft Scheduler Thread - 5300 - InteractiveChat/INFO]: MangGuo_Pi: www
[00:47:53] [Server thread/ERROR]: Error occurred (in the plugin loader) while disabling ExcellentShop v4.3.12 (Is it up to date?)
[00:47:55] [Server thread/INFO]: Radiation_pi issued server command: /lp user Radiation_pi permission set rtp.use true
[00:47:55] [luckperms-command-executor/INFO]: [LP] LOG > (Radiation_pi) [U] (radiation_pi)

시간

서버가 해당 로그를 출력한 시각이다(출력량이 아주 많을 때는 시간이 정확하지 않을 수도 있다).

스레드

보통은 메인 스레드인 Server thread다. 많은 플러그인이 Craft Scheduler Thread를 쓰거나, 메인 스레드 부담을 줄이려고 별도 스레드를 연다(LuckPerms 등).

Craft Scheduler Thread는 보통 플러그인이 Bukkit 스케줄러를 쓸 때 자동으로 만들어지는 스레드다.

로그 레벨

레벨	정도	내용
INFO	정보	채팅 내용/플레이어 상태/플레이어 명령어/플러그인 정보 등
WARN	경고	잠재적 위험에 대한 경고. 오류로 이어질 수 있다
ERROR	오류	서버에 오류가 생겼을 때 출력되는 정보

정리하면, 서버에 이상이 생기면 곧바로 로그에 WARN이나 ERROR 레벨 메시지가 있는지 확인하자. 먼저 비슷한 사례가 있는지 검색해 보고, 번역기 결과도 참고해 고쳐 보자. 도저히 안 되면 다른 사람에게 물어봐도 되지만, 그 전에 꼭 질문하는 법을 읽자.

INFO

보통 다음을 포함한다.

플레이어 행동: 채팅, 명령어, 접속/퇴장 등
플러그인 정보: 플러그인 로드와 언로드, 로드 시간, 플러그인 동작 기록 등
서버 정보: 서버 초기화, 월드 저장, 플러그인 활성화 등

예:

[00:47:55] [Server thread/INFO]: Player_A issued server command: /lp user Player_A permission set rtp.use true
[00:47:55] [luckperms-command-executor/INFO]: [LP] LOG > (Player_A) [U] (radiation_pi)

플레이어가 입력한 명령어와, LuckPerms 플러그인이 기록한 권한 변경 내역이다.

WARN

플러그인 버전 호환성 위험, 설정 파일이나 데이터 문제 등이다. 당장은 괜찮지만 이후 오류로 이어질 수 있다. 예:

[00:01:32] [Server thread/WARN]: [PvPManager] Error loading Vault! No Economy plugin found

PvPManager 플러그인이 경제 플러그인을 찾지 못했다고(No Economy plugin found) 경고하는 로그다.

ERROR

오류는 서버 실행 중에 만난 예외 상황이다. 서버 자체에서 나올 수도 있고, 플러그인이나 모드에서 나올 수도 있다.

이런 상황은 서버의 정상 동작을 방해하고, 플레이어 경험 악화, 데이터 손상, 심하면 서버 크래시까지 일으킬 수 있다.