로깅과 요청 ID 미들웨어
구조화된 로깅과 추적 ID 주입
로깅과 요청 ID 미들웨어은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
구조화된 로그 기록이 필요한 이유
일반 텍스트 로그는 규모가 커지면 구문 분석하기 어렵습니다. 구조화된 로그 기록(JSON 또는 key=value)을 사용하면 로그 집계기(Datadog, Loki, ELK)가 필드별로 항목을 필터링하고 서로 연관 지을 수 있습니다.
요청 ID 생성
미들웨어에서 요청마다 고유한 ID(UUID 또는 ULID)를 생성하고 응답 헤더와 Context에 연결합니다:
func RequestID(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
id := r.Header.Get("X-Request-ID")
if id == "" { id = uuid.New().String() }
w.Header().Set("X-Request-ID", id)
ctx := context.WithValue(r.Context(), reqIDKey{}, id)
next.ServeHTTP(w, r.WithContext(ctx))
})
}slog를 사용한 로그 기록 미들웨어
Go 1.21에는 구조화된 로그 기록을 위한 log/slog가 추가되었습니다. 미들웨어 내부에서 사용합니다:
func StructuredLogger(logger *slog.Logger) func(http.Handler) http.Handler {
return func(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
cw := &captureWriter{ResponseWriter: w}
next.ServeHTTP(cw, r)
logger.Info("request",
"method", r.Method,
"path", r.URL.Path,
"status", cw.status,
"latency_ms", time.Since(start).Milliseconds(),
"request_id", r.Context().Value(reqIDKey{}),
)
})
}
}captureWriter
ResponseWriter를 감싸 처리기가 작성한 상태 코드를 캡처합니다:
type captureWriter struct {
http.ResponseWriter
status int
}
func (cw *captureWriter) WriteHeader(code int) {
cw.status = code
cw.ResponseWriter.WriteHeader(code)
}
func (cw *captureWriter) Status() int {
if cw.status == 0 { return http.StatusOK }
return cw.status
}모든 로그 줄에 요청 ID 추가
ID가 미리 채워진 요청별 하위 Logger를 만든 다음 Context에 저장합니다:
reqLogger := logger.With("request_id", id)
ctx := context.WithValue(r.Context(), loggerKey{}, reqLogger)Context에서 Logger 가져오기
어떤 처리기나 서비스에서든 요청 범위 Logger를 가져오는 도우미입니다:
func LoggerFromContext(ctx context.Context) *slog.Logger {
l, ok := ctx.Value(loggerKey{}).(*slog.Logger)
if !ok { return slog.Default() }
return l
}로그 수준
적절한 수준을 사용하십시오. 디버그 수준은 개발 중 상세한 출력에, Info는 요청 요약에, 경고 수준은 복구 가능한 이상에, Error는 조치가 필요한 실패에 사용합니다. 민감한 필드(토큰, 비밀번호)는 기록하지 마십시오.
지연 시간 구간
모든 로그 줄에 요청 지연 시간을 포함합니다. 메트릭 시스템(Prometheus)에서 이를 히스토그램 구간으로 집계하여 P50/P95/P99 백분위수를 추적합니다.
마이크로서비스의 상관관계 ID
분산 추적 시스템 전체를 도입하지 않고도 분산 추적을 활성화하려면, 수신 요청의 X-Request-ID 헤더를 모든 발신 HTTP 및 gRPC 호출에 전달합니다.
로그 샘플링
트래픽이 많은 서비스에서는 디버그/정보 로그를 샘플링합니다(예: 디버그 수준에서 요청 100개 중 1개만 기록). 이렇게 하면 오류 로그는 모두 유지하면서 저장 비용을 줄일 수 있습니다.
zap과 slog 비교
zap(Uber)은 처리량이 높은 서비스에서 slog보다 빠르지만 설정이 더 많이 필요합니다. slog는 표준 라이브러리이며 이식성이 좋고 대부분의 서비스에 충분합니다. 벤치마크에서 병목이 확인되지 않는 한 slog를 우선 사용합니다.
빠른 확인
로깅 미들웨어에서 captureWriter가 필요한 이유는 무엇입니까?
요약: 로깅 및 요청 ID
핵심 내용:
- 미들웨어에서 X-Request-ID를 생성하거나 전달하고 컨텍스트에 저장합니다
- 키-값 필드를 사용하는 구조화된 로그에 slog를 사용합니다
- captureWriter가 상태 코드를 가로채 핸들러 이후 로깅에 사용합니다
- 모든 다운스트림 호출에 상관관계 ID를 전달합니다
AI 튜터와 함께 Go을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 51
- 레슨
- 203
자주 묻는 질문
“로깅과 요청 ID 미들웨어” 강의는 무료인가요?
네 — “로깅과 요청 ID 미들웨어” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“로깅과 요청 ID 미들웨어”에서 뭘 배우나요?
구조화된 로깅과 추적 ID 주입 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Go Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“로깅과 요청 ID 미들웨어” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- HTTP 미들웨어 체인 기초
- 로깅과 요청 ID 미들웨어
- 인증과 요청률 제한 미들웨어
- CORS와 패닉 복구 미들웨어