---
name: 로컬 애플리케이션 로그 경로
description: qcast-api 로컬 실행 시 logback이 기록하는 로그 파일 위치 — 디버깅/에러 추적 시 직접 읽을 수 있음
type: 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 프로필은 다른 경로 사용 (이 메모리는 로컬 전용)