OpenTelemetry JavaScript SDK 2.0 — релиз с разрывом совместимости, который поднимает базовые версии Node/TS

Основное обновление

OpenTelemetry выпустил JavaScript SDK 2.0 (стабильные пакеты SDK и нестабильное поколение 0.200.x). Этот релиз повышает минимально поддерживаемую версию Node.js до ^18.19.0 || >=20.6.0, требует TypeScript >=5.0.4, изменяет публичные интерфейсы SDK (поэтому SDK и некоторые пакеты инструментирования являются разрушающими), и перемещает целевую компиляцию на ES2022 для улучшения tree-shaking и размера пакета. Руководство по миграции и примечания по обновлению предоставлены поддерживающими. (opentelemetry.io)

Почему это важно

Практически каждый сервис или библиотека на Node/TypeScript, которые полагаются на пакеты SDK OpenTelemetry (трассировка сервера, метрики, автоинструментирование, экспортеры), сталкиваются с нетривиальной миграцией: вы должны убедиться, что ваша среда выполнения (Node) и инструментальная цепочка (TypeScript/tsconfig) соответствуют новым минимальным требованиям, обновить инструментирование поставщика (агенты APM и инструментирования сообщества могут потребовать обновлений) и провести интеграционные тесты, поскольку публичные API SDK изменились. Результатом будут меньшие, более оптимизируемые пакеты, меньше шимов времени выполнения и упрощенная поверхность SDK, что ускорит будущие улучшения — но немедленное влияние будет операционным: поэтапные обновления, изменения в матрице CI и возможные временные несовместимости со старым инструментированием. Если вы поддерживаете библиотеки, которые зависят от @opentelemetry/*, планируйте обновление и публикацию совместимых релизов; если вы запускаете сервисы, запланируйте канарейку после обновления пакетов OTEL и версий Node и следуйте официальному руководству по миграции.

Источник

• Источник