Release v1.17.0/v0.40.0/v0.0.5

[MrAlias]

Added

• Export the ManualReader struct in go.opentelemetry.io/otel/sdk/metric. (sdk/metric: Reader factories return structs #4244)
• Export the PeriodicReader struct in go.opentelemetry.io/otel/sdk/metric. (sdk/metric: Reader factories return structs #4244)
• Add support for exponential histogram aggregations.
  A histogram can be configured as an exponential histogram using a view with "go.opentelemetry.io/otel/sdk/metric".ExponentialHistogram as the aggregation. (Add the Exponential Histogram Aggregator. #4245)
• Export the Exporter struct in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc. (Add otlpmetricgrpc.Expoter and otlpmetrichttp.Exporter #4272)
• Export the Exporter struct in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp. (Add otlpmetricgrpc.Expoter and otlpmetrichttp.Exporter #4272)
• The exporters in go.opentelemetry.io/otel/exporters/otlp/otlpmetric now support the OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE environment variable. (Add otlpmetric Temporality Preference env var #4287)
• Add WithoutCounterSuffixes option in go.opentelemetry.io/otel/exporters/prometheus to disable addition of _total suffixes. (Add WithoutCounterSuffixes option in the prometheus exporter #4306)
• Add info and debug logging to the metric SDK in go.opentelemetry.io/otel/sdk/metric. (Add info/debug logging to the metric SDK #4315)
• The go.opentelemetry.io/otel/semconv/v1.21.0 package.
  The package contains semantic conventions from the v1.21.0 version of the OpenTelemetry Semantic Conventions. (Add semconv/v1.21.0 #4362)
• Accept 201 to 299 HTTP status as success in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp and go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp. (Handle 2xx as success for OTLP HTTP trace and metric exporters #4365)
• Document the Temporality and Aggregation methods of the "go.opentelemetry.io/otel/sdk/metric".Exporter" need to be concurrent safe. (Document the Reader and Exporter concurrent safe requirements #4381)
• Expand the set of units supported by the Prometheus exporter, and don't add unit suffixes if they are already present in go.opentelemetry.op/otel/exporters/prometheus (Expand the set of units supported by the prometheus exporter #4374)
• Move the Aggregation interface and its implementations from go.opentelemetry.io/otel/sdk/metric/aggregation to go.opentelemetry.io/otel/sdk/metric. (Flatten sdk/metric/aggregation into sdk/metric #4435)
• The exporters in go.opentelemetry.io/otel/exporters/otlp/otlpmetric now support the OTEL_EXPORTER_OTLP_METRICS_DEFAULT_HISTOGRAM_AGGREGATION environment variable. (Support default histogram selection in OTLP exporter #4437)
• Add the NewAllowKeysFilter and NewDenyKeysFilter functions to go.opentelemetry.io/otel/attribute to allow convenient creation of allow-keys and deny-keys filters. (Switch Stream back to having an AttributeFilter field and add New*Filter functions #4444)

Changed

• Starting from v1.21.0 of semantic conventions, go.opentelemetry.io/otel/semconv/{version}/httpconv and go.opentelemetry.io/otel/semconv/{version}/netconv packages will no longer be published. (semconv: Stop generating httpconv.go, netconv.go, http.go #4145)
• Log duplicate instrument conflict at a warning level instead of info in go.opentelemetry.io/otel/sdk/metric. (Warn instead of Info log instrument conflict #4202)
• Return an error on the creation of new instruments in go.opentelemetry.io/otel/sdk/metric if their name doesn't pass regexp validation. (Validate instrument names when creating them #4210)
• NewManualReader in go.opentelemetry.io/otel/sdk/metric returns *ManualReader instead of Reader. (sdk/metric: Reader factories return structs #4244)
• NewPeriodicReader in go.opentelemetry.io/otel/sdk/metric returns *PeriodicReader instead of Reader. (sdk/metric: Reader factories return structs #4244)
• Count the Collect time in the PeriodicReader timeout in go.opentelemetry.io/otel/sdk/metric. (Count the Collect duration towards the PeriodicReader timeout, and document the behavior #4221)
• The function New in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc returns *Exporter instead of "go.opentelemetry.io/otel/sdk/metric".Exporter. (Add otlpmetricgrpc.Expoter and otlpmetrichttp.Exporter #4272)
• The function New in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp returns *Exporter instead of "go.opentelemetry.io/otel/sdk/metric".Exporter. (Add otlpmetricgrpc.Expoter and otlpmetrichttp.Exporter #4272)
• If an attribute set is omitted from an async callback, the previous value will no longer be exported in go.opentelemetry.io/otel/sdk/metric. (Metric SDK: Do not export non-observed attribute sets for async instruments #4290)
• If an attribute set is observed multiple times in an async callback in go.opentelemetry.io/otel/sdk/metric, the values will be summed instead of the last observation winning. (Metric SDK: Sum duplicate async observations regardless of filtering #4289)
• Allow the explicit bucket histogram aggregation to be used for the up-down counter, observable counter, observable up-down counter, and observable gauge in the go.opentelemetry.io/otel/sdk/metric package. (Allow histogram for all instruments #4332)
• Restrict Meters in go.opentelemetry.io/otel/sdk/metric to only register and collect instruments it created. (Restrict Meters to only register and collect instruments it created #4333)
• PeriodicReader.Shutdown and PeriodicReader.ForceFlush in go.opentelemetry.io/otel/sdk/metric now apply the periodic reader's timeout to the operation if the user provided context does not contain a deadline. (PeriodicReader.Shutdown now applies the periodic reader's timeout by default #4356, Use PeriodicReader timeout for ForceFlush #4377)
• Upgrade all use of go.opentelemetry.io/otel/semconv to use v1.21.0. (Upgrade all use of semconv to v1.21.0 #4408)
• Increase instrument name maximum length from 63 to 255 characters in go.opentelemetry.io/otel/sdk/metric. (Increase instrument name maximum length from 63 to 255 characters #4434)
• Add go.opentelemetry.op/otel/sdk/metric.WithProducer as an Option for "go.opentelemetry.io/otel/sdk/metric".NewManualReader and "go.opentelemetry.io/otel/sdk/metric".NewPeriodicReader. (Change metric.Producer to be an Option on Reader #4346)

Removed

• Remove Reader.RegisterProducer in go.opentelemetry.io/otel/metric.
  Use the added WithProducer option instead. (Change metric.Producer to be an Option on Reader #4346)
• Remove Reader.ForceFlush in go.opentelemetry.io/otel/metric.
  Notice that PeriodicReader.ForceFlush is still available. (sdk/metric: Remove Reader.ForceFlush and ManualReader.ForceFlush #4375)

Fixed

• Correctly format log messages from the go.opentelemetry.io/otel/exporters/zipkin exporter. (Format log message before logging with logr #4143)
• Log an error for calls to NewView in go.opentelemetry.io/otel/sdk/metric that have empty criteria. (Log an error for an empty view criteria #4307)
• Fix "go.opentelemetry.io/otel/sdk/resource".WithHostID() to not set an empty host.id. (Fix empty host.id #4317)
• Use the instrument identifying fields to cache aggregators and determine duplicate instrument registrations in go.opentelemetry.io/otel/sdk/metric. (Use inst ID for agg cache key #4337)
• Detect duplicate instruments for case-insensitive names in go.opentelemetry.io/otel/sdk/metric. (Detect duplicate instruments for case-insensitive names #4338)
• The ManualReader will not panic if AggregationSelector returns nil in go.opentelemetry.io/otel/sdk/metric. (Add tests for malformed selectors in readers #4350)
• If a Reader's AggregationSelector returns nil or DefaultAggregation the pipeline will use the default aggregation. (Add tests for malformed selectors in readers #4350)
• Log a suggested view that fixes instrument conflicts in go.opentelemetry.io/otel/sdk/metric. (Log a view suggestion for duplicate instrument conflicts #4349)
• Fix possible panic, deadlock and race condition in batch span processor in go.opentelemetry.io/otel/sdk/trace. (Fix panic, deadlock and race in BatchSpanProcessor #4353)
• Improve context cancellation handling in batch span processor's ForceFlush in go.opentelemetry.io/otel/sdk/trace. (sdk/trace: Refine context cancellation in batchSpanProcessor.ForceFlush #4369)
• Decouple go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal from go.opentelemetry.io/otel/exporters/otlp/internal using gotmpl. (Decouple otlp/otlptrace/internal from otlp/internal using gotmpl #4397, Do not depend on internal packages of different modules #3846)
• Decouple go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc/internal from go.opentelemetry.io/otel/exporters/otlp/internal and go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal using gotmpl. (Decouple otlp/otlpmetric/otlpmetricgrpc from otlp/internal and otlp/otlpmetric/internal using gotmp #4404, Do not depend on internal packages of different modules #3846)
• Decouple go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp/internal from go.opentelemetry.io/otel/exporters/otlp/internal and go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal using gotmpl. (Decouple otlp/otlpmetric/otlpmetrichttp from otlp/internal and otlp/otlpmetric/internal using gotmp #4407, Do not depend on internal packages of different modules #3846)
• Decouple go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc/internal from go.opentelemetry.io/otel/exporters/otlp/internal and go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal using gotmpl. (Decouple otlp/otlptrace/otlptracegrpc from otlp/internal and otlp/otlptrace/internal using gotmpl #4400, Do not depend on internal packages of different modules #3846)
• Decouple go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp/internal from go.opentelemetry.io/otel/exporters/otlp/internal and go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal using gotmpl. (Decouple otlp/otlptrace/otlptracehttp from otlp/internal and otlp/otlptrace/internal using gotmpl #4401, Do not depend on internal packages of different modules #3846)
• Do not block the metric SDK when OTLP metric exports are blocked in go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc and go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp. (Metric creation slowed down by unreachable collector with gRPC #3925, Do not block Temporality/Aggregation on OTLP metric export #4395)
• Do not append _total if the counter already has that suffix for the Prometheus exproter in go.opentelemetry.io/otel/exporter/prometheus. (Prometheus exporter: do not append _total if the metric already ends in _total #4373)
• Fix resource detection data race in go.opentelemetry.io/otel/sdk/resource. (sdk/resource: Fix data race with emptyAttributes #4409)
• Use the first-seen instrument name during instrument name conflicts in go.opentelemetry.io/otel/sdk/metric. (Use first-seen instrument name for name conflicts #4428)

Deprecated

• The go.opentelemetry.io/otel/exporters/jaeger package is deprecated.
  OpenTelemetry dropped support for Jaeger exporter in July 2023.
  Use go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp
  or go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc instead. (Deprecate exporters/jaeger #4423)
• The go.opentelemetry.io/otel/example/jaeger package is deprecated. (Deprecate exporters/jaeger #4423)
• The go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal package is deprecated. (Deprecate the otlpmetric/internal package and sub-packages #4420)
• The go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal/oconf package is deprecated. (Deprecate the otlpmetric/internal package and sub-packages #4420)
• The go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal/otest package is deprecated. (Deprecate the otlpmetric/internal package and sub-packages #4420)
• The go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal/transform package is deprecated. (Deprecate the otlpmetric/internal package and sub-packages #4420)
• The go.opentelemetry.io/otel/exporters/otlp/internal package is deprecated. (Deprecate the otlp/internal package and all sub-packages #4421)
• The go.opentelemetry.io/otel/exporters/otlp/internal/envconfig package is deprecated. (Deprecate the otlp/internal package and all sub-packages #4421)
• The go.opentelemetry.io/otel/exporters/otlp/internal/retry package is deprecated. (Deprecate the otlp/internal package and all sub-packages #4421)
• The go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal package is deprecated. (Deprecate the otlptrace/internal packages #4425)
• The go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal/envconfig package is deprecated. (Deprecate the otlptrace/internal packages #4425)
• The go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal/otlpconfig package is deprecated. (Deprecate the otlptrace/internal packages #4425)
• The go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal/otlptracetest package is deprecated. (Deprecate the otlptrace/internal packages #4425)
• The go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal/retry package is deprecated. (Deprecate the otlptrace/internal packages #4425)
• The go.opentelemetry.io/otel/sdk/metric/aggregation package is deprecated.
  Use the aggregation types added to go.opentelemetry.io/otel/sdk/metric instead. (Flatten sdk/metric/aggregation into sdk/metric #4435)

[MrAlias]

I would like to include #4463 in this release. Planning to wait for that to merge.

[codecov]

Codecov Report

Merging #4464 (e96d232) into main (183e081) will increase coverage by 0.0%.
The diff coverage is 100.0%.

Additional details and impacted files

@@          Coverage Diff          @@
##            main   #4464   +/-   ##
=====================================
  Coverage   78.9%   78.9%           
=====================================
  Files        255     255           
  Lines      20651   20651           
=====================================
+ Hits       16308   16312    +4     
+ Misses      3999    3995    -4     
  Partials     344     344           

Files Changed	Coverage Δ
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%> (ø)

... and 2 files with indirect coverage changes