OpenTelemetry JavaScript Client is a JavaScript framework for collecting traces, metrics, and logs from applications. It provides getting started documentation and API and SDK reference materials, useful for setting up and exporting observability telemetry in Node.js.
Project status
- Actively maintained, with an upstream push and updates as recently as October 29, 2026.
- Updates have been frequent, including several in October and earlier updates in August and July.
AI summary generated
Recent updates
semconv/v1.45.0
This release updates `@opentelemetry/semantic-conventions` from 1.44.0 to 1.45.0, adding stable RPC conventions and a large set of incubating conventions, while changing one incubating attribute value and deprecating older conventions. The diff also contains semantic documentation updates, TypeDoc configuration additions, and cleanup of the web-common test dependencies.
BreakingFeaturesv3.1.0
Version 3.1.0 updates resource detector guidance and stabilizes the service instance ID detector. It also fixes attribute handling and B3 trace ID validation, improves resource waiting in log and trace SDK batches, and clarifies the minimum API dependency required by several packages.
Featuresexperimental/v0.301.0
Experimental v0.301.0 expands environment-based configuration support in `startNodeSdk()` and narrows the configuration package to declarative config-file parsing. It also includes the documented exporter, instrumentation, TLS, and environment-variable fixes, plus several stable SDK 3.1.0 changes visible in the diff but absent from the supplied release notes.
BreakingFeaturessemconv/v1.44.0
This release updates `@opentelemetry/semantic-conventions` to v1.44.0, adding 33 experimental exports and deprecating three paging-fault metric exports. It also migrates the build to tsdown, adjusts ESM package resolution, and includes documentation, CI, and development dependency updates.
Featuresapi/v1.10.0
api/v1.10.0 adds the Logs API to @opentelemetry/api, alongside context.attach() and broader attribute value support via the new AnyValue/Attributes typing. It also includes fixes related to TraceState.set() limits and ESM entrypoint resolution, plus internal build pipeline changes (tsc to tsdown, dist-based dual CJS/ESM output with exports maps).
BreakingFeaturesexperimental/v0.300.0
This experimental release raises the minimum supported Node.js version to >=22.15.0 and introduces multiple breaking API and packaging changes. It removes several deprecated configuration fields and types, and it tightens package export maps, which will break deep imports and certain bundler setups unless you update your import paths.
BreakingFeaturesv3.0.0
v3.0.0 raises the minimum supported Node.js version to >=22.15.0 and makes a major public API and packaging overhaul, including package removals and tighter Node/package exports rules. It also removes several deprecated core APIs and replaces multiple platform and build-output import paths, which can break deep imports and require migration to new entry points and configuration options.
BreakingFeaturesv2.12.0
v2.12.0 adds a new StackContextManager to the @opentelemetry/sdk-trace package, expanding available tracing context management utilities. The only other listed change is an internal CI workflow update to support releasing from maintenance branches without overwriting the API documentation site for main-reachable commits.
Featuresexperimental/v0.223.0
experimental/v0.223.0 primarily changes web network span utilities used by the deprecated fetch and XMLHttpRequest instrumentations. The release notes document a breaking change to `addSpanNetworkEvents()` and describe an internal refactor moving those utilities from `@opentelemetry/sdk-trace-web` into `@opentelemetry/web-common`.
Breakingv2.11.0
OpenTelemetry JS v2.11.0 adds two notable capabilities: an `attach()` implementation for `AsyncLocalStorageContextManager` and support for configuring the force flush timeout per call in the tracing SDK. It also improves metrics robustness by ignoring `Infinity` values in exponential histograms, along with an internal performance optimization for histogram bit reads.
Featuresexperimental/v0.222.0
experimental/v0.222.0 primarily introduces fail-fast behavior when creating OpenTelemetry SDK components from declarative configuration. It also deprecates SdkLogRecord in favor of ReadWriteLogRecord, and includes targeted fixes around HTTP span query redaction and OTLP exporter configuration headers_list support. The release notes call out a specific environment-based configuration caveat for startNodeSDK().
BreakingFeaturesv2.10.0
v2.10.0 adds new metrics support for both the SDK log processor and the OTLP exporter. It also includes targeted bug fixes around forceFlush behavior and TraceIdRatioBasedSampler boundary handling, plus a planned deprecation notice for the Jaeger propagator.
Featuresexperimental/v0.221.0
Release experimental/v0.221.0 focuses on tightening semantic convention emission to stable conventions only, removing multiple semconv stability opt-in mechanisms. It also adds an SDK logs feature to modify properties of ReadWriteLogRecord instances per the Logs specification, plus an HTTP instrumentation metric tweak (error.type).
BreakingFeaturessemconv/v1.43.0
semconv/v1.43.0 release notes document only two new semantic convention exports, one in the stable set (TELEMETRY_SDK_LANGUAGE_VALUE_KOTLIN) and one in the unstable/incubating set (ATTR_AZURE_RESOURCE_GROUP_NAME). The provided code diff, however, includes many additional repository-wide and package build changes (TypeScript version bump, CI Node version updates, dependency pruning in exporter packages, and additional SDK-related changelog entries) that are not mentioned in the semconv release notes.
Featuressemconv/v1.42.0
semconv/v1.42.0 updates the OpenTelemetry JavaScript semantic conventions package by adding a number of stable semantic convention exports (including container and Kubernetes attribute constants), and deprecating a set of unstable GenAI-related exports. The release notes also indicate that many GenAI semantic convention exports have been federated to the new semantic-conventions-genai repository.
BreakingFeaturesv2.9.0
OpenTelemetry JS v2.9.0 introduces new metrics and tracing capabilities, including span processor metrics, an AlwaysRecordSampler, and an added maxExportBatchSize option for PeriodicExportingMetricReader. It also adds a new sdk-trace package, but there are constructor signature changes that may require code updates, and @opentelemetry/shim-opentracing is slated for removal in SDK 3.x (around Sep 2026).
BreakingFeaturesexperimental/v0.220.0
Release experimental/v0.220.0 introduces user-facing breaking changes around declarative config parsing behavior and log SDK processor constructor signatures. It also adds configuration schema wiring for new config capabilities (id_generator, sampler settings) and multiple bug fixes around log shutdown behavior and config-to-exporter property propagation.
BreakingFeaturesexperimental/v0.219.0
experimental/v0.219.0 introduces several breaking changes, primarily around declarative configuration parsing, @opentelemetry/api-logs exports, and LoggerOptions option naming. It also adds declarative-config wiring for metric producers (sdk-node) and extends LoggerOptions to support attributes, alongside multiple targeted bug fixes across exporters and the SDKs.
BreakingFeaturesv2.8.0
OpenTelemetry JS v2.8.0 adds developer-facing improvements for tracing and metrics, including better pretty-printing of tracing internals and new self-observability metrics for metric readers. It also introduces a small core utility for time conversion (hrTimeToSeconds). A bug fix limits how much incoming baggage header data is processed to 8192 bytes.
Featuresexperimental/v0.218.0
Release experimental/v0.218.0 adds a custom protobuf implementation for OTLP metrics serialization, improves configuration validation error reporting, and allows startNodeSDK() to be called without arguments. The release notes also include internal refactors in the SDK logs implementation.
Features