분산 추적 — Micrometer Tracing으로 요청 흐름을 추적하는 방법

Trace (ID: abc123)
├── Span A: API Gateway (20ms)
│   └── Span B: Order Service (150ms)
│       ├── Span C: User Service (30ms)
│       └── Span D: Payment Service (100ms)
│           └── Span E: DB Query (50ms)

<!-- Micrometer Tracing + Brave 브릿지 -->
<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-tracing-bridge-brave</artifactId>
</dependency>

<!-- Zipkin 리포터 -->
<dependency>
    <groupId>io.zipkin.reporter2</groupId>
    <artifactId>zipkin-reporter-brave</artifactId>
</dependency>

<!-- OpenTelemetry 브릿지 (Brave 대신) -->
<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-tracing-bridge-otel</artifactId>
</dependency>
<dependency>
    <groupId>io.opentelemetry</groupId>
    <artifactId>opentelemetry-exporter-zipkin</artifactId>
</dependency>

management:
  tracing:
    sampling:
      probability: 1.0  # 100% 샘플링 (운영에서는 0.1 등으로 조절)
  zipkin:
    tracing:
      endpoint: http://localhost:9411/api/v2/spans

logging:
  pattern:
    level: "%5p [${spring.application.name:},%X{traceId:-},%X{spanId:-}]"

2026-03-19 INFO [order-service,abc123def456,span789012] - 주문 생성 시작
2026-03-19 INFO [order-service,abc123def456,span789012] - 결제 서비스 호출
2026-03-19 INFO [payment-service,abc123def456,span345678] - 결제 처리 중
2026-03-19 INFO [order-service,abc123def456,span789012] - 주문 생성 완료

traceparent: 00-abc123def456-span789012-01

X-B3-TraceId: abc123def456
X-B3-SpanId: span789012
X-B3-ParentSpanId: parentspan123
X-B3-Sampled: 1

@Service
public class OrderService {

    private final WebClient.Builder webClientBuilder;

    public UserInfo getUser(Long userId) {
        // WebClient 호출 시 자동으로 Trace 헤더가 추가됨
        return webClientBuilder.build()
                .get()
                .uri("http://user-service/api/users/{id}", userId)
                .retrieve()
                .bodyToMono(UserInfo.class)
                .block();
    }
}

// Kafka 프로듀서 — 메시지 헤더에 Trace 정보 자동 추가
kafkaTemplate.send("order-events", orderEvent);

// Kafka 컨슈머 — 메시지 헤더에서 Trace 정보 자동 파싱
@KafkaListener(topics = "order-events")
public void handleOrderEvent(OrderEvent event) {
    // 이 메서드 내에서 로그를 찍으면 프로듀서와 같은 Trace ID가 출력됨
    log.info("주문 이벤트 처리: {}", event.getOrderId());
}

# Docker로 간단 실행
docker run -d -p 9411:9411 openzipkin/zipkin

docker run -d --name jaeger \
  -p 16686:16686 \
  -p 4317:4317 \
  jaegertracing/all-in-one:latest

@Service
public class OrderService {

    private final Tracer tracer;

    public Order createOrder(OrderCreateRequest request) {
        // 커스텀 Span 생성
        Span customSpan = tracer.nextSpan().name("validate-order").start();

        try (Tracer.SpanInScope ws = tracer.withSpan(customSpan)) {
            validateOrder(request);
        } finally {
            customSpan.end();
        }

        // 나머지 로직...
    }
}

@Observed(name = "order.validation",
          contextualName = "validate-order")
public void validateOrder(OrderCreateRequest request) {
    // 이 메서드 실행이 자동으로 Span으로 기록됨
}

management:
  tracing:
    sampling:
      probability: 0.1  # 10%만 샘플링