qcast-api/.claude/memory/reference_local_log_path.md

name	description	type
로컬 애플리케이션 로그 경로	qcast-api 로컬 실행 시 logback이 기록하는 로그 파일 위치 — 디버깅/에러 추적 시 직접 읽을 수 있음	reference

로컬 프로필(local)로 qcast-api 실행 시 로그 파일 위치 (프로젝트 상대경로):

• 현재 로그: logs/api/local.qcast.api.log (절대경로: /Users/cha/Works/Projects/qcast3/qcast-api/logs/api/local.qcast.api.log)
• 롤링 백업: logs/api/local.qcast.api.YYYY-MM-DD.log (TimeBasedRollingPolicy, 일자별)

설정 위치: src/main/resources/logback/logback-local.xml

• LOG_HOME=./logs/api/ (프로젝트 작업 디렉터리 기준 상대경로)
• 로그 레벨: com.interplug.qcast = DEBUG, root = WARN, Spring Batch/JDBC = DEBUG
• .gitignore에 logs/ 추가됨 (커밋 안 됨)

활용 방법: 사용자가 에러나 동작을 물을 때 로그 파일을 직접 읽어 원인 추적.

• Read /Users/cha/Works/Projects/qcast3/qcast-api/logs/api/local.qcast.api.log
• Bash: tail -n 300 logs/api/local.qcast.api.log
• Grep "ERROR\|Exception" logs/api/local.qcast.api.log

주의:

• 상대경로 ./logs/api/는 앱 실행 시 working directory 기준. IntelliJ/터미널 모두 보통 프로젝트 루트가 기준이므로 정상 동작.
• 만약 working dir이 달라지면 다른 위치에 생성될 수 있음 — 파일이 없으면 사용자에게 실행 위치 확인 요청.
• dev/prd 프로필은 다른 경로 사용 (이 메모리는 로컬 전용)