@opentelemetry/semantic-conventions - npm Package Versions

1.28.0

:rocket: (Enhancement)

• feat(sdk-metrics, sdk-trace): add mergeResourceWithDefaults flag, which allows opting-out of resources getting merged with the default resource #4617

  • default: true (no change in behavior)
  • note: false will become the default behavior in the next major version in order to comply with specification requirements

• feat(sdk-trace-base): add spanProcessors property in TracerConfig interface. #5138 @david-luna

:bug: (Bug Fix)

• fix(sdk-metrics): await exports in PeriodicExportingMetricReader when async resource attributes have not yet settled #5119 @pichlermarc
• fix(sdk-trace): performance.now() may return the same value for consecutive calls #5150 @dyladan
• fix(sdk-trace-base): pass BatchSpanProcessor#forceFlush() errors on visibilitychange/pagehide to globalErrorHandler #5143 @pichlermarc
  • fixes a bug where switching browser tabs with a failing exporter would cause an unhandled error

1.27.0

:rocket: (Enhancement)

• feat: add processors for adding session.id attribute to spans and logs #4972

:bug: (Bug Fix)

• fix(sdk-trace-base): avoid keeping non-string status.message on Span#setStatus() #4999 @pichlermarc
• fix(sdk-metrics): Add missing catch and handle error in promise of PeriodicExportingMetricReader #5006 @jj22ee
• fix(opentelemetry-core): confusing log extract of composite propagator #5017 @rv2673
• fix(propagator-aws-xray-*): move propagators back to contrib repository #4966 @pichlermarc
  • The specification prohibits hosting these packages in the core repository
  • @opentelemetry/propagator-aws-xray is now located in open-telemetry/opentelemetry-js-contrib
  • @opentelemetry/propagator-aws-xray-lambda is now located in open-telemetry/opentelemetry-js-contrib

:house: (Internal)

• deps: set @opentelemetry/api dependency min version to 1.3.0 in examples, experimental/packages, integration-tests and selenium-tests #4992
• refactor(sdk-metrics): replace MetricsAttributes with Attributes #5021 @david-luna
• refactor(instrumentation-http): replace SpanAttributes and MetricsAttributes with Attributes #5023 @david-luna
• chore(exporter-zipkin): remove usages of Span constructor #5030 @david-luna
• test(instrumentation-http): remove usages of new Span in tests #5035 @david-luna

1.26.0

:rocket: (Enhancement)

• feat: include instrumentation scope info in console span and log record exporters #4848 @blumamir
• feat(semconv): update semantic conventions to 1.27 (from 1.7.0) #4690 @dyladan
  • Exported names have changed to ATTR_{name} for attributes (e.g. ATTR_HTTP_REQUEST_METHOD), {name}_VALUE_{value} for enumeration values (e.g. HTTP_REQUEST_METHOD_VALUE_POST), and METRIC_{name} for metrics. Exported names from previous versions are deprecated.
  • Import @opentelemetry/semantic-conventions for stable semantic conventions. Import @opentelemetry/semantic-conventions/incubating for all semantic conventions, stable and unstable.
  • Note: Semantic conventions are now versioned separately from other stable artifacts, to correspond to the version of semantic conventions they provide. Changes will be in a separate changelog.

:bug: (Bug Fix)

• fix(sdk-node): avoid spurious diag errors for unknown OTEL_NODE_RESOURCE_DETECTORS values #4879 @trentm
• deps(opentelemetry-instrumentation): Bump shimmer types to 1.2.0 #4865 @lforst
• fix(instrumentation): Fix optional property types #4833 @alecmev
• fix(sdk-metrics): fix(sdk-metrics): use inclusive upper bounds in histogram #4829

:house: (Internal)

• refactor: Simplify the code for the getEnv function #4799 @danstarns
• refactor: remove "export *" in favor of explicit named exports #4880 @robbkidd
  • Packages updated:
    • opentelemetry-context-zone
    • opentelemetry-core
    • opentelemetry-exporter-jaeger
    • opentelemetry-exporter-zipkin
    • opentelemetry-propagator-b3
    • opentelemetry-propagator-jaeger
    • opentelemetry-sdk-trace-base
    • opentelemetry-sdk-trace-node
    • opentelemetry-sdk-trace-web
    • propagator-aws-xray
    • sdk-metrics
• deps(sdk-metrics): remove unused lodash.merge dependency #4905 @pichlermarc

1.25.1

:books: (Refine Doc)

• refactor(examples): added usage of @opentelemetry/semantic-conventions and @opentelemetry/resources to the examples in examples/opentelemetry-web for maintaining consistency across all examples. #4764 @Zen-cronic

:house: (Internal)

• refactor(context-zone-peer-dep): use explicit exports #4785 @pichlermarc
• refactor(context-async-hooks): use explicit exports #4785 @pichlermarc

1.25.0

:rocket: (Enhancement)

