Release v1.20.0/v0.43.0

[pellared]

This release brings a breaking change for custom trace API implementations. Some interfaces (TracerProvider, Tracer, Span) now embed the go.opentelemetry.io/otel/trace/embedded types. Implementors need to update their implementations based on what they want the default behavior to be. See the "API Implementations" section of the trace API package documentation for more about how to accomplish this.

Added

• Add go.opentelemetry.io/otel/bridge/opencensus.InstallTraceBridge, which installs the OpenCensus trace bridge, and replaces opencensus.NewTracer. (Add options to opencensus bridge, and install tracer instead of returning #4567)
• Add scope version to trace and metric bridges in go.opentelemetry.io/otel/bridge/opencensus. (Add scope version to opencensus trace and metric bridges #4584)
• Add the go.opentelemetry.io/otel/trace/embedded package to be embedded in the exported trace API interfaces. (Add embedded package to trace API #4620)
• Add the go.opentelemetry.io/otel/trace/noop package as a default no-op implementation of the trace API. (Add embedded package to trace API #4620)
• Add context propagation in go.opentelemetry.io/otel/example/dice. (example/dice: Add context propagation #4644)
• Add view configuration to go.opentelemetry.io/otel/example/prometheus. (Move view example into prometheus example, and deprecate /example/view #4649)
• Add go.opentelemetry.io/otel/metric.WithExplicitBucketBoundaries, which allows defining default explicit bucket boundaries when creating histogram instruments. (Add WithExplicitBucketBoundaries Histogram option to the metric api #4603)
• Add Version function in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc. (Decouple otlpmetricgrpc and otlpmetrichttp from otlpmetric #4660)
• Add Version function in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp. (Decouple otlpmetricgrpc and otlpmetrichttp from otlpmetric #4660)
• Add Summary, SummaryDataPoint, and QuantileValue to go.opentelemetry.io/sdk/metric/metricdata. (Add summary data type to metricdata #4622)
• go.opentelemetry.io/otel/bridge/opencensus.NewMetricProducer now supports exemplars from OpenCensus. (Add exemplar support to OpenCensus bridge #4585)
• Add support for WithExplicitBucketBoundaries in go.opentelemetry.io/otel/sdk/metric. (Implement WithExplicitBucketBoundaries option in the metric SDK #4605)
• Add support for Summary metrics in go.opentelemetry.io/otel/bridge/opencensus. (Add summary support in the OpenCensus bridge #4668)

Deprecated

• Deprecate go.opentelemetry.io/otel/bridge/opencensus.NewTracer in favor of opencensus.InstallTraceBridge. (Add options to opencensus bridge, and install tracer instead of returning #4567)
• Deprecate go.opentelemetry.io/otel/example/fib package is in favor of go.opentelemetry.io/otel/example/dice. (Deprecate example/fib #4618)
• Deprecate go.opentelemetry.io/otel/trace.NewNoopTracerProvider.
  Use the added NewTracerProvider function in go.opentelemetry.io/otel/trace/noop instead. (Add embedded package to trace API #4620)
• Deprecate go.opentelemetry.io/otel/example/view package in favor of go.opentelemetry.io/otel/example/prometheus. (Move view example into prometheus example, and deprecate /example/view #4649)
• Deprecate go.opentelemetry.io/otel/exporters/otlp/otlpmetric. (Deprecate otlpmetric #4693)

Changed

• go.opentelemetry.io/otel/bridge/opencensus.NewMetricProducer returns a *MetricProducer struct instead of the metric.Producer interface. (opencensus.NewMetricProducer returns a struct instead of the metric.Producer interface #4583)
• The TracerProvider in go.opentelemetry.io/otel/trace now embeds the go.opentelemetry.io/otel/trace/embedded.TracerProvider type.
  This extends the TracerProvider interface and is is a breaking change for any existing implementation.
  Implementors need to update their implementations based on what they want the default behavior of the interface to be.
  See the "API Implementations" section of the go.opentelemetry.io/otel/trace package documentation for more information about how to accomplish this. (Add embedded package to trace API #4620)
• The Tracer in go.opentelemetry.io/otel/trace now embeds the go.opentelemetry.io/otel/trace/embedded.Tracer type.
  This extends the Tracer interface and is is a breaking change for any existing implementation.
  Implementors need to update their implementations based on what they want the default behavior of the interface to be.
  See the "API Implementations" section of the go.opentelemetry.io/otel/trace package documentation for more informationabout how to accomplish this. (Add embedded package to trace API #4620)
• The Span in go.opentelemetry.io/otel/trace now embeds the go.opentelemetry.io/otel/trace/embedded.Span type.
  This extends the Span interface and is is a breaking change for any existing implementation.
  Implementors need to update their implementations based on what they want the default behavior of the interface to be.
  See the "API Implementations" section of the go.opentelemetry.io/otel/trace package documentation for more information about how to accomplish this. (Add embedded package to trace API #4620)
• go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc does no longer depend on go.opentelemetry.io/otel/exporters/otlp/otlpmetric. (Decouple otlpmetricgrpc and otlpmetrichttp from otlpmetric #4660)
• go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp does no longer depend on go.opentelemetry.io/otel/exporters/otlp/otlpmetric. (Decouple otlpmetricgrpc and otlpmetrichttp from otlpmetric #4660)
• Retry for 502 Bad Gateway and 504 Gateway Timeout HTTP statuses in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp. (otlptracehttp, otlpmetrichttp: Retry for 502, 504 HTTP statuses #4670)
• Retry for 502 Bad Gateway and 504 Gateway Timeout HTTP statuses in go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp. (otlptracehttp, otlpmetrichttp: Retry for 502, 504 HTTP statuses #4670)
• Retry for RESOURCE_EXHAUSTED only if RetryInfo is returned in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc. (otlptracegrpc, otlpmetricgrpc: Retry for RESOURCE_EXHAUSTED only if RetryInfo is returned #4669)
• Retry for RESOURCE_EXHAUSTED only if RetryInfo is returned in go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc. (otlptracegrpc, otlpmetricgrpc: Retry for RESOURCE_EXHAUSTED only if RetryInfo is returned #4669)
• Retry temporary HTTP request failures in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp. (otlptracehttp, otlpmetrichttp: Retry temporary HTTP request failures #4679)
• Retry temporary HTTP request failures in go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp. (otlptracehttp, otlpmetrichttp: Retry temporary HTTP request failures #4679)

Fixed

• Fix improper parsing of characters such us +, / by Parse in go.opentelemetry.io/otel/baggage as they were rendered as a whitespace. (Use url.PathUnescape rather than url.QueryUnescape in baggage parsing #4667)
• Fix improper parsing of characters such us +, / passed via OTEL_RESOURCE_ATTRIBUTES in go.opentelemetry.io/otel/sdk/resource as they were rendered as a whitespace. (Use url.PathUnescape when parsing OTLP headers and resource attributes env vars #4699)
• Fix improper parsing of characters such us +, / passed via OTEL_EXPORTER_OTLP_HEADERS and OTEL_EXPORTER_OTLP_METRICS_HEADERS in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc as they were rendered as a whitespace. (Use url.PathUnescape when parsing OTLP headers and resource attributes env vars #4699)
• Fix improper parsing of characters such us +, / passed via OTEL_EXPORTER_OTLP_HEADERS and OTEL_EXPORTER_OTLP_METRICS_HEADERS in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp as they were rendered as a whitespace. (Use url.PathUnescape when parsing OTLP headers and resource attributes env vars #4699)
• Fix improper parsing of characters such us +, / passed via OTEL_EXPORTER_OTLP_HEADERS and OTEL_EXPORTER_OTLP_TRACES_HEADERS in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlptracegrpc as they were rendered as a whitespace. (Use url.PathUnescape when parsing OTLP headers and resource attributes env vars #4699)
• Fix improper parsing of characters such us +, / passed via OTEL_EXPORTER_OTLP_HEADERS and OTEL_EXPORTER_OTLP_TRACES_HEADERS in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlptracehttp as they were rendered as a whitespace. (Use url.PathUnescape when parsing OTLP headers and resource attributes env vars #4699)
• In go.opentelemetry.op/otel/exporters/prometheus, the exporter no longer Collects metrics after Shutdown is invoked. (Prometheus exporter no longer collects metrics after shutdown #4648)
• Fix documentation for WithCompressor in go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc. (otlp: Refine documentation #4695)
• Fix documentation for WithCompressor in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc. (otlp: Refine documentation #4695)

[codecov]

Codecov Report

Merging #4705 (87ec88d) into main (94a41d7) will not change coverage.
The diff coverage is 100.0%.

@@          Coverage Diff          @@
##            main   #4705   +/-   ##
=====================================
  Coverage   81.8%   81.8%           
=====================================
  Files        225     225           
  Lines      18087   18087           
=====================================
  Hits       14796   14796           
  Misses      2994    2994           
  Partials     297     297           

Files	Coverage Δ
bridge/opencensus/version.go	100.0% <100.0%> (ø)
...xporters/otlp/otlpmetric/otlpmetricgrpc/version.go	100.0% <100.0%> (ø)
...xporters/otlp/otlpmetric/otlpmetrichttp/version.go	100.0% <100.0%> (ø)
exporters/otlp/otlpmetric/version.go	100.0% <100.0%> (ø)
exporters/otlp/otlptrace/version.go	100.0% <100.0%> (ø)
sdk/metric/version.go	100.0% <100.0%> (ø)
sdk/version.go	100.0% <100.0%> (ø)
version.go	100.0% <100.0%> (ø)

[pellared]

@MrAlias Thanks. Can you take another look?

[pellared]

@dianashevchenko @katiehockman @darccio:
https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/ddtrace/opentelemetry would require changes after this release (because of #4620).

[MrAlias]

🚀