OpenTelemetry JS SDK 3.0 çıktı, Node.js 18 ve 20 desteği kalktı

OpenTelemetry JS SDK için 3.0 sürümü yayımlandı: stable paketler v3.0.0, experimental paketler v0.300.0 numarasını aldı, API ise 1.10.0 oldu. Yeni sürüm Node.js 18 ve 20 desteğini bırakıyor, Logs sinyalini stable ilan ediyor ve birçok deprecated paketi kaldırıyor. Stable 2.x paketleri 3.0.0 sürümünden itibaren bir yıl daha destek alacak.

OpenTelemetry nedir, ne işe yarar?

OpenTelemetry, uygulamalardan trace, metric ve log verisi toplamak için geliştirilen açık kaynak bir standart ve SDK ailesidir. Uygulamayı belirli bir izleme sağlayıcısına bağlamadan telemetri üretmeye yarar; toplanan veri farklı backend’lere gönderilebilir. CNCF bünyesindeki projeyi bulutta çalışan servisleri izleyen ekipler yaygın olarak kullanır. OpenTracing ve OpenCensus projelerinin birleşmesiyle ortaya çıktı.

Node.js 20 üzerinde OpenTelemetry ile observability verisi topluyorsanız bu sürüme henüz geçemezsiniz. OpenTelemetry JS SDK 3.0 en az Node.js 22.15.0 istiyor; 18 ve 20 desteği kalktı.

OpenTelemetry JS SDK yükseltmesinde üç breaking change

• Runtime tabanı yükseldi. Node.js 20 Nisan 2026’da end-of-life oldu; servislerinizin image’larını önce 22.15.0 veya üstüne taşıyın.
• @opentelemetry/api-logs paketi @opentelemetry/api içine katıldı. Logs artık stable; log’ları eski paketten import eden kodu değiştirmeniz gerekecek.
• @opentelemetry/exporter-jaeger, @opentelemetry/propagator-jaeger, @opentelemetry/shim-opentracing ve @opentelemetry/shim-opencensus kaldırıldı. Tracing SDK paketleri de @opentelemetry/sdk-trace altında birleşti, bazı tip ve sınıf adları değişti.

Yükseltme sırası

Önce Node.js sürümünü kontrol edin, sonra bağımlılık ağacında kaldırılan paketleri arayın:

node --version
npm ls @opentelemetry/api-logs @opentelemetry/exporter-jaeger

Stable paketleri 3.x’e, experimental paketleri 0.300.x’e taşıyın; contrib paketleri de 3.x’e göre yeniden yayımlandı, onları aynı anda güncelleyin. @opentelemetry/auto-instrumentations-node ile zero-code instrumentation kullanıyorsanız kod değişikliği gerekmiyor.

Acele etmeniz için neden yok: OpenTelemetry JS SDK 2.x stable paketleri bir yıl daha destek alıyor. Jaeger exporter veya OpenTracing shim kullanıyorsanız bu süreyi taşıma işine ayırın.