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

Компания переходит на другой observability-backend ради экономии. При vendor-SDK, зашитом в каждый сервис, оценка миграции — четыре инженер-недели. С OTel — один день: меняешь exporter-блок в конфиге Collector’а, перезапускаешь его. Всё.

Четыре части

До 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 — wire-формат. Protobuf-кодированные сообщения по gRPC или HTTP, определены в OTel-спеке и стабильны через версии. Любая пара OTel-aware компонентов общается по OTLP.

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

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

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

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