@opentelemetry/sdk-metrics - npm Package Versions

1.30.0

:rocket: (Enhancement)

• feat(sdk-metrics): PeriodicExportingMetricReader now flushes pending tasks at shutdown #5242

:bug: (Bug Fix)

• fix(sdk-trace-base): do not load OTEL_ env vars on module load, but when needed #5233
• fix(instrumentation-xhr, instrumentation-fetch): content length attributes no longer get removed with ignoreNetworkEvents: true being set #5229

1.29.0

:boom: Breaking Change

• feat(sdk-metrics): Add support for aggregation cardinality limit with a default limit of 2000. This limit can be customized via views #5182

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