PackageTrack

npm · #4282

@opentelemetry/sdk-node

0.221.0open-telemetry/opentelemetry-js ↗

OpenTelemetry SDK for Node.js

Release timeline

248 releases since 2020
202120222023202420252026

Releases

  1. 0.221.021 Jul 2026
    Release notes

    💥 Breaking Changes

    • feat(sdk-logs)!: configure the force flush timeout per call #6931 @LarryHu0217

    • (user-facing): LoggerProviderOptions.forceFlushTimeoutMillis has been removed; pass timeoutMillis to LoggerProvider.forceFlush() instead.

    • feat(instrumentation-http)!: emit only stable HTTP semantic conventions. The OTEL_SEMCONV_STABILITY_OPT_IN environment variable no longer changes HTTP attribute or metric emission — old (v1.7.0) and duplicate ( http / http/dup ) semconv outputs have been removed. #6819 @maryliag

    • feat(instrumentation-fetch)!: emit only stable HTTP semantic conventions. The semconvStabilityOptIn instrumentation config option has been removed; old (v1.7.0) and duplicate semconv outputs are no longer emitted. #6819 @maryliag

    • feat(instrumentation-xml-http-request)!: emit only stable HTTP semantic conventions. The semconvStabilityOptIn instrumentation config option has been removed; old (v1.7.0) and duplicate semconv outputs are no longer emitted. #6819 @maryliag

    • feat(instrumentation-grpc)!: emit only stable network semantic conventions. The OTEL_SEMCONV_STABILITY_OPT_IN environment variable no longer changes attribute emission — net.peer.name and net.peer.port (old) are no longer set; only server.address and server.port (stable). #6819 @maryliag

    🚀 Features

    • feat(sdk-logs): allow modifying ReadWriteLogRecord properties (including hrTime, hrTimeObserved, and spanContext) in accordance with the OpenTelemetry Logs specification #6923 @Babul422

    • feat(sdk-node): emit a deprecation warning when the JaegerPropagator is selected via OTEL_PROPAGATORS or declarative config; use tracecontext instead. @pichlermarc

    • feat(instrumentation-http): set error.type to status code in metrics for error requests. #6919 @raphael-theriault-swi

    Contributors

    maryliag, pichlermarc, and 3 other contributors

    Assets 3 Loading

    Uh oh!

    There was an error while loading. Please reload this page .

    All reactions

    Open source →
  2. 0.220.02 Jul 2026
    Release notes

    💥 Breaking Changes

    • refactor(sdk-logs)!: refactor BatchLogRecordProcessor constructor signature #6817 @trentm

    • (user-facing): BatchLogRecordProcessor now takes a single options object with all possible properties, instead of two separate arguments. For example, before new BatchLogRecordProcessor(exporter, { maxQueueSize: 1000 }) , after new BatchLogRecordProcessor({ exporter, maxQueueSize: 1000 }) .

    • interface BufferConfig -> interface BatchLogRecordProcessorOptions , and now includes the exporter property

    • interface BatchLogRecordProcessorBrowserConfig -> interface BatchLogRecordProcessorBrowserOptions

    • (user-facing): SimpleLogRecordProcessor now takes a single options object with all possible properties. For example, before new SimpleLogRecordProcessor(exporter) , after new SimpleLogRecordProcessor({ exporter }) . #6836

    • refactor(configuration)!: change config file parsing to not add default values, nor merge *_list fields #6765 @trentm

    • Responsibility for handling declarative config "nullBehavior" and "defaultBehavior" belongs in the "create" handling, currently in the "sdk-node" package.

    • docs(shim-opencensus): Notice : The @opentracing/shim-opencensus package will be removed in SDK 3.x, planned for approximately September 2026.

    • The OpenCensus and OpenTracing compatibility requirements in the OpenTelemetry specification have been deprecated.

    • chore(sdk-node)!: Drop support for deprecated OpenCensusMetricProducer from declarative config

    🚀 Features

    • feat(configuration): bump config schema to v1.1.0; rename without_scope_info → scope_info_enabled and without_target_info/development → target_info_enabled/development on the Prometheus pull exporter (semantics inverted), rename with_resource_constant_labels → resource_constant_labels . Validate file_format per the configuration versioning spec: accept any minor version of major 1 (e.g. 1.0 , 1.1 ), warn when the minor version is newer than supported, and reject other major versions. #6781 @MikeGoldsmith

    • feat(sdk-node): wire up id_generator from declarative config #6782 @MikeGoldsmith

    • feat(sdk-node): wire up tracer_provider.sampler from declarative config (always_on, always_off, trace_id_ratio_based, parent_based); unrecognized variants warn and fall back to ParentBased(AlwaysOn) #6506 @MikeGoldsmith

    • feat(propagator-env-carrier): empty name normalization #6827 @pellared

    • feat(propagator-env-carrier): make EnvironmentGetter read the current process.env #6853 @pellared

    🐛 Bug Fixes

    • fix(sdk-logs): stop Logger.emit() doing work (record construction, metrics, processor onEmit ) after the LoggerProvider has shut down #6826 @anneheartrecord

    • fix(sdk-node): pass all config properties (endpoint, headers, timeout, TLS, compression, temporality preference, default histogram aggregation) to OTLP metric exporters in declarative config #6814 @MikeGoldsmith

    • fix(sdk-logs): default BatchLogRecordProcessor scheduleDelayMillis is 1000 #6796 @trentm

    • fix(configuration): percent-decode keys and values in resource.attributes_list per spec #6787 @MikeGoldsmith

    • fix(configuration): default log_level to info in env-based config initialization for consistency with file-based config #6788 @MikeGoldsmith

    • fix(sdk-node): fail-fast on LoggerProvider creation with startNodeSDK() and declarative config #6785 @trentm

    📚 Documentation

    • docs(configuration): link the configuration README to the cross-SDK declarative config language support status doc #6809 @MikeGoldsmith

    🏠 Internal

    • chore(sdk-node): migrate to use the new sdk-trace package #6828 @trentm

    • The node re-export of @opentelemetry/sdk-trace-node and tracing re-export of @opentelemetry/sdk-trace-base have been deprecated. (Historically the @opentelemetry/sdk-node package has re-exported from a number of core packages . It is now recommended that users directly import from those other packages.)

    • chore(*): migrate use of sdk-trace-base and sdk-trace-node to sdk-trace #6851 @trentm

    • fix(instrumentation,instrumentation-http): fix codecov coverage under-reporting by merging coverage across CJS/ESM test runs #6867 @mwear

    Contributors

    trentm, mwear, and 3 other contributors

    Assets 3 Loading

    Uh oh!

    There was an error while loading. Please reload this page .

    All reactions

    Open source →
  3. 0.219.011 Jun 2026
    Release notes

    💥 Breaking Changes

    • fix(configuration)!: stop removing null values from parsed config object #6679 @trentm

    • It is now the responsibility of the user of a parsed declarative config object, typically just the sdk-node package, to handle null values.

    • fix(api-logs)!: Removed NOOP_LOGGER and NoopLogger exports from @opentelemetry/api-logs . Use createNoopLogger(): Logger instead. #6713 @dyladan

    • feat(api-logs)!: rename scopeAttributes to attributes in LoggerOptions #6573 @pichlermarc

    • fix(sdk-node)!: remove buildSamplerFromConfig export #6784 @trentm

    🚀 Features

    • feat(sdk-node): wire up metric producers from declarative config #6712 @MikeGoldsmith

    • feat(sdk-logs)!: add support for attributes in LoggerOptions #6573 @pichlermarc

    🐛 Bug Fixes

    • fix(sdk-node): pass all config properties to log record exporters in declarative config #6708 @MikeGoldsmith

    • fix(sdk-node): warn and ignore zero exporter timeout in declarative config #6711 @MikeGoldsmith

    • fix(sdk-node): pass gRPC credentials and headers to span exporter in declarative config #6705 @MikeGoldsmith

    • fix(otlp-transformer): do not attempt to skip groups #6704 @pichlermarc

    • fix(otlp-grpc-exporter-base): recreate client after 5 consecutive DEADLINE_EXCEEDED to recover from connection dropped deadlock #6296 @afharo

    • fix(browser-detector): use the right semantic convention for user agent resource attribute #6729 @david-luna

    • fix(browser-detector): user agent resource attribute always #6754 @david-luna

    • fix(opentelemetry-exporter-prometheus): handle additional edge cases in metric name conversion #6727 @cjihrig

    • fix(sdk-logs): avoid null dereference in BatchLogRecordProcessor._flushAll when an in-flight export completes between awaits #6763 @Janealter

    • fix(configuration): improve environment variable substitution to handle all the cases shown in the spec #6757 @trentm

    📚 Documentation

    • docs(otlp-exporter-base): index the package's public API in generated docs so types like OTLPExporterNodeConfigBase resolve and link from consumer exporter pages #6725 @devareddy05

    🏠 Internal

    • refactor(configuration): remove redundant env var parsing in EnvironmentConfigFactory #6710 @MikeGoldsmith

    Contributors

    trentm, david-luna, and 7 other contributors

    Assets 3 Loading

    Uh oh!

    There was an error while loading. Please reload this page .

    All reactions

    Open source →
  4. 0.218.013 May 2026
    Release notes

    🚀 Features

    • feat(otlp-transformer): replace protobufjs metrics serialization with custom implementation #6625 @pichlermarc

    • feat(configuration): show all config validation errors, if there are multiple #6683 @trentm

    • feat(sdk-node): allow startNodeSDK() without an arg #6688 @trentm

    🏠 Internal

    • refactor(sdk-logs): alias LoggerProviderConfig to LoggerProviderOptions #6691 @david-luna

    • refactor(sdk-logs): use Logger.enabled() within Logger.emit() implementation #6680 @david-luna

    Contributors

    trentm, david-luna, and pichlermarc

    Assets 3 Loading

    Uh oh!

    There was an error while loading. Please reload this page .

    ❤️ 1 Johoseph reacted with heart emoji All reactions

    • ❤️ 1 reaction

    1 person reacted

    Open source →
  5. 0.217.06 May 2026

    Nothing published for this version

  6. 0.216.029 Apr 2026

    Nothing published for this version

  7. 0.215.017 Apr 2026

    Nothing published for this version

  8. 0.214.025 Mar 2026

    Nothing published for this version

  9. 0.213.03 Mar 2026

    Nothing published for this version

  10. 0.212.012 Feb 2026

    Nothing published for this version

  11. 0.211.021 Jan 2026

    Nothing published for this version

  12. 0.210.014 Jan 2026

    Nothing published for this version

  13. 0.209.08 Jan 2026

    Nothing published for this version

  14. 0.208.06 Nov 2025

    Nothing published for this version

  15. 0.207.021 Oct 2025

    Nothing published for this version

  16. 0.206.06 Oct 2025

    Nothing published for this version

  17. 0.205.010 Sept 2025

    Nothing published for this version

  18. 0.204.04 Sept 2025

    Nothing published for this version

  19. 0.203.09 Jul 2025

    Nothing published for this version

  20. 0.202.02 Jun 2025

    Nothing published for this version

  21. 0.201.119 May 2025

    Nothing published for this version

  22. 0.201.015 May 2025

    Nothing published for this version

  23. 0.200.017 Mar 2025

    Nothing published for this version

  24. 0.200.0-rc.112 Mar 2025pre-release

    Nothing published for this version

  25. 0.200.0-dev.15 Mar 2025pre-release

    Nothing published for this version

  26. 0.200.0-dev.024 Feb 2025pre-release

    Nothing published for this version

  27. 0.57.213 Feb 2025

    Nothing published for this version

  28. 0.57.114 Jan 2025

    Nothing published for this version

  29. 0.57.018 Dec 2024

    Nothing published for this version

  30. 0.56.04 Dec 2024

    Nothing published for this version

  31. 0.55.018 Nov 2024

    Nothing published for this version

  32. 0.54.27 Nov 2024

    Nothing published for this version

  33. 0.54.15 Nov 2024

    Nothing published for this version

  34. 0.54.023 Oct 2024

    Nothing published for this version

  35. 0.53.028 Aug 2024

    Nothing published for this version

  36. 0.52.120 Jun 2024

    Nothing published for this version

  37. 0.52.05 Jun 2024

    Nothing published for this version

  38. 0.51.17 May 2024

    Nothing published for this version

  39. 0.51.024 Apr 2024

    Nothing published for this version

  40. 0.50.03 Apr 2024

    Nothing published for this version

  41. 0.49.129 Feb 2024

    Nothing published for this version

  42. 0.49.029 Feb 2024

    Nothing published for this version

  43. 0.48.026 Jan 2024

    Nothing published for this version

  44. 0.47.015 Jan 2024

    Nothing published for this version

  45. 0.46.014 Dec 2023

    Nothing published for this version

  46. 0.45.18 Nov 2023

    Nothing published for this version

  47. 0.45.07 Nov 2023

    Nothing published for this version

  48. 0.44.010 Oct 2023

    Nothing published for this version

  49. 0.43.012 Sept 2023

    Nothing published for this version

  50. 0.42.011 Sept 2023

    Nothing published for this version

  51. 0.41.28 Aug 2023

    Nothing published for this version

  52. 0.41.124 Jul 2023

    Nothing published for this version

  53. 0.41.06 Jul 2023

    Nothing published for this version

  54. 0.40.06 Jun 2023

    Nothing published for this version

  55. 0.39.112 May 2023

    Nothing published for this version

  56. 0.39.011 May 2023

    Nothing published for this version

  57. 0.38.013 Apr 2023

    Nothing published for this version

  58. 0.37.030 Mar 2023

    Nothing published for this version

  59. 0.36.120 Mar 2023

    Nothing published for this version

  60. 0.36.013 Mar 2023

    Nothing published for this version