OpenTelemetry 설정 복잡도를 데코레이터 2개로 축소한 Fitz의 Observability 설계

Context

FastAPI 환경에서 Tracing, Metrics, Logs라는 Observability의 세 가지 핵심 신호를 통합하기 위해 다수의 라이브러리와 복잡한 설정 코드가 요구됨. 특히 각 신호 간의 trace_id 상관관계 설정을 개발자가 수동으로 처리해야 하는 높은 운영 공수와 휴먼 에러 가능성이 한계점으로 작용함.

Technical Solution

• 개별 라이브러리 의존성을 제거하고 언어 수준에서 세 가지 신호를 통합 관리하는 Library-first 설계 채택
• HTTP Spans, Access Logs, Metrics를 기본적으로 자동 생성하는 Auto-instrumentation 구조 구현
• @trace 및 @metric 데코레이터를 통한 커스텀 텔레메트리 수집 방식의 단순화
• Log와 Span 사이에 trace_id를 자동 전파하여 수동 Glue Code 없이 신호 간 상관관계를 보장하는 메커니즘 적용
• Secret 타입에 대한 자동 Redaction 처리로 로그 내 민감 정보 유출을 원천 차단하는 보안 계층 통합
• OTel 표준 환경 변수 및 백엔드를 그대로 유지하여 기존 OpenTelemetry 생태계와의 호환성 확보