서버 로그와 크래시 리포트 읽는 방법
게임 서버 로그에서 중요한 한 줄을 찾는 방법입니다. 로그 레벨, 스택 트레이스, 첫 오류 원칙, 그리고 패널에서 로그와 크래시 리포트가 있는 위치를 다룹니다.
읽는 시간 5분 · 2026년 10월 21일 업데이트 · 작성: GuavaHost Team
서버가 죽거나 시작을 거부할 때, 이유는 거의 항상 로그에 적혀 있습니다. 로그는 겁나 보이지만 전부 이해할 필요는 거의 없습니다. 한 줄만 찾으면 됩니다. 이 문서에서는 로그 한 줄을 읽는 방법, 레벨의 의미, 스택 트레이스를 읽는 방법, 그리고 패널에서 로그와 크래시 리포트가 어디에 있는지 보여 줍니다.
로그 한 줄의 구조
Minecraft 서버의 전형적인 한 줄입니다.
[14:02:11] [Server thread/INFO]: Done (8.412s)! For help, type "help"
- **
[14:02:11]**은 시간입니다. 서버의 시계이므로 내 시간대와 다를 수 있습니다. - **
Server thread**는 그 줄을 쓴 프로그램의 부분입니다. 서버 스레드는 메인 게임 루프입니다. - **
INFO**는 레벨, 즉 그 줄이 얼마나 심각한지입니다. - 콜론 뒤의 전부가 메시지입니다.
다른 게임은 줄 형식이 다르지만, 거의 모두 시간과 레벨과 메시지를 어딘가에 담고 있습니다.
로그 레벨
| 레벨 | 의미 | 걱정해야 하나요? |
|---|---|---|
| DEBUG 또는 TRACE | 개발자용 세부 정보 | 보통 숨겨져 있습니다. 무시하세요 |
| INFO | 평범한 활동: 시작, 접속, 저장 | 아니요 |
| WARN | 뭔가 어긋났지만 서버는 계속 돌아감 | 때때로. 많은 경고는 무해한 잡음입니다 |
| ERROR | 뭔가 실패함 | 예, 내 문제와 시점이 맞다면 |
| FATAL 또는 SEVERE | 서버가 계속할 수 없음 | 예, 보통 이것이 크래시 자체입니다 |
경고를 하나하나 쫓지 마세요. 건강한 서버도 시작할 때마다 똑같은 무해한 경고를 잔뜩 찍습니다. 내 문제가 생기는 시점에 발생하는 오류에 집중하세요.
첫 오류 원칙
하나의 진짜 문제가 그 뒤로 오류 더미를 만드는 일이 많습니다. 서버의 다른 부분들이 첫 실패에 걸려 넘어지기 때문입니다. 화면에 보이는 마지막 오류는 보통 증상입니다. 평범해 보이는 마지막 줄 다음의 첫 오류가 보통 원인입니다.
- 모든 것이 정상이던 마지막 줄을 찾으세요.
- 아래로 읽어 내려가 첫
ERROR,Exception,FATAL까지 가세요. - 그것을 고치고, 재시작하고, 다시 읽으세요. 서버가 이제 더 멀리 가서 실패한다면 진전이 있는 것입니다.
스택 트레이스 읽기
스택 트레이스는 프로그램이 실패한 순간에 밟고 있던 단계들의 목록입니다. Minecraft 플러그인 서버에서 흔히 보이는 예입니다.
[12:40:03 ERROR]: Error occurred while enabling ExampleShop v2.1 (Is it up to date?)
java.lang.NoClassDefFoundError: net/milkbowl/vault/economy/Economy
at com.example.shop.ShopPlugin.onEnable(ShopPlugin.java:57)
...
Caused by: java.lang.ClassNotFoundException: net.milkbowl.vault.economy.Economy
읽는 방법은 이렇습니다.
- 첫 줄이 무엇이 실패했는지 말해 줍니다. ExampleShop 플러그인이 시작되지 못했습니다.
- 예외 종류가 이유를 말해 줍니다.
NoClassDefFoundError는 필요한 코드가 없다는 뜻입니다. at줄들이 위치를 보여 줍니다. 게임 내부 이름보다 플러그인 자기 이름처럼 아는 이름을 찾으세요.Caused by가 뿌리입니다. 트레이스에 여러 개가 있으면 마지막Caused by가 보통 진짜 이유입니다. 여기서는 Vault의 클래스가 없으므로, 이 상점 플러그인이 의존하는 Vault 플러그인을 설치하는 것이 해결책입니다.
흔한 오류와 보통의 의미
| 보이는 것 | 보통의 의미 |
|---|---|
NoClassDefFoundError, ClassNotFoundException | 의존성이 없거나, 다른 버전용 플러그인이나 모드 |
NoSuchMethodError | 다른 게임 버전용으로 만들어진 것 |
OutOfMemoryError | 서버의 RAM이 바닥났습니다 |
FAILED TO BIND TO PORT 또는 Address already in use | 포트가 사용 중, 흔히 두 번째 사본이 아직 돌고 있음 |
found character '\t' that cannot start any token | YAML 설정 파일에 탭 문자. YAML은 공백만 허용합니다 |
NullPointerException | 버그, 또는 비어 있거나 잘못 적은 설정 값 |
크래시 리포트
일부 게임은 죽을 때 더 자세한 별도 리포트를 씁니다.
- Minecraft는
crash-reports폴더에 날짜와 시간이 담긴 이름으로 저장합니다. 맨 위쯤에Description줄과 예외가 있습니다. 모드 서버는 불러온 모드를 전부 나열하고, Forge와 NeoForge 리포트는 의심되는 모드를 짚어 주는 경우가 많습니다. - Java 자체가 내려앉는 크래시는 서버의 메인 폴더에
hs_err_pid로 시작하고 숫자가 붙은 파일을 남깁니다. 이런 경우는 플러그인보다 메모리나 네이티브 라이브러리를 가리키는 편입니다.
패널에서 로그가 있는 곳
Console (콘솔) 탭이 실시간 출력을 보여 줍니다. 최근 줄만 유지하므로 그보다 오래된 것은 Files (파일) 탭에서 로그 파일을 열거나 SFTP로 내려받으세요.
| 게임 | 찾아볼 곳 |
|---|---|
| Minecraft Java | logs/latest.log, 더 오래된 로그는 logs 안의 .log.gz 파일(내려받아 압축을 풀어 보세요), 크래시는 crash-reports |
| BepInEx를 쓰는 Valheim | BepInEx/LogOutput.log |
| ARK: Survival Evolved와 Ascended | ShooterGame/Saved/Logs/ShooterGame.log |
| Don't Starve Together | DoNotStarveTogether/config/server/Master와 .../Caves 안의 server_log.txt, 샤드마다 하나 |
| Enshrouded | enshrouded_server.json의 logDirectory가 가리키는 폴더, 기본값은 logs |
| 그 외 게임 | 콘솔이 찍은 내용. logs나 Logs 폴더, .log로 끝나는 파일도 찾아보세요 |
패널이 크래시를 보고할 때
서버 프로세스가 예상치 못하게 멈추면 패널이 서버가 죽었다는 자체 메시지와 종료 코드를 찍을 수 있습니다. 알아 둘 만한 몇 가지입니다.
- 0: 정상 종료입니다.
- 1: 오류 때문에 게임이 종료되었습니다. 바로 위의 줄들을 읽으세요.
- 137: 프로세스가 강제로 종료되었고, 보통 메모리 한도를 넘었기 때문입니다. 서버의 RAM이 부족할 때 나타나는 신호를 참고하세요.
- 139: 게임 자체 안에서 일어난 네이티브 크래시입니다.
긴 로그 검색하기
- 로그를 내려받아 텍스트 편집기로 엽니다.
- 찾기(Ctrl+F, Mac에서는 Cmd+F)로
ERROR, 그다음Exception, 그다음Caused by를 찾습니다. - 마지막으로 추가한 플러그인이나 모드의 이름을 검색합니다.
- 타임스탬프를 문제가 일어난 시점과 맞춰 봅니다.
로그로 도움 요청하기
평범한 마지막 줄부터 첫 오류의 끝까지 복사해, 스크린샷이 아니라 텍스트로 붙여 주세요. 어디든 공유하기 전에 비밀번호, 토큰, 사적인 내용을 지우세요. 그리고 저희 Discord로 가져오시면 팀이 함께 읽어 드립니다. 특히 시작 단계의 문제라면 서버가 starting에서 멈춘 경우를 참고하세요.
아직 해결되지 않았나요? discord.gg/GuavaHost의 Discord에 들어오시면 팀이 도와드립니다.
- logs
- crash report
- stack trace
- console
- troubleshooting
- errors
아직 해결되지 않았나요? 저희 팀이 24시간 대기하며 질문에 답해 드려요.