Unity 로그 파일 위치 총정리 — Editor.log, Player.log, 모바일 로그 수집까지
OS 별 Editor.log·Player.log 경로, -logFile 옵션, Android logcat 과 iOS 로그 추출 방법. QA 에게 로그 받는 절차를 한 번에 정리합니다.
- unity
- logging
- qa
"로그 좀 보내주세요"라고 했을 때 QA·테스터가 어디서 뭘 찾아야 하는지를 한 페이지로 정리합니다. 찾으러 오신 경로가 있다면 아래 표에서 바로 확인하시고, 뒷부분에는 이 절차 자체를 없애는 방법을 적었습니다.
Editor.log — 에디터의 로그
| OS | 경로 |
|---|---|
| Windows | %LOCALAPPDATA%\Unity\Editor\Editor.log |
| macOS | ~/Library/Logs/Unity/Editor.log |
| Linux | ~/.config/unity3d/Editor.log |
직전 세션은 같은 폴더의 Editor-prev.log에 있습니다. 에디터가 크래시한 경우 재시작하면 로그가 밀리므로, 재시작 전에 Editor.log를 확보해야 합니다.
Player.log — 빌드(스탠드얼론)의 로그
| OS | 경로 |
|---|---|
| Windows | %USERPROFILE%\AppData\LocalLow\<회사명>\<제품명>\Player.log |
| macOS | ~/Library/Logs/<회사명>/<제품명>/Player.log |
| Linux | ~/.config/unity3d/<회사명>/<제품명>/Player.log |
<회사명>과 <제품명>은 Player Settings의 Company Name / Product Name입니다. 여기도 직전 세션은 Player-prev.log로 밀립니다 — "게임 다시 켜서 확인해 보세요"라고 안내하면 정작 필요한 로그가 prev 로 밀린다는 점을 기억해 두시면 좋습니다.
경로를 바꾸고 싶다면 — -logFile
실행 인자로 로그 경로를 지정할 수 있습니다. QA 머신에서 로그를 한 폴더에 모으고 싶을 때 유용합니다.
Game.exe -logFile C:\qa-logs\run-2026-09-10.txt
배치 파일로 실행 날짜를 파일명에 박아두면 "몇 번째 세션 로그인지" 혼선이 사라집니다.
Android — logcat
Android 는 Player.log 파일이 없고 시스템 로그(logcat)로 나갑니다. USB 연결 후:
adb logcat -s Unity # Unity 태그만 필터
adb logcat -d > bug.txt # 현재 버퍼를 파일로 덤프
logcat 버퍼는 순환식이라 오래 두면 덮입니다 — 버그 목격 직후에 덤프해야 합니다. 케이블 없이 받으려면 게임 쪽에서 Application.persistentDataPath에 자체 로그 파일을 쓰는 구성이 필요합니다(아래 참조).
iOS — Console 또는 Xcode
- 개발 중: Xcode 연결 상태의 콘솔 출력이 가장 정확합니다
- 기기 단독: macOS 의 Console.app 에서 USB 연결된 기기 로그를 볼 수 있습니다
- TestFlight 빌드: 시스템 로그 접근이 사실상 어려워, 자체 파일 로깅 없이는 로그를 받을 방법이 마땅치 않습니다
모바일의 현실적 답 — persistentDataPath 자체 로깅
두 플랫폼 모두 "테스터가 시스템 로그를 뽑아 보낸다"는 절차가 현실적으로 어렵습니다. 게임이 직접 Application.persistentDataPath 아래에 로그 파일을 쓰고, 게임 내에서 공유(업로드·이메일)하는 구성이 실무의 표준입니다. 로그 콜백을 후킹해 파일로 쓰는 최소 구현은 별도 글에 있습니다.
이 절차의 근본 문제
여기까지가 "로그 받는 법"인데, 정리하고 보면 문제가 보입니다. 이 절차는 버그를 본 사람이 OS 별 경로를 알고, prev 로 밀리기 전에, 올바른 파일을 찾아 보내는 성실함에 의존합니다. 단계가 하나라도 어긋나면 로그 없는 티켓이 되고, 그 티켓의 운명은 재현 불가입니다.
그래서 저희는 이 절차를 없애는 쪽을 선택했습니다 — Rekon은 버그 목격 순간 핫키 한 번으로 직전 로그·영상·게임 상태를 자동 수집해 웹으로 올립니다. 파일 경로를 아는 사람이 없어도 로그가 도착합니다.
수동으로 받으시더라도 이 페이지를 팀 위키에 붙여 두시면, "로그 어디 있어요?" 왕복 한 번은 줄어들 겁니다.