Release v1.15.0/v0.38.0

[MrAlias]

Added

• The go.opentelemetry.io/otel/metric/embedded package. (Add embedded private method interfaces in metric API #3916)
• The Version function to go.opentelemetry.io/otel/sdk to return the SDK version. (Add Version func to otel/sdk #3949)
• Add a WithNamespace option to go.opentelemetry.io/otel/exporters/prometheus to allow users to prefix metrics with a namespace. (prometheus: add WithNamespace option to prefix metrics #3970)
• The following configuration types were added to go.opentelemetry.io/otel/metric/instrument to be used in the configuration of measurement methods. (Add options to measurement methods #3971)
  • The AddConfig used to hold configuration for addition measurements
    • NewAddConfig used to create a new AddConfig
    • AddOption used to configure an AddConfig
  • The RecordConfig used to hold configuration for recorded measurements
    • NewRecordConfig used to create a new RecordConfig
    • RecordOption used to configure a RecordConfig
  • The ObserveConfig used to hold configuration for observed measurements
    • NewObserveConfig used to create a new ObserveConfig
    • ObserveOption used to configure an ObserveConfig
• WithAttributeSet and WithAttributes are added to go.opentelemetry.io/otel/metric/instrument. They return an option used during a measurement that defines the attribute Set associated with the measurement. (Add options to measurement methods #3971)
• The Version function to go.opentelemetry.io/otel/exporters/otlp/otlpmetric to return the OTLP metrics client version. (Add Version func to otlpmetric and otlptrace #3956)
• The Version function to go.opentelemetry.io/otel/exporters/otlp/otlptrace to return the OTLP trace client version. (Add Version func to otlpmetric and otlptrace #3956)

Changed

• The Extrema in go.opentelemetry.io/otel/sdk/metric/metricdata is redefined with a generic argument of [N int64 | float64]. (Update Histogram Extrema and Sum to be generic #3870)
• Update all exported interfaces from go.opentelemetry.io/otel/metric to embed their corresponding interface from go.opentelemetry.io/otel/metric/embedded. This adds an implementation requirement to set the interface default behavior for unimplemented methods. (Add embedded private method interfaces in metric API #3916)
• Move No-Op implementation from go.opentelemetry.io/otel/metric into its own package go.opentelemetry.io/otel/metric/noop. (Move metric No-Op to metric/noop #3941)
  • metric.NewNoopMeterProvider is replaced with noop.NewMeterProvider
• Add all the methods from "go.opentelemetry.io/otel/trace".SpanContext to bridgeSpanContext by embedding otel.SpanContext in bridgeSpanContext. (Added methods for SpanID and TraceID on bridgeSpanContext #3966)
• Wrap UploadMetrics error in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/ to improve error message when encountering generic grpc errors. ([exporters/otlp/otlpmetric] Wrap upload metrics error to provide additional context #3974)
• The measurement methods for all instruments in go.opentelemetry.io/otel/metric/instrument accept an option instead of the variadic "go.opentelemetry.io/otel/attribute".KeyValue. (Add options to measurement methods #3971)
  • The Int64Counter.Add method now accepts ...AddOption
  • The Float64Counter.Add method now accepts ...AddOption
  • The Int64UpDownCounter.Add method now accepts ...AddOption
  • The Float64UpDownCounter.Add method now accepts ...AddOption
  • The Int64Histogram.Record method now accepts ...RecordOption
  • The Float64Histogram.Record method now accepts ...RecordOption
  • The Int64Observer.Observe method now accepts ...ObserveOption
  • The Float64Observer.Observe method now accepts ...ObserveOption
• The Observer methods in go.opentelemetry.io/otel/metric accept an option instead of the variadic "go.opentelemetry.io/otel/attribute".KeyValue. (Add options to measurement methods #3971)
  • The Observer.ObserveInt64 method now accepts ...ObserveOption
  • The Observer.ObserveFloat64 method now accepts ...ObserveOption
• Move global metric back to go.opentelemetry.io/otel/metric/global from go.opentelemetry.io/otel. (Move global metric back to otel/metric/global for minor release #3986)

Fixed

• TracerProvider allows calling Tracer() while it's shutting down. It used to deadlock. (TracerProvider allows calling Tracer() while it's shutting down #3924)
• Use the SDK version for the Telemetry SDK resource detector in go.opentelemetry.io/otel/sdk/resource. (Add Version func to otel/sdk #3949)
• Fix a data race in SpanProcessor returned by NewSimpleSpanProcessor in go.opentelemetry.io/otel/sdk/trace. (Fixed race condition in OnEnd and added a unit test #3951)
• Automatically figure out the default aggregation with aggregation.Default. (Fix aggregation.Default to properly return the default one #3967)

Deprecated

• The go.opentelemetry.io/otel/metric/instrument package is deprecated. Use the equivalent types added to go.opentelemetry.io/otel/metric instead. (Unify metric API into the one otel/metric package #4018)

[codecov]

Codecov Report

Merging #4035 (9b374f9) into main (180b355) will decrease coverage by 0.1%.
The diff coverage is 100.0%.

Additional details and impacted files

@@           Coverage Diff           @@
##            main   #4035     +/-   ##
=======================================
- Coverage   82.2%   82.2%   -0.1%     
=======================================
  Files        176     176             
  Lines      13058   13058             
=======================================
- Hits       10742   10740      -2     
- Misses      2095    2097      +2     
  Partials     221     221             

Impacted Files	Coverage Δ
exporters/otlp/otlpmetric/version.go	100.0% <100.0%> (ø)
exporters/otlp/otlptrace/version.go	100.0% <100.0%> (ø)
sdk/version.go	100.0% <100.0%> (ø)
version.go	100.0% <100.0%> (ø)

... and 1 file with indirect coverage changes