[Research] OpenTelemetry 및 분산 Trace 확장 구조 검토

[jhKim521]

배경

FlowTool v1은 하나의 HTTP 요청과 응답을 하나의 Capture Log로 저장한다.

여러 서비스가 연결된 환경에서는
각 서비스의 요청을 하나의 흐름으로 묶어 확인할 필요가 있다.

다만 분산 Trace는 현재 Proxy Capture 구조보다 복잡도가 크게 증가하므로,
바로 구현하기 전에 기술 검토와 범위 정의가 필요하다.

목표

FlowTool의 기존 Proxy Capture 구조를 유지하면서
분산 Trace 또는 OpenTelemetry를 연동할 수 있는 확장 방향을 조사한다.

조사 항목

• Trace ID 및 Span ID 모델
• 서비스 간 Header 전파 방식
• OpenTelemetry Collector 연동 가능성
• 기존 Capture Log와 Span의 관계
• Trace 목록 및 상세 화면 구조
• SDK 연동 범위
• 저장 데이터 증가량
• 성능 및 운영 부담
• 기존 Proxy 방식과의 역할 구분

완료 조건

• 현재 구조와 OpenTelemetry 구조를 비교한다.
• 필요한 데이터 모델 초안을 작성한다.
• 기존 Capture Log와의 연계 방식을 정한다.
• 최소 PoC 범위를 정의한다.
• 구현 여부와 우선순위를 결정한다.
• 검토 결과를 설계 문서로 남긴다.