Что такое OpenTelemetry: API, SDK, Collector, OTLP

Четыре части

Через десять минут ты будешь знать, какая из четырёх частей OTel живёт в твоём коде, какая — снаружи, и где именно потянуть рычаг при смене вендора.

До OTel каждый observability-вендор поставлял проприетарный агент — dd-trace Datadog, агент New Relic, Java-agent AppDynamics — и смена вендора означала переписывание инструментации во всех сервисах. Ответ CNCF — OpenTelemetry: четыре части, наслоенные так, что каждая заменима и каждая говорит стабильный контракт.

API — per-language публичные интерфейсы (Java io.opentelemetry.api, Python opentelemetry.trace, Go go.opentelemetry.io/otel). Это то, к чему обращается код приложения и third-party-библиотеки. Намеренно лёгкий: дефолтная реализация — no-op. Код приложения никогда не импортирует vendor-библиотеку — он импортирует OTel API.

SDK — runtime-кусок, превращающий вызовы API в записи телеметрии. SDK владеет sampling-решениями (какие трейсы оставлять), батчингом (когда флашить в exporter) и сериализацией (OTLP wire-формат). Устанавливает application owner, не library author.

Collector — standalone-процесс (бинарь или контейнер), принимающий OTLP, прогоняющий конфигурируемые processor’ы и экспортящий в один или несколько backend’ов. Это policy-слой: tail sampling, redaction, multi-backend routing — всё в YAML, вне приложения.

OTLP (OpenTelemetry Protocol — открытый проводной формат, двоичный protobuf поверх gRPC или HTTP) — wire-формат. Protobuf-кодированные сообщения по gRPC или HTTP, определены в OTel-спеке и стабильны через версии. Любая пара OTel-aware компонентов общается по OTLP.

Почтовая метафора

Представь национальную почтовую систему. API — это почтовый ящик у дома: бросаешь письмо, не знаешь, как оно сортируется. SDK — персонал местного отделения, забирающий письмо, взвешивающий, штампующий, кладущий в нужный исходящий мешок. Collector — региональный сортировочный депо, где письма со множества домов встречаются, батчатся, фильтруются и маршрутизируются по адресу. OTLP — стандартный конверт и адресный формат, понятный каждому депо. Меняешь страну назначения (vendor backend)? Тот же конверт, другая таблица маршрутизации. Когда видишь тикет «переезжаем с Datadog на Honeycomb», эта метафора подсказывает: переписывать нужно только таблицу маршрутизации, но не письма.

История с портабельностью

Антон · Браузер platform-инженер слышит: компания переезжает с Datadog на Honeycomb ради экономии. Паникует: «Нам что, переписывать каждый сервис?» Дима · Origin-сервер backend-разработчик успокаивает: «Мы на OTel — код приложения вызывает только OTel API, SDK эмитит OTLP в Collector, Collector экспортит туда, куда указывает конфиг. Меняем один блок в Collector YAML — exporter, endpoint, API-ключ — и редеплоим. Никаких code-changes». Через два дня миграция готова.