分散トレーシングとは何か、また相関IDはどのように機能するか？

Question

Accepted Answer

**分散トレーシング**は、単一のリクエストが多くのサービスを横断するときの経路を追跡し、エンドツーエンドの経路全体を可視化して、レイテンシーやエラーが発生する箇所を特定できます。**相関/トレースID**は、1つのリクエストのすべてのspanを結びつけます。

## 仕組み

最初のサービスが**トレースID**を生成し、下流のすべての呼び出しがそれ（およびparent **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   ← slow span found here
    Inventory       ├──┤ 15ms
```

## 得られるもの

- **Latency breakdown** — どのサービス/spanが遅いか。
- **Error localization** — どのhopが失敗したか。
- **Dependency map** — 実際には何が何を呼び出しているか。

ツール: OpenTelemetry (instrumentation)、Jaeger / Zipkin (storage + UI)。

## Pitfalls

```text
⚠️ If one service drops the trace header, the trace breaks
⚠️ 100% sampling is expensive — sample, but keep errors
⚠️ Logs are useless across services without the correlation ID attached
```

## なぜ重要なのか

トレーシングなしでは、数十個のサービスを横断する遅い、または失敗したリクエストのデバッグは推測に過ぎません。トレーシングを使用すれば、どのhopが責任を持つのかを正確に見ることができます。

すべてのログ行と呼び出しを通じて相関IDを伝播させることは、マイクロサービスシステムにおいて、最も効果の高いobservabilityへの投資です。