피드로 돌아가기
Dev.toBackend
원문 읽기
slog 기반 Structured Logging으로 장애 복구 시간 단축
Everyone Logs Wrong with slog. 7 Patterns for 3 AM
AI 요약
Context
단순 텍스트 로그 기반의 디버깅 환경으로 인한 장애 분석 병목 현상 발생. Context 정보 부재 및 파편화된 로그 설정으로 인해 장애 발생 시 원인 파악을 위한 단순 검색(grep)에 과도한 시간 소요.
Technical Solution
- slog.Default() 사용 지양 및 InfoContext 도입을 통한 Request-scoped attributes 유지 설계
- slog.String, slog.Int 등 강타입 생성자 활용으로 interface{} boxing으로 인한 오버헤드 제거
- HandlerOptions의 ReplaceAttr와 AddSource를 활용한 중앙 집중형 로그 정책(PII 마스킹, 소스 위치 기록) 수립
- Middleware 단계에서 Logger를 context.Context에 주입하여 서비스 전 계층의 Trace ID 일관성 확보
- LevelVar를 통한 런타임 로그 레벨 동적 변경 구조 설계로 서비스 중단 없는 디버깅 환경 구축
- 서비스 식별자 및 버전 정보를 Base Logger에 내장하여 로그 추적성 강화
실천 포인트
- 로그 출력 시 Who, What, Where, Why가 단일 라인에 포함되었는지 검토 - 패키지 레벨 로거 대신 Context-aware 로거를 주입받아 사용하는지 확인 - 민감 정보 마스킹 및 포맷 설정을 개별 호출부가 아닌 Handler 단계에서 처리하는지 점검 - 런타임에 로그 레벨을 변경할 수 있는 제어 메커니즘 존재 여부 확인