📚FOS Study
홈카테고리
홈카테고리
📚FOS Study

개발 학습 기록을 정리하는 블로그입니다.

바로가기

  • 홈
  • 카테고리

소셜

  • GitHub
  • Source Repository

© 2025 FOS Study. Built with Next.js & Tailwind CSS

목록으로 돌아가기
☕java/ opentelemetry

OpenTelemetry에서 traceId는 누가 만들까?

약 2분
GitHub에서 보기

OpenTelemetry에서 traceId는 누가 만들까?

  • OpenTelemetry SDK / Instrumentattion이 자동 생성한다.
HTTP 요청 수신
 └─ OTel Instrumentation
     ├─ Trace 생성
     ├─ traceId / spanId 생성
     ├─ Context에 저장
     └─ 다음 처리로 전달
  • 우리가 해야할 일
    • 의존성 추가
    • Instrumentation 활성화
    • Exporter 설정
  • 우리가 안해도 되는 일
    • UUID 생성
    • MDC.put("traceId", ...)
    • 헤더 수동 파싱 / 전파

OTel의 기본 추적 모델

  • Trace / Span 구조
Trace (하나의 요청)
 ├─ Span: HTTP Server
 │   ├─ Span: DB Query
 │   └─ Span: Redis
 └─ Span: HTTP Client (다른 서비스)
  • traceId : 전체 요청을 묶는 ID
  • spanId: 각 작업 단위
  • MDC는 traceId 1개
  • OTel은 정밀한 호출 트리

서비스 간 traceId 전파는 어떻게 하는가?

  • OTel은 표준 헤더를 사용ㄹ함
  • W3C Trace Context
    • traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

    • 자동 생성
    • 자동 파싱
    • 자동 전파
  • 우리가 직접 X-Trace-Id를 만들 필요가 없음

그럼 MDC는 이제 필요 없나?

  • 그렇지 않음. 둘은 역할이 다르다
  • OTel + MDC 관계
역할담당
분산 트레이싱OpenTelemetry
로그 상관관계MDC
시각화Tempo / Jaeger
로그 검색NHN Log & Crash

OTel에서 MDC로 traceId를 넣어주는 구조

  • 보통 이런 흐름이다
OTel Context
   ↓
Logback MDC Bridge
   ↓
로그에 traceId 출력
  • 자동 브릿지
    • Spring Boot + OTel Instrumentattion 사용 시:
      • traceId, spanId 자동으로 MDC에 주입됨
      • 로그에 %X{trace_id} 가능
    • 즉, traceId를 OTel이 만들고, MDC는 로그 출력을 위해 자동으로 받아쓴다

java 카테고리의 다른 글 보기수정 제안하기
목차
  • OpenTelemetry에서 traceId는 누가 만들까?
  • OTel의 기본 추적 모델
  • 서비스 간 traceId 전파는 어떻게 하는가?
  • 그럼 MDC는 이제 필요 없나?
  • OTel에서 MDC로 traceId를 넣어주는 구조