Что такое распределённое трассирование и как работают correlation ID?

Question

Accepted Answer

**Распределённое трассирование** отслеживает один запрос по мере его прохождения через множество сервисов, позволяя увидеть полный путь и найти, где возникает задержка или ошибки. **Correlation/trace ID** связывает все spans одного запроса вместе.

## Как это работает

Первый сервис генерирует **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   ← slow span found here
    Inventory       ├──┤ 15ms
```

## Что это даёт

- **Разбор задержек** — какой сервис/span медленный.
- **Локализация ошибок** — какой переход привёл к сбою.
- **Карта зависимостей** — что на самом деле вызывает что.

Инструменты: OpenTelemetry (инструментирование), Jaeger / Zipkin (хранилище + UI).

## Подводные камни

```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
```

## Почему это важно

Без трассирования отладка медленного или несработавшего запроса через десяток сервисов — это угадывание; с ним вы видите точно, какой переход виноват.

Пропагация correlation ID через каждую строку лога и вызов — это наиболее высокоэффективное вложение в наблюдаемость микросервисной системы.