diff --git a/book/300_architecture/311_FastAPI_구조_원칙.md b/book/300_architecture/311_FastAPI_구조_원칙.md index fd5726c..d5efb2c 100644 --- a/book/300_architecture/311_FastAPI_구조_원칙.md +++ b/book/300_architecture/311_FastAPI_구조_원칙.md @@ -208,7 +208,20 @@ from app.services import coldmail_filter # ✅ 모듈 import # 긴급 수정: 2025-10-02, 사유: DB 장애 복구 ``` -## 11. 모범 사례 참고 +## 11. 로깅 원칙 + +**로그 레벨 사용 기준** (Python logging 공식 문서): +- **DEBUG**: 개발/디버깅용 상세 정보 (중간 과정, 내부 상태) +- **INFO**: 정상 동작 및 주요 이벤트 (시작/종료, 주요 단계) +- **WARNING**: 잠재적 문제 (예상치 못한 상황, 성능 저하 가능성) +- **ERROR**: 오류 발생 (기능 실패, 예외 처리) + +**규칙**: +- 시작/종료는 반드시 INFO 레벨 +- 중간 과정은 DEBUG 레벨 +- 프로덕션에서는 INFO 기본, DEBUG는 필요 시에만 활성화 + +## 12. 모범 사례 참고 본 문서는 FastAPI 커뮤니티의 다음 모범 사례를 반영하였습니다: