트러블슈팅 FAQ
성능 문제, 브라우저 이슈 등 트러블슈팅 관련 FAQ입니다.
빠른 자가진단
🩺자가진단시작
어떤 문제가 있나요?
성능
대시보드나 특정 화면이 느립니다
PM2 인스턴스 수가 CPU 코어 수와 일치하는지 확인, nginx 정적 파일 캐시 동작 검증, TTFB를 측정하여 성능 병목을 파악합니다.
API 요청이 타임아웃됩니다
nginx proxy_read_timeout 설정 확인, API 서버 직접 호출로 응답 시간 측정, DB 느린 쿼리 로그 검증을 통해 병목을 파악합니다.
서버 메모리 사용량이 지속적으로 높습니다
docker stats로 컨테이너별 메모리 확인, JVM 힙 설정(Xmx) 검증, GC 로그에서 Full GC 반복 또는 OOM 여부를 점검합니다.
브라우저
Firefox 브라우저에서 화면 캡처가 안 됩니다
Firefox는 설계상 화면 캡처를 지원하지 않습니다. Chrome 또는 Edge 브라우저를 사용해주세요.
화면 레이아웃이 예상과 다르게 표시됩니다
브라우저 줌을 100%로 초기화(Ctrl+0), 캐시 강제 삭제(Ctrl+Shift+R), 화면 해상도 및 콘솔 에러를 확인하여 CSS 로딩 이상을 검증합니다.
Chrome에서 화면 캡처 버튼이 실패합니다
User-Agent 확인(스푸핑 여부), 캡처 대상 요소(#capture_body) 존재 검증, 브라우저 메모리 사용량(500MB 초과 시 재시작), 광고 차단기 등 확장 프로그램 비활성화를 확인합니다.