@opentelemetry/propagator-jaeger
2.12.0 · 6 Oct 2026Apache-2.030.9M / weekRepositoryHomepagenpmAtom feed
2.12.1 is the newest release of 2.x.
In short
34 breaking5 new4 fixed4 changed6 internal
- Breaking
The minimum supported TypeScript version has been raised to 5.0.4.
- Breaking
sdk-trace-base: Add
parentSpanContextand removeparentSpanIdfromSpanandReadableSpan#5450 - Breaking
sdk-metrics: Drop deprecated
typefield onMetricDescriptor#5291 - Breaking
sdk-metrics: Drop deprecated
InstrumentDescriptortype; useMetricDescriptorinstead #5277 - Breaking
sdk-metrics: Bump minimum version of
@opentelemetry/apipeer dependency to 1.9.0 #5254 - Breaking
shim-opentracing: Replace deprecated SpanAttributes #4430
- Breaking
sdk-metrics: Remove MeterProvider.addMetricReader() in favor of constructor option #4419
- Breaking
sdk-metrics: Replace attributeKeys with custom processors option #4532
Security
1 advisory affects 2.0.0; 2.9.0 fixes them
- HighOpenTelemetry JavaScript: Denial of service in `JaegerPropagator` via unhandled exception on a malformed headerGHSA-45rx-2jwx-cxfr · 21 Jul 2026Fixed in 2.9.0
Release note
Summary
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.- Breaking
The minimum supported TypeScript version has been raised to 5.0.4.
The compilation target for transpiled TypeScript has been raised to ES2022 (from ES2017).
The public interface has changed
for notes on migrating to 2.x / 0.200.x see the upgrade guide
Only experimental versions
0.200.0are compatible with this release
:boom: Breaking Change
- Breaking
sdk-trace-base: Add
parentSpanContextand removeparentSpanIdfromSpanandReadableSpan#5450(user-facing): the SDK's
SpansparentSpanIdwas replaced byparentSpanContext, to migrate to the new property, please replacespan.parentSpanId->span.parentSpanContext?.spanId
- Breaking
sdk-metrics: Drop deprecated
typefield onMetricDescriptor#5291 - Breaking
sdk-metrics: Drop deprecated
InstrumentDescriptortype; useMetricDescriptorinstead #5277 - Breaking
sdk-metrics: Bump minimum version of
@opentelemetry/apipeer dependency to 1.9.0 #5254 - Breaking
shim-opentracing: Replace deprecated SpanAttributes #4430
- Breaking
otel-core: Replace deprecated SpanAttributes #4408
- Breaking
sdk-metrics: Remove MeterProvider.addMetricReader() in favor of constructor option #4419
- Breaking
otel-resources: Replace deprecated SpanAttributes #4428
- Breaking
sdk-metrics: Remove MeterProvider.addMetricReader() in favor of constructor option #4419
- Breaking
sdk-metrics: Replace attributeKeys with custom processors option #4532
- Breaking
sdk-trace-base: Replace
SpanAttributeswithAttributes#5009 - Breaking
resources: Replace
ResourceAttributeswithAttributes#5016 - Breaking
sdk-metrics: Drop
ViewandAggregationin favor ofViewOptionsandAggregationOption#4931 - Breaking
sdk-trace-base: Remove
new Spanconstructor in favor ofTracer.startSpanAPI #5048 - Breaking
sdk-trace-base: Remove
BasicTracerProvider.addSpanProcessorAPI in favor of constructor options. #5134 - Breaking
sdk-trace-base: Make
resourceproperty private inBasicTracerProviderand removegetActiveSpanProcessorAPI. #5192 - Breaking
sdk-metrics: Extract
IMetricReaderinterface and use it over abstract class #5311(user-facing):
MeterProviderOptionsnow provides the more generalIMetricReadertype overMetricReaderIf you accept
MetricReaderin your public interface, consider accepting the more generalIMetricReaderinstead to avoid unintentional breaking changes
- Breaking
sdk-trace: Remove ability to have BasicTracerProvider instantiate exporters #5239
When extending
BasicTracerProvider, the class offered multiple methods to facilitate the creation of exporters and auto-pairing withSpanProcessors.This functionality has been removed - users may now pass
SpanProcessors to the base class constructor when extending(user-facing):
_registeredExportershas been removed(user-facing):
_getSpanExporterhas been removed(user-facing):
_buildExporterFromEnvhas been removed
- Breaking
core: Remove deprecated
IdGeneratorandRandomIdGenerator#5309 - Breaking
core: Remove deprecated type
InstrumentationLibrary#5308(user-facing): please use equivalent type
InstrumentationScopeinstead
- Breaking
sdk-trace-base: Replace usages fo
InstrumentationLibrarywithInstrumentationScope#5308(user-facing) rename
Tracer.instrumentationLibrary->Tracer.instrumentationScope(user-facing) rename
ReadableSpan.instrumentationLibrary->ReadableSpan.instrumentationScopealso renames the property in implementations of
ReadableSpan
- Breaking
exporter-jaeger: Use
ReadableSpan.instrumentationScopeoverReadableSpan.instrumentationLibrary#5308 - Breaking
exporter-zipkin: Use
ReadableSpan.instrumentationScopeoverReadableSpan.instrumentationLibrary#5308 - Breaking
Update typescript to version
5.0.4#5145(user-facing) dropped support for
typescript@<5.0.4(user-facing) all packages published from this repository will from now on drop support for old versions of
typescriptin minor releases. We will only drop support for versions that are older than 2 years.
- Breaking
core: Remove deprecated samplers #5316
(user-facing): deprecated
AlwaysOnSamplerhas moved to@opentelemetry/sdk-trace-base(user-facing): deprecated
AlwaysOffSamplerhas moved to@opentelemetry/sdk-trace-base(user-facing): deprecated
ParentBasedSamplerhas moved to@opentelemetry/sdk-trace-base(user-facing): deprecated
TraceIdRatioSamplerhas moved to@opentelemetry/sdk-trace-base
- Breaking
resource: Merge sync and async resource interfaces into a single interface #5350
Resource constructor now takes a single argument which contains an optional
attributesobjectDetected resource attribute values may be a promise or a synchronous value
Resources are now merged by the order in which their detectors are configured instead of async attributes being last
Resource detectors now return
DetectedResourceplain objects instead ofnew Resource()
- Breaking
sdk-trace-base: Drop ability to instantiate propagators beyond defaults #5355
(user-facing): only a non-env-var based default is now used on
BasicTracerProvider#register().propagators can now not be configured via
OTEL_PROPAGATORSorwindow.OTEL_PROPAGATORSanymore, please pass the propagator toNodeTracerProvider#register()instead.if not configured directly via code,
BasicTracerProvider#register()will now fall back to defaults (tracecontextandbaggage)
- Breaking
sdk-trace-node: Drop ability to instantiate propagators beyond defaults #5355
(user-facing): only a non-env-var based default is now used on
NodeTracerProvider#register().propagators can now not be configured via
OTEL_PROPAGATORSanymore, please pass the propagator toNodeTracerProvider#register()instead.if not configured via code,
NodeTracerProvider#register()will now fall back to the defaults (tracecontextandbaggage)if autoconfiguration based on enviornment variables is needed, please use
NodeSDKfrom@opentelemetry/sdk-node.
- Breaking
sdk-trace-web: Drop ability to instantiate propagators beyond defaults #5355
(user-facing): only a non-env-var based default is now used on
WebTracerProvider#register().propagators can now not be configured via
window.OTEL_PROPAGATORSanymore, please pass the propagator toWebTracerProvider#register()instead.if not configured via code,
WebTracerProvider#register()will now fall back to defaults (tracecontextandbaggage)
- Breaking
sdk-trace: Drop unnecessary exports #5405
(user-facing):
EXPORTER_FACTORYis not used anymore and has been removed(user-facing):
PROPAGATOR_FACTORYis not used anymore and has been removed(user-facing):
ForceFlushStatewas intended for internal use and has been removed(user-facing): the
Tracerclass was unintentionally exported and has been removedto obtain a
Tracer, please useBasicTracerProvider#getTracer(),NodeTracerProvider#getTracer()orWebTracerProvider#getTracer()to reference a
Tracer, please use theTracertype from@opentelemetry/api
- Breaking
Raise the minimum supported Node.js version to
^18.19.0 || >=20.6.0. Support for Node.js 14, 16, and early minor versions of 18 and 20 have been dropped. This applies to all packages except the 'api' and 'semantic-conventions' packages. #5395 - Breaking
core: Remove TracesSamplerValues from exports #5406
(user-facing): TracesSamplerValues was only consumed internally and has been removed from exports without replacement
- Breaking
resources: Remove deprecated duplicate browser detector from
@opentelemetry/resourcein favor of@opentelemetry/opentelemetry-browser-detector#5420 - Breaking
core: Remove unused and obsolete functions and types #5444
(user-facing):
VERSIONwas an internal constant that was unintentionally exported. It has been removed without replacement.(user-facing):
isWrappedhas been removed in favor ofisWrappedfrom@opentelemetry/instrumentation(user-facing):
ShimWrappedhas been removed in favor ofShimWrappedfrom@opentelemetry/instrumentation(user-facing):
hexToBase64was a utility function that is not used by the SDK anymore. It has been removed without replacement.(user-facing):
hexToBinarywas a utility function that now internal to@opentelemetry/otlp-tranformer. It has been removed without replacement.(user-facing):
baggageUtils.getKeyPariswas an internal utility function that was unintentionally exported. It has been removed without replacement.(user-facing):
baggageUtils.serializeKeyPairswas an internal utility function that was unintentionally exported. It has been removed without replacement.(user-facing):
baggageUtils.parseKeyPairsIntoRecord,has been removed in favor ofparseKeyPairsIntoRecord(user-facing):
baggageUtils.parsePairKeyValuewas an internal utility function that was unintentionally exported. It has been removed without replacement.(user-facing):
TimeOriginLegacyhas been removed without replacement.(user-facing):
isAttributeKeywas an internal utility function that was unintentionally exported. It has been removed without replacement.
- Breaking
sdk-trace-base: Do not read environment variables from window in browsers #5445
(user-facing): all configuration previously possible via
window.OTEL_*is now not supported anymore, please pass configuration options to constructors instead.Note: Node.js environment variable configuration continues to work as-is.
- Breaking
exporter-zipkin: Do not read environment variables from window in browsers #5465
(user-facing): all configuration previously possible via
window.OTEL_*is now not supported anymore, please pass configuration options to constructors instead.Note: Node.js environment variable configuration continues to work as-is.
- Breaking
resource: Remove resource class export in favor of functions and types only to aid in cross-version compatibility #5421
Renames
Resourceclass toResourceImpland makes it package-privateRenames
IResourceinterface toResourceExport function
resourceFromAttributesto create aResourcefrom aDetectedAttributesobjectExport function
defaultResourceto create a default resource #5467Export function
emptyResourceto create an empty resource #5467Only export types and functions. This aids in cross-version compatibility and makes it more easily extensible in the future.
- Breaking
resources: Do not read environment variables from window in browsers #5466
(user-facing): all configuration previously possible via
window.OTEL_*is now not supported anymoreIf you have been using the
envDetectorin browser environments, please migrate to manually creating a resource.Note: Node.js environment variable configuration continues to work as-is.
- Breaking
sdk-trace-base: Use
ParentBasedAlwaysOnSampleroverAlwaysOnSamplerwhen bogus data is supplied toOTEL_TRACES_SAMPLERthis aligns the SDK implementation with the specification
- Breaking
core: Drop
getEnv(),getEnvWithoutDefaults()#5481(user-facing):
getEnv()has been replaced bygetStringFromEnv(),getNumberFromEnv(),getBooleanFromEnv(),getStringListFromEnv()these new functions do not include defaults, please inline any defaults if necessary (example:
getStringFromEnv("OTEL_FOO") ?? "my-default")to find the previously used defaults, please see here
(user-facing):
getEnvWithoutDefaults()has been replaced bygetStringFromEnv(),getNumberFromEnv(),getBooleanFromEnv(),getStringListFromEnv()(user-facing):
DEFAULT_ENVIRONMENThas been removed, please inline any defaults from now onto find the previously used defaults, please see here
(user-facing):
ENVIRONMENThas been removed without replacement(user-facing):
RAW_ENVIRONMENThas been removed without replacement(user-facing):
parseEnvironmenthas been removed without replacement
- Breaking
sdk-trace-base: Remove
BasicTracerProvider#register()to improve tree-shaking #5503(user-facing):
BasicTracerProvider#register()has been removedto register a global propagator, please use
propagation.setGlobalPropagator()from@opentelemetry/apito register a global context manager, please use
context.setGlobalContextManager()from@opentelemetry/api
- Breaking
Set compilation target to ES2022 for all packages except
@opentelemetry/api,@opentelemetry/api-logs,@opentelemetry/api-events, and@opentelemetry/semantic-conventions#5456(user-facing): drops browser runtimes which do not support ES2022 features
- Breaking
feat(core)! drop unused constants #5504
(user-facing):
DEFAULT_ATTRIBUTE_VALUE_LENTGHT_LIMIThas been removed, please useInfinityinstead(user-facing):
DEFAULT_ATTRIBUTE_VALUE_COUNT_LIMIThas been removed, please use128instead(user-facing):
DEFAULT_SPAN_ATTRIBUTE_PER_EVENT_COUNT_LIMIThas been removed, please use128instead(user-facing):
DEFAULT_SPAN_ATTRIBUTE_PER_LINK_COUNT_LIMIThas been removed, please use128instead
:rocket: (Enhancement)
sdk-trace-web: Do not throw when passing extra options #5357
WebTracerProviderconstructor now does not throw anymore whencontextManagerorpropagatorare passed as extra options to the constructor
sdk-trace-base: Add stack trace warning to debug instrumentation #5363
core: Add more scalable replacements for getEnv(), getEnvWithoutDefaults() #5443
core: Add
diagLogLevelFromStringutility #5475
:bug: (Bug Fix)
exporter-zipkin: Remove usages of deprecated
url.parsefromnode:url#5390sdk-metrics: Do not export from
PeriodicExportingMetricReaderwhen there are no metrics to export. #5288sdk-trace-base: Always wait on pending export in SimpleSpanProcessor. #5303
core: Avoid using util in configuration.ts for browser compatibility #5524
:house: (Internal)
opentelemetry-instrumentation: Replace
semverpackage with internal semantic versioning check implementation to get rid ofsemverpackage initialization overhead especially in the AWS Lambda environment during coldstart #5305
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.