distributed tracing이란 무엇이며 correlation ID는 어떻게 동작하나요?

Question

Accepted Answer

**distributed tracing(분산 추적)**은 하나의 요청이 여러 서비스를 거쳐 이동하는 것을 추적하여, 종단 간 경로를 보고 지연이나 오류가 어디서 발생하는지 찾을 수 있게 해줍니다. **correlation/trace ID**가 한 요청의 모든 span을 함께 묶습니다.

## 동작 방식

첫 번째 서비스가 **trace ID**를 생성하고, 모든 다운스트림 호출이 그것을(그리고 부모 **span ID**를) 헤더로 전파합니다.

```http
GET /checkout HTTP/1.1
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
# trace-id ───────────────────────────^   ^── span-id
```

```text
Trace abc123:
  Gateway      ├──────────────────────────────┤ 220ms
   Orders        ├────────────┤ 90ms
    Payments        ├──────┤ 60ms   ← 느린 span 발견
    Inventory       ├──┤ 15ms
```

## 제공하는 것

- **지연 시간 분해** — 어떤 서비스/span이 느린가.
- **오류 위치 파악** — 어떤 홉이 실패했는가.
- **의존성 맵** — 실제로 무엇이 무엇을 호출하는가.

도구: OpenTelemetry(계측), Jaeger / Zipkin(저장 + UI).

## 함정

```text
⚠️ 한 서비스가 trace 헤더를 누락하면 trace가 끊김
⚠️ 100% 샘플링은 비쌈 — 샘플링하되 오류는 유지
⚠️ correlation ID가 붙지 않으면 서비스 간 로그는 쓸모없음
```

## 왜 중요한가

트레이싱이 없으면 십여 개 서비스에 걸친 느리거나 실패하는 요청을 디버깅하는 것은 추측에 불과합니다. 트레이싱이 있으면 어떤 홉이 원인인지 정확히 볼 수 있습니다.

모든 로그 라인과 호출에 correlation ID를 전파하는 것은 마이크로서비스 시스템에서 가장 효과가 큰 단일 관측 가능성 투자입니다.