Release v1.12.0/v0.35.0

[MrAlias]

Added

• The WithInt64Callback option to go.opentelemetry.io/otel/metric/instrument. This options is used to configure int64 Observer callbacks during their creation. (Add single instrument callback and split metric instrument configuration #3507)
• The WithFloat64Callback option to go.opentelemetry.io/otel/metric/instrument. This options is used to configure float64 Observer callbacks during their creation. (Add single instrument callback and split metric instrument configuration #3507)
• The Producer interface and Reader.RegisterProducer(Producer) to go.opentelemetry.io/otel/sdk/metric. These additions are used to enable external metric Producers. (Add Metric Producer as a new interface, which returns scope metrics #3524)
• The Callback function type to go.opentelemetry.io/otel/metric. This new named function type is registered with a Meter. (Create metric API Callback type #3564)
• The go.opentelemetry.io/otel/semconv/v1.13.0 package. The package contains semantic conventions from the v1.13.0 version of the OpenTelemetry specification. (Add v1.13 semantic conventions #3499)
  • The EndUserAttributesFromHTTPRequest function in go.opentelemetry.io/otel/semconv/v1.12.0 is merged into ClientRequest and ServerRequest in go.opentelemetry.io/otel/semconv/v1.13.0/httpconv.
  • The HTTPAttributesFromHTTPStatusCode function in go.opentelemetry.io/otel/semconv/v1.12.0 is merged into ClientResponse in go.opentelemetry.io/otel/semconv/v1.13.0/httpconv.
  • The HTTPClientAttributesFromHTTPRequest function in go.opentelemetry.io/otel/semconv/v1.12.0 is replaced by ClientRequest in go.opentelemetry.io/otel/semconv/v1.13.0/httpconv.
  • The HTTPServerAttributesFromHTTPRequest function in go.opentelemetry.io/otel/semconv/v1.12.0 is replaced by ServerRequest in go.opentelemetry.io/otel/semconv/v1.13.0/httpconv.
  • The HTTPServerMetricAttributesFromHTTPRequest function in go.opentelemetry.io/otel/semconv/v1.12.0 is replaced by ServerRequest in go.opentelemetry.io/otel/semconv/v1.13.0/httpconv.
  • The NetAttributesFromHTTPRequest function in go.opentelemetry.io/otel/semconv/v1.12.0 is split into Transport in go.opentelemetry.io/otel/semconv/v1.13.0/netconv and ClientRequest or ServerRequest in go.opentelemetry.io/otel/semconv/v1.13.0/httpconv.
  • The SpanStatusFromHTTPStatusCode function in go.opentelemetry.io/otel/semconv/v1.12.0 is replaced by ClientStatus in go.opentelemetry.io/otel/semconv/v1.13.0/httpconv.
  • The SpanStatusFromHTTPStatusCodeAndSpanKind function in go.opentelemetry.io/otel/semconv/v1.12.0 is split into ClientStatus and ServerStatus in go.opentelemetry.io/otel/semconv/v1.13.0/httpconv.
  • The Client function is included in go.opentelemetry.io/otel/semconv/v1.13.0/netconv to generate attributes for a net.Conn.
  • The Server function is included in go.opentelemetry.io/otel/semconv/v1.13.0/netconv to generate attributes for a net.Listener.
• The go.opentelemetry.io/otel/semconv/v1.14.0 package. The package contains semantic conventions from the v1.14.0 version of the OpenTelemetry specification. (Generate semconv/v1.14.0 #3566)
• The go.opentelemetry.io/otel/semconv/v1.15.0 package. The package contains semantic conventions from the v1.15.0 version of the OpenTelemetry specification. (Generate semconv/v1.15.0 #3578)
• The go.opentelemetry.io/otel/semconv/v1.16.0 package. The package contains semantic conventions from the v1.16.0 version of the OpenTelemetry specification. (Generate semconv/v1.16.0 #3579)
• Metric instruments to go.opentelemetry.io/otel/metric/instrument. These instruments are use as replacements of the depreacted go.opentelemetry.io/otel/metric/instrument/{asyncfloat64,asyncint64,syncfloat64,syncint64} packages.(Deprecate the syncint64/syncfloat64/asyncint64/asyncfloat64 packages #3575, Remove the unneeded Observe method from the async instruments #3586)
  • Float64ObservableCounter replaces the asyncfloat64.Counter
  • Float64ObservableUpDownCounter replaces the asyncfloat64.UpDownCounter
  • Float64ObservableGauge replaces the asyncfloat64.Gauge
  • Int64ObservableCounter replaces the asyncint64.Counter
  • Int64ObservableUpDownCounter replaces the asyncint64.UpDownCounter
  • Int64ObservableGauge replaces the asyncint64.Gauge
  • Float64Counter replaces the syncfloat64.Counter
  • Float64UpDownCounter replaces the syncfloat64.UpDownCounter
  • Float64Histogram replaces the syncfloat64.Histogram
  • Int64Counter replaces the syncint64.Counter
  • Int64UpDownCounter replaces the syncint64.UpDownCounter
  • Int64Histogram replaces the syncint64.Histogram
• NewTracerProvider to go.opentelemetry.io/otel/bridge/opentracing. This is used to create WrapperTracer instances from a TracerProvider. (bridge/opentracing: introduce NewTracerProvider that wraps TracerProvider instead of Tracer #3116)
• The Extrema type to go.opentelemetry.io/otel/sdk/metric/metricdata. This type is used to represent min/max values and still be able to distinguish unset and zero values. (Adds an Attribute assertion to metric data test #3487)
• The go.opentelemetry.io/otel/semconv/v1.17.0 package. The package contains semantic conventions from the v1.17.0 version of the OpenTelemetry specification. (Generate the semconv/v1.17.0 package #3599)

Changed

• Jaeger and Zipkin exporter use github.com/go-logr/logr as the logging interface, and add the WithLogr option. (Exporter: WithLogger uses the github.com/go-logr/logr interface to replace the standard library logger #3497, feat(exporter): Jaeger and Zipkin exporter use logr as the logging interface #3500)
• Instrument configuration in go.opentelemetry.io/otel/metric/instrument is split into specific options and confguration based on the instrument type. (Add single instrument callback and split metric instrument configuration #3507)
  • Use the added Int64Option type to configure instruments from go.opentelemetry.io/otel/metric/instrument/syncint64.
  • Use the added Float64Option type to configure instruments from go.opentelemetry.io/otel/metric/instrument/syncfloat64.
  • Use the added Int64ObserverOption type to configure instruments from go.opentelemetry.io/otel/metric/instrument/asyncint64.
  • Use the added Float64ObserverOption type to configure instruments from go.opentelemetry.io/otel/metric/instrument/asyncfloat64.
• Return a Registration from the RegisterCallback method of a Meter in the go.opentelemetry.io/otel/metric package. This Registration can be used to unregister callbacks. (Allow multi-instrument callbacks to be unregistered #3522)
• Global error handler uses an atomic value instead of a mutex. (small contingency improvement in global error handler #3543)
• Add NewMetricProducer to go.opentelemetry.io/otel/bridge/opencensus, which can be used to pass OpenCensus metrics to an OpenTelemetry Reader. (Update OpenCensus metric bridge to use the metric.Producer interface #3541)
• Global logger uses an atomic value instead of a mutex. (Global logger uses an atomic value instead of a mutex. #3545)
• The Shutdown method of the "go.opentelemetry.io/otel/sdk/trace".TracerProvider releases all computational resources when called the first time. (TracerProvider shutdown release resources #3551)
• The Sampler returned from TraceIDRatioBased go.opentelemetry.io/otel/sdk/trace now uses the rightmost bits for sampling decisions. This fixes random sampling when using ID generators like xray.IDGenerator and increasing parity with other language implementations. (traceIDRatioSampler: use rightmost bits #3557)
• Errors from go.opentelemetry.io/otel/exporters/otlp/otlptrace exporters are wrapped in erros identifying their signal name. Existing users of the exporters attempting to identify specific errors will need to use errors.Unwrap() to get the underlying error. (OTLP traces export errors use a consistent error message prefix #3516)
• Exporters from go.opentelemetry.io/otel/exporters/otlp will print the final retryable error message when attempts to retry time out. (OTLP exporter: Let final retry error include last retryable error message #3514)
• The instrument kind names in go.opentelemetry.io/otel/sdk/metric are updated to match the API. (Rename metric SDK instrument kind to match API #3562)
  • InstrumentKindSyncCounter is renamed to InstrumentKindCounter
  • InstrumentKindSyncUpDownCounter is renamed to InstrumentKindUpDownCounter
  • InstrumentKindSyncHistogram is renamed to InstrumentKindHistogram
  • InstrumentKindAsyncCounter is renamed to InstrumentKindObservableCounter
  • InstrumentKindAsyncUpDownCounter is renamed to InstrumentKindObservableUpDownCounter
  • InstrumentKindAsyncGauge is renamed to InstrumentKindObservableGauge
• The RegisterCallback method of the Meter in go.opentelemetry.io/otel/metric changed.
  • The named Callback replaces the inline function parameter. (Create metric API Callback type #3564)
  • Callback is required to return an error. (Have multi-instrument callback return an error #3576)
  • Callback accepts the added Observer parameter added. This new parameter is used by Callback implementations to observe values for asynchronous instruments instead of calling the Observe method of the instrument directly. (Redesign RegisterCallback API #3584)
  • The slice of instrument.Asynchronous is now passed as a variadic argument. (Restructure RegisterCallback method #3587)
• The exporter from go.opentelemetry.io/otel/exporters/zipkin is updated to use the v1.16.0 version of semantic conventions. This means it no longer uses the removed net.peer.ip or http.host attributes to determine the remote endpoint. Instead it uses the net.sock.peer attributes. (Upgrade all semconv dependencies to v1.16.0 #3581)
• The Min and Max fields of the HistogramDataPoint in go.opentelemetry.io/otel/sdk/metric/metricdata are now defined with the added Extrema type instead of a *float64. (Adds an Attribute assertion to metric data test #3487)

Fixed

• Asynchronous instruments that use sum aggregators and attribute filters correctly add values from equivalent attribute sets that have been filtered. (Align Async Counter behavior when used with filtered attributes. #3439, Combine precomputed values of filtered attribute sets #3549)
• The RegisterCallback method of the Meter from go.opentelemetry.io/otel/sdk/metric only registers a callback for instruments created by that meter. Trying to register a callback with instruments from a different meter will result in an error being returned. (Redesign RegisterCallback API #3584)

Deprecated

• The NewMetricExporter in go.opentelemetry.io/otel/bridge/opencensus is deprecated. Use NewMetricProducer instead. (Update OpenCensus metric bridge to use the metric.Producer interface #3541)
• The go.opentelemetry.io/otel/metric/instrument/asyncfloat64 package is deprecated. Use the instruments from go.opentelemetry.io/otel/metric/instrument instead. (Deprecate the syncint64/syncfloat64/asyncint64/asyncfloat64 packages #3575)
• The go.opentelemetry.io/otel/metric/instrument/asyncint64 package is deprecated. Use the instruments from go.opentelemetry.io/otel/metric/instrument instead. (Deprecate the syncint64/syncfloat64/asyncint64/asyncfloat64 packages #3575)
• The go.opentelemetry.io/otel/metric/instrument/syncfloat64 package is deprecated. Use the instruments from go.opentelemetry.io/otel/metric/instrument instead. (Deprecate the syncint64/syncfloat64/asyncint64/asyncfloat64 packages #3575)
• The go.opentelemetry.io/otel/metric/instrument/syncint64 package is deprecated. Use the instruments from go.opentelemetry.io/otel/metric/instrument instead. (Deprecate the syncint64/syncfloat64/asyncint64/asyncfloat64 packages #3575)
• The NewWrappedTracerProvider in go.opentelemetry.io/otel/bridge/opentracing is now deprecated. Use NewTracerProvider instead. (bridge/opentracing: introduce NewTracerProvider that wraps TracerProvider instead of Tracer #3116)

Removed

• The deprecated go.opentelemetry.io/otel/sdk/metric/view package is removed. (Remove the deprecated view package #3520)
• The InstrumentProvider from go.opentelemetry.io/otel/sdk/metric/asyncint64 is removed. Use the new creation methods of the Meter in go.opentelemetry.io/otel/sdk/metric instead. (Remove metric instrument provider API #3530)
  • The Counter method is replaced by Meter.Int64ObservableCounter
  • The UpDownCounter method is replaced by Meter.Int64ObservableUpDownCounter
  • The Gauge method is replaced by Meter.Int64ObservableGauge
• The InstrumentProvider from go.opentelemetry.io/otel/sdk/metric/asyncfloat64 is removed. Use the new creation methods of the Meter in go.opentelemetry.io/otel/sdk/metric instead. (Remove metric instrument provider API #3530)
  • The Counter method is replaced by Meter.Float64ObservableCounter
  • The UpDownCounter method is replaced by Meter.Float64ObservableUpDownCounter
  • The Gauge method is replaced by Meter.Float64ObservableGauge
• The InstrumentProvider from go.opentelemetry.io/otel/sdk/metric/syncint64 is removed. Use the new creation methods of the Meter in go.opentelemetry.io/otel/sdk/metric instead. (Remove metric instrument provider API #3530)
  • The Counter method is replaced by Meter.Int64Counter
  • The UpDownCounter method is replaced by Meter.Int64UpDownCounter
  • The Histogram method is replaced by Meter.Int64Histogram
• The InstrumentProvider from go.opentelemetry.io/otel/sdk/metric/syncfloat64 is removed. Use the new creation methods of the Meter in go.opentelemetry.io/otel/sdk/metric instead. (Remove metric instrument provider API #3530)
  • The Counter method is replaced by Meter.Float64Counter
  • The UpDownCounter method is replaced by Meter.Float64UpDownCounter
  • The Histogram method is replaced by Meter.Float64Histogram

[codecov]

Codecov Report

Merging #3623 (6e9fa45) into main (ec13377) will decrease coverage by 0.1%.
The diff coverage is 100.0%.

Additional details and impacted files

@@           Coverage Diff           @@
##            main   #3623     +/-   ##
=======================================
- Coverage   79.7%   79.7%   -0.1%     
=======================================
  Files        171     171             
  Lines      12673   12673             
=======================================
- Hits       10105   10103      -2     
- Misses      2355    2357      +2     
  Partials     213     213             

Impacted Files	Coverage Δ
version.go	100.0% <100.0%> (ø)
exporters/jaeger/jaeger.go	90.3% <0.0%> (-0.9%)	⬇️