• feat: support node 22 #4666 @dyladan
• feat(context-zone*): support zone.js 0.12.x #4376 @maldago
• refactor(core): Use tree-shakeable string constants for semconv #4739 @JohannesHuster
• refactor(shim-opentracing): Use tree-shakeable string constants for semconv #4746 @JohannesHuster
• refactor(sdk-trace-web): Use tree-shakeable string constants for semconv #4747 @JohannesHuster
• refactor(sdk-trace-node): Use tree-shakeable string constants for semconv #4748 @JohannesHuster
• refactor(sdk-trace-base): Use tree-shakeable string constants for semconv #4749 @JohannesHuster
• refactor(resources): update deprecated semconv to use exported strings #4755 @JamieDanielson
• refactor(exporters): update deprecated semconv to use exported strings #4756 @JamieDanielson

:books: (Refine Doc)

• refactor(examples): use new exported string constants for semconv in examples/esm-http-ts #4758 @Zen-cronic
• refactor(examples): use new exported string constants for semconv in examples/basic-tracer-node #4759 @Zen-cronic
• refactor(examples): use new exported string constants for semconv in examples/http #4750 @Zen-cronic
• refactor(examples): use new exported string constants for semconv in examples/grpc-js #4760 @Zen-cronic
• refactor(examples): use new exported string constants for semconv in examples/otlp-exporter-node #4762 @Zen-cronic
• refactor(examples): use new exported string constants for semconv in examples/opentracing-shim #4761 @Zen-cronic

1.24.1

:bug: (Bug Fix)

• fix(core): align inconsistent behavior of getEnv() and getEnvWithoutDefaults() when a process polyfill is used #4648 @pichlermarc
  • getEnvWithoutDefaults() would use process.env if it was defined when running in a browser, while getEnv() would always use _globalThis. Now both use _globalThis when running in a browser.
• fix(resources): prevent circular import (resource -> detector -> resource -> ...) #4653 @pichlermarc
  • fixes a circular import warning which would appear in rollup when bundling @opentelemetry/resources
• fix(exporter-metrics-otlp-grpc): add explicit otlp-exporter-base dependency to exporter-metrics-otlp-grpc #4678 @AkselAllas
• fix(resources) wait for async attributes for detecting resources #4687 @ziolekjj

1.24.0

:rocket: (Enhancement)

• feat(sdk-trace-base): log resource attributes in ConsoleSpanExporter #4605 @pichlermarc
• feat(propagator-aws-xray): moved AWS Xray propagator from contrib 4603 @martinkuba
• feat(resources): new experimental detector ServiceInstanceIdDetectorSync that sets the value for service.instance.id as random UUID. #4608 @maryliag

:bug: (Bug Fix)

• fix(sdk-trace-web): fix invalid timings in span events #4486 @Abinet18
• fix(resources): ensure BrowserDetector does not think Node.js v21 is a browser #4561 @trentm
• fix(core): align inconsistent behavior of getEnv() and getEnvWithoutDefaults() when a process polyfill is used #4648 @pichlermarc
  • getEnvWithoutDefaults() would use process.env if it was defined when running in a browser, while getEnv() would always use _globalThis. Now both use _globalThis when running in a browser.

1.23.0

:rocket: (Enhancement)

• perf(sdk-trace-base): do not allocate arrays if resource has no pending async attributes #4576 @Samuron
• feat(sdk-metrics): added experimental synchronous gauge to SDK #4565 @clintonb
  • this change will become user-facing in an upcoming release

:bug: (Bug Fix)

• fix(sdk-metrics): increase the depth of the output to the console such that objects in the metric are printed fully to the console #4522 @JacksonWeber

1.22.0

:rocket: (Enhancement)

• feat(sdk-metrics): allow single bucket histograms #4456 @pichlermarc
• feat(instrumentation): Make init() method public #4418
• feat(context-zone-peer-dep, context-zone): support zone.js 0.13.x, 0.14.x #4469 @pichlermarc
• chore: Semantic Conventions export individual strings 4185
• feat(sdk-trace-base): allow adding span links after span creation #4536 @seemk

:bug: (Bug Fix)

• fix(sdk-metrics): handle zero bucket counts in exponential histogram merge #4459 @mwear
• fix(sdk-metrics): ignore NaN value recordings in Histograms #4455 @pichlermarc
  • fixes a bug where recording NaN on a histogram would result in the sum of bucket count values not matching the overall count
• fix(sdk-metrics): allow single bucket histograms #4456 @pichlermarc
  • fixes a bug where Meter.createHistogram() with the advice explicitBucketBoundaries: [] would throw
• fix(context-zone-peer-dep, context-zone): support zone.js 0.13.x, 0.14.x #4469 @pichlermarc
  • fixes a bug where old versions of zone.js affected by https://github.com/angular/angular/issues/53507 would be pulled in

:books: (Refine Doc)

• docs: shorten readme sections #4460 @legendecas

1.21.0

:rocket: (Enhancement)

• feat(sdk-metrics): add constructor option to add metric readers #4427 @pichlermarc
  • deprecates MeterProvider.addMetricReader() please use the constructor option readers instead.

:bug: (Bug Fix)

• fix(sdk-trace-base): ensure attribute value length limit is enforced on span creation #4417 @pichlermarc
• fix(sdk-trace-base): Export processed spans while exporter failed #4287 @Zirak

:house: (Internal)

• chore(opentelemetry-context-zone-peer-dep): support zone.js ^v0.13.0 #4320
• refactor(core): drop unnecessary assignment of HOSTNAME #4421 @pichlermarc
• test(opentelemetry-context-zone-peer-dep): transpile zone.js in tests #4423 @legendecas