Что такое OpenTelemetry / tracing?

OpenTelemetry (OTel) — это проект под эгидой CNCF, который предоставляет единые спецификации, API, SDK и инструменты для сбора телеметрии из приложений. Его основная цель — стандартизировать процесс инструментирования, чтобы разработчики могли собирать данные о производительности и поведении своего кода, не привязываясь к конкретной системе мониторинга (например, Jaeger, Zipkin, Prometheus).

Что такое Distributed Tracing?

Трассировка (tracing), особенно распределённая (distributed tracing), — это ключевая часть observability. Когда запрос проходит через несколько сервисов (например, веб-сервер, API-шлюз, сервис аутентификации, базу данных), трассировка позволяет визуализировать этот путь как цепочку связанных операций, называемых спэнами (spans). Каждый спэн представляет одну логическую операцию (например, вызов функции или HTTP-запрос) и содержит метаданные: время начала и окончания, статус, теги (атрибуты) и ссылки на родительские спэны.

Как это работает в OpenTelemetry?

OpenTelemetry реализует трассировку через следующие компоненты:

• API: Определяет интерфейсы для создания спэнов и управления контекстом.
• SDK: Реализация API, которая обрабатывает создание спэнов, их экспорт и конфигурацию.
• Экспортёры (Exporters): Отправляют собранные данные (трассировки, метрики) в бэкенд по выбору (Jaeger, Zipkin, Prometheus и др.).
• Контекст распространения (Context Propagation): Механизм передачи идентификатора трассировки и других метаданных между сервисами (обычно через HTTP-заголовки).

Пример инструментирования кода

Вот простой пример на Node.js с использованием OpenTelemetry для трассировки HTTP-запроса:

const opentelemetry = require('@opentelemetry/api');
const { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');
const { SimpleSpanProcessor } = require('@opentelemetry/sdk-trace-base');
const { JaegerExporter } = require('@opentelemetry/exporter-jaeger');

// Настройка провайдера трассировки
const provider = new NodeTracerProvider();
provider.addSpanProcessor(new SimpleSpanProcessor(new JaegerExporter()));
provider.register();

const tracer = opentelemetry.trace.getTracer('example-tracer');

// Инструментирование функции
async function processOrder(orderId) {
  // Создание нового спэна
  const span = tracer.startSpan('processOrder');
  span.setAttribute('order.id', orderId);
  
  try {
    // Имитация работы
    await new Promise(resolve => setTimeout(resolve, 100));
    span.addEvent('Order processed successfully');
  } catch (error) {
    span.recordException(error);
    span.setStatus({ code: opentelemetry.SpanStatusCode.ERROR });
  } finally {
    span.end(); // Важно: завершить спэн
  }
}

// Вызов функции
processOrder('12345');

Где применяется?

OpenTelemetry и трассировка критически важны в микросервисных и распределённых архитектурах, где сложно отследить полный путь запроса. Они используются для:

• Выявления узких мест производительности (какой сервис или база данных тормозит).
• Отладки ошибок, которые возникают только при взаимодействии нескольких компонентов.
• Анализа зависимостей между сервисами.
• Сбора метрик (например, длительности запросов) для построения дашбордов.

Вывод: OpenTelemetry со встроенной трассировкой стоит применять в любом проекте, состоящем из нескольких взаимодействующих сервисов, чтобы получить полную наблюдаемость (observability) системы, упростить диагностику проблем и повысить надёжность.