Packages

@opentelemetry/core

3.1.1 · 9 Nov 2026Apache-2.0229.6M / weekRepositoryHomepagenpmAtom feed

Upgrading @opentelemetry/core From 1.26.0 to 3.1.1

26 releases in betweenevery note read

Reading releases, release notes and advisories…

Other targets from 1.26.0Newest 1.x1.30.1Clears its advisory2.8.0
  1. 1.26.0yours
  2. 5 releases
  3. 2.0.0major
  4. 7 releases
  5. 2.6.0breaking
  6. 9 releases
  7. 3.0.0major
  8. 3.1.0breaking
  9. 3.1.1target
  10. 4 pre

Start here

Before you upgrade

Tick each one off as you go

Security

Fixes 1 advisory affecting 1.26.0

Release by release

  1. 3.1.1

    9 Nov 20261 fix
    • Fixed

      resources: Specify full path for ioreg command on Darwin, and kenv command on BSD for host.id @trentm

  2. 3.1.0

    Migration needed5 Nov 20261 new · 3 fixes
    • Breaking

      Raise the minimum @opentelemetry/api peer dependency version to 1.10.0 for packages that depend on @opentelemetry/core, @opentelemetry/otlp-transformer or @opentelemetry/instrumentation, as these use API 1.10 features. (#7258) @volodymyrshk @pichlermarc

    • Deprecated

      resources: Deprecate envDetector in favor of separate resourceAttributesEnvDetector and serviceNameEnvDetector. Also mark serviceInstanceIdDetector as stable (the service.instance.id semconv attribute is now stable). #6999

    • New

      sdk-logs, sdk-trace: Wait for each distinct pending resource once per batch instead of once per record #7208

    • Fixed

      context-zone: Declare the @opentelemetry/api peer dependency so Yarn PnP can resolve it for context-zone-peer-dep #7268

    • Fixed

      core: Accept attribute values with shared (non-circular) object references #7068

    • Fixed

      propagator-b3: Reject trace ids that are not 16 or 32 characters long #7262

  3. 3.0.0

    Migration needed20 Oct 20261 new · 13 fixes
    • Breaking

      sdk-trace-node: Remove the @opentelemetry/sdk-trace-node package #7054

    • Breaking

      shim-opentracing: Remove the @opentelemetry/shim-opentracing package

    • Breaking

      context-async-hooks: Remove the unused class AsyncHooksContextManager #7078

    • Breaking

      Migrate package builds from tsc to tsdown, emitting dual CJS/ESM output from a single dist/ directory and declaring an exports map on every package #6293

  4. 2.12.0 – 2.12.12 releases, nothing new or fixed in the notes

  5. 2.11.0

    31 Aug 20263 new · 1 fix
    • New

      context-async-hooks: Implement attach() on AsyncLocalStorageContextManager #6845

    • New

      sdk-trace: Allow configuring the force flush timeout per call #6929 @LarryHu0217

    • New

      sdk-metrics: Reuse a single DataView for exponential histogram bit reads #6998

    • Fixed

      sdk-metrics: Ignore Infinity in exponential histograms #7015

  6. 2.10.0

    21 Jul 20263 new · 2 fixes
    • New

      sdk-logs: Implement log processor metrics #6554

    • New

      otlp-exporter: Implement exporter metrics #6480

    • New

      propagator-jaeger: Notice: The @opentelemetry/propagator-jaeger package will be removed in SDK 3.x, planned for approximately September 2026. @pichlermarc

    • Fixed

      sdk-trace: Reject SimpleSpanProcessor.forceFlush() when a pending export fails #6771

    • Fixed

      sdk-trace: Include trace IDs at the ratio 1 upper bound in TraceIdRatioBasedSampler #6890

  7. 2.9.0

    2 Jul 20266 new · 1 fix
    • New

      sdk-metrics: Add maxExportBatchSize option to PeriodicExportingMetricReader #6655

    • New

      sdk-trace: Implement span processor metrics #6504

    • New

      sdk-trace: Add a new "sdk-trace" package to hold the Trace SDK, without environment variable configuration handling that belongs elsewhere #6775

    • New

      sdk-trace: Add AlwaysRecordSampler #6188

    • New

      sdk-metrics: Defer allocation of HrTime to accumulation creation #6839

    • New

      sdk-metrics: Optionally capture active context for sync instruments #6848

    • Fixed

      propagator-jaeger: Do not throw on malformed percent-encoded uber-trace-id / uberctx-* headers during extract @pichlermarc

  8. 2.8.0

    11 Jun 20262 new · 1 fix
    • New

      sdk-trace-base: pretty-print SpanImpl, Tracer, and BasicTracerProvider via util.inspect so they render through diag and console.log #6690

    • New

      sdk-metrics: Implement metric reader self-observability metrics #6449

    • Fixed

      core: Limit processing of incoming "baggage" header to 8192 bytes @pichlermarc

6 other lines we could not sort, mostly version bumps
  • The minimum supported Node.js has been raised to >=22.15.0. This means that support for Node.js 18 and 20 has been dropped.

    3.0.0
  • The public interface has changed

    3.0.0
  • Only experimental versions 0.300.0 are compatible with this release

    3.0.0
  • The minimum supported Node.js has been raised to ^18.19.0 || >=20.6.0. This means that support for Node.js 14 and 16 has been dropped.

    2.0.0
  • The compilation target for transpiled TypeScript has been raised to ES2022 (from ES2017).

    2.0.0
  • Only experimental versions 0.200.0 are compatible with this release

    2.0.0

78 internal lines (docs, tests, tooling) left out.

A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.