Архитектура Jaeger

Путь трейса от вашего кода до экрана Jaeger: SDK → (опционально Collector) → приём → хранилище → query/UI. Понимание этой цепочки нужно, чтобы осознанно выбирать варианты деплоя и знать, где что ломается.

Путь трейса

приложение (OTel SDK) ──OTLP──► [ OTel Collector ] ──► [ Jaeger backend ] ──► хранилище
                                       │                     ▲
                                       │ пайплайны: батчинг,     │
                                       │ сэмплирование,          │
                                       │ PII-фильтры             │
                                       ▼                     │
                                  Kafka ◄────────────────────┘ (опционально: буферизация)

1. OTel SDK в приложении создаёт спаны, буферизует и экспортирует их по OTLP (gRPC 4317 / HTTP 4318);
2. OpenTelemetry Collector (опционален, но почти всегда есть в проде) — общий шлюз: принимает OTLP от всех сервисов, делает батчинг, сэмплирование, маскирование данных, маршрутизацию в один или несколько бэкендов;
3. Jaeger backend — компоненты приёма (receiver), нормализации и записи в хранилище;
4. Jaeger query + UI — поиск по хранилищу и визуализация (порт 16686).

Варианты деплоя

Ключевые порты (all-in-one)

💡 UDP-порты 6831/6832 вы встретите в старых гайдах — это jaeger-agent из архитектуры v1. Агент устарел: его роль (client-side буфер и декорация) теперь делает OTel SDK + Collector sidecar/daemonset.

Jaeger v1 vs v2 — что важно знать

• v1 — историческая архитектура: jaeger-collector, jaeger-query, jaeger-agent, jaeger-ingester (чтение из Kafka). Каждая часть — отдельный процесс и конфиг;
• v2 (с 2024) — Jaeger переписан как дистрибуция OpenTelemetry Collector: один бинарник jaeger, конфигурация в OTel-стиле (receivers/processors/exporters/pipelines), плюс компоненты Jaeger (хранилище, query). Приём — OTLP как основной; jaeger.thrift — по остаточному принципу;
• Практический вывод курса: учим OTLP + OTel Collector, потому что это и есть современный Jaeger. Пример конфига v2:

  # config.yaml Jaeger v2 (сокращённо)
  receivers:
    otlp:
      protocols:
        grpc: {}
        http: {}
  exporters:
    otlp/jaeger-storage:
      endpoint: jaeger-storage:4317
      tls:
        insecure: true
  service:
    pipelines:
      traces:
        receivers: [otlp]
        exporters: [otlp/jaeger-storage]

Кто за что отвечает (и кто виноват при проблеме)

Практика

1. Запустите all-in-one и найдите в его логах, какие receivers подняты (docker logs jaeger | grep -i receiver).
2. Занесите в шпаргалку карту портов из этого урока — она понадобится в каждом практикуме.
3. Прочитайте страницу архитектуры на jaegertracing.io (Architecture) и сверьте со схемой урока: что совпало, что изменилось в свежих версиях.