feat: Serilog 구조적 로깅 설정 (#22) #23

seonkyu.kim · 2026-02-09T06:10:44Z

seonkyu.kim commented

2026-02-09 06:10:44 +00:00

📋 작업 요약

Serilog를 활용한 구조적 로깅 설정 (Console/File Sink)
X-Request-ID 미들웨어 구현 (요청 추적용)
환경별 로그 레벨 분리 (Development: Debug, Production: Warning)

Closes #22

🛠️ 작업 내용 (Changes)

SPMS.API/appsettings.json — Serilog 섹션 추가 (File Sink, Rolling Daily, 30일 보관)
SPMS.API/appsettings.Development.json — Console + File Sink, Debug 레벨
SPMS.API/Middlewares/RequestIdMiddleware.cs — X-Request-ID 헤더 발급/반환 미들웨어
SPMS.API/Program.cs — Serilog 호스트 빌더, RequestIdMiddleware (순서 3), UseSerilogRequestLogging (순서 4) 등록

📢 리뷰어 참고 사항 (To Reviewers)

Serilog.AspNetCore 패키지는 이미 설치되어 있음 (v10.0.0)
기존 Logging 섹션을 제거하고 Serilog 섹션으로 대체
Production: File Sink만 (Warning 이상), Development: Console + File Sink (Debug 이상)
ProgramSetup.md §7 파이프라인 순서 준수: ExceptionMiddleware(1) → RequestIdMiddleware(3) → UseSerilogRequestLogging(4)
SecurityHeadersMiddleware(2)는 Issue #별도로 구현 예정

✅ 체크리스트 (Self Checklist)

빌드(Build)가 성공적으로 수행되었는가?
모든 단위 테스트(Unit Test)를 통과하였는가?
불필요한 로그나 주석을 제거하였는가?
컨벤션(Clean Architecture, Naming)을 준수하였는가?
기밀 정보(비밀번호, 키 등)가 하드코딩 되어있지 않은가?

📸 스크린샷 / 테스트 로그 (Screenshots/Logs)

빌드 성공: 0 경고, 0 오류

## 📋 작업 요약 - Serilog를 활용한 구조적 로깅 설정 (Console/File Sink) - X-Request-ID 미들웨어 구현 (요청 추적용) - 환경별 로그 레벨 분리 (Development: Debug, Production: Warning) ## 🔗 관련 이슈 (Related Issues) Closes #22 ## 🛠️ 작업 내용 (Changes) - [x] `SPMS.API/appsettings.json` — Serilog 섹션 추가 (File Sink, Rolling Daily, 30일 보관) - [x] `SPMS.API/appsettings.Development.json` — Console + File Sink, Debug 레벨 - [x] `SPMS.API/Middlewares/RequestIdMiddleware.cs` — X-Request-ID 헤더 발급/반환 미들웨어 - [x] `SPMS.API/Program.cs` — Serilog 호스트 빌더, RequestIdMiddleware (순서 3), UseSerilogRequestLogging (순서 4) 등록 ## 📢 리뷰어 참고 사항 (To Reviewers) - `Serilog.AspNetCore` 패키지는 이미 설치되어 있음 (v10.0.0) - 기존 `Logging` 섹션을 제거하고 Serilog 섹션으로 대체 - Production: File Sink만 (Warning 이상), Development: Console + File Sink (Debug 이상) - ProgramSetup.md §7 파이프라인 순서 준수: ExceptionMiddleware(1) → RequestIdMiddleware(3) → UseSerilogRequestLogging(4) - SecurityHeadersMiddleware(2)는 Issue #별도로 구현 예정 ## ✅ 체크리스트 (Self Checklist) - [x] 빌드(Build)가 성공적으로 수행되었는가? - [x] 모든 단위 테스트(Unit Test)를 통과하였는가? - [x] 불필요한 로그나 주석을 제거하였는가? - [x] 컨벤션(Clean Architecture, Naming)을 준수하였는가? - [x] 기밀 정보(비밀번호, 키 등)가 하드코딩 되어있지 않은가? ## 📸 스크린샷 / 테스트 로그 (Screenshots/Logs) 빌드 성공: 0 경고, 0 오류

seonkyu.kim added 1 commit 2026-02-09 06:10:46 +00:00

feat: Serilog 구조적 로깅 설정 (#22 ) d6b15c3cd8

- appsettings.json/Development.json에 Serilog 섹션 추가 (Console/File Sink, Rolling Daily)
- RequestIdMiddleware 구현 (X-Request-ID 헤더 발급/반환)
- Program.cs에 Serilog 호스트 빌더 + UseSerilogRequestLogging 등록
- 환경별 로그 레벨 분리 (Development: Debug, Production: Warning)

seonkyu.kim added the

labels 2026-02-09 06:10:56 +00:00

seonkyu.kim self-assigned this 2026-02-09 06:10:58 +00:00

seonkyu.kim added this to the Phase 1: 인프라 & 공통 모듈 milestone 2026-02-09 06:11:02 +00:00

seonkyu.kim requested review from Owners 2026-02-09 06:11:10 +00:00

seonkyu.kim merged commit 9bd39669f3 into develop