go.opentelemetry.io/otel/metric

Fixed

• Remove unused imports from sdk/resource/host_id_bsd.go which caused build failures. (#4040, #4041)

Added

• The go.opentelemetry.io/otel/metric/embedded package. (#3916)
• The Version function to go.opentelemetry.io/otel/sdk to return the SDK version. (#3949)
• Add a WithNamespace option to go.opentelemetry.io/otel/exporters/prometheus to allow users to prefix metrics with a namespace. (#3970)
• The following configuration types were added to go.opentelemetry.io/otel/metric/instrument to be used in the configuration of 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. (#3971)
• The Version function to go.opentelemetry.io/otel/exporters/otlp/otlpmetric to return the OTLP metrics client version. (#3956)
• The Version function to go.opentelemetry.io/otel/exporters/otlp/otlptrace to return the OTLP trace client version. (#3956)

Changed

• The Extrema in go.opentelemetry.io/otel/sdk/metric/metricdata is redefined with a generic argument of [N int64 | float64]. (#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. (#3916)
• Move No-Op implementation from go.opentelemetry.io/otel/metric into its own package go.opentelemetry.io/otel/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. (#3966)
• Wrap UploadMetrics error in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/ to improve error message when encountering generic grpc errors. (#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. (#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. (#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. (#3986)

Fixed

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

Deprecated

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