Packages

@opentelemetry/core

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

Upgrading @opentelemetry/core From 1.4.0 to 3.1.1

56 releases in betweenevery note read

Reading releases, release notes and advisories…

Other targets from 1.4.0Newest 1.x1.30.1Clears its advisory2.8.0
  1. 1.4.0yours
  2. 35 releases
  3. 2.0.0major
  4. 17 releases
  5. 3.0.0major
  6. 1 release
  7. 3.1.1target
  8. 4 pre

Start here

Before you upgrade

Tick each one off as you go

Security

Fixes 1 advisory affecting 1.4.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

10 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
  • Revert "feat(api): add attributes argument to recordException API #4071"

    1.17.0
  • Revert "feat(minification): Add noEmitHelpers, importHelpers and tslib as a dependency (#3914)" #4011

    1.15.1
  • @opentelemetry/sdk-metrics has been promoted to stable

    1.8.0
  • @opentelemetry/api-metrics has been merged into @opentelemetry/api and deprecated

    1.8.0

114 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.