ivada-infra/DOCS
3
0
Fork 0
Code Issues 1 Pull Requests 5 Actions Packages Projects Releases Wiki Activity

docs: FastAPI 구조 원칙에 로깅 원칙 추가

Browse Source
This commit is contained in:
Claude-51124 2025-11-29 17:08:10 +09:00
parent 5395d694ef
commit 6f257b0308
1 changed files with 14 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
book/300_architecture/311_FastAPI_구조_원칙.md
View File

@ -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 커뮤니티의 다음 모범 사례를 반영하였습니다: