O que é rastreamento distribuído e como funcionam os IDs de correlação?

Question

Accepted Answer

**Rastreamento distribuído** acompanha uma única requisição enquanto ela viaja por muitos serviços, permitindo que você veja o caminho de ponta a ponta e encontre onde ocorrem latência ou erros. Um **ID de correlação/rastreamento** vincula todos os spans de uma requisição.

## Como funciona

O primeiro serviço gera um **trace ID**; toda chamada downstream o propaga (e um **span ID** pai) em headers.

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

## O que você ganha

- **Análise de latência** — qual serviço/span é lento.
- **Localização de erro** — qual hop falhou.
- **Mapa de dependências** — o que realmente chama o quê.

Ferramentas: OpenTelemetry (instrumentação), Jaeger / Zipkin (armazenamento + UI).

## Armadilhas

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

## Por que isso importa

Sem rastreamento, depurar uma requisição lenta ou com falha em uma dúzia de serviços é adivinhação; com ele, você vê exatamente qual hop é o culpado.

Propagar um ID de correlação em cada linha de log e chamada é o investimento de observabilidade de maior alavancagem em um sistema de microsserviços.