Release v1.11.2/v0.34.0

[MadVikingGod]

Added

• The WithView Option is added to the go.opentelemetry.io/otel/sdk/metric package.
  This option is used to configure the view(s) a MeterProvider will use for all Readers that are registered with it. (Associate views with MeterProvider instead of Reader #3387)
• Add Instrumentation Scope and Version as info metric and label in Prometheus exporter.
  This can be disabled using the WithoutScopeInfo() option added to that package.(Add Instrumentation Scope and Version as info metric and label in Prometheus exporter #3273, prometheus exporter convert instrumentation scope to otel_scope_info metric #3357)
• OTLP exporters now recognize: (add new env config options for OTLP exporter #3363)
  • OTEL_EXPORTER_OTLP_INSECURE
  • OTEL_EXPORTER_OTLP_TRACES_INSECURE
  • OTEL_EXPORTER_OTLP_METRICS_INSECURE
  • OTEL_EXPORTER_OTLP_CLIENT_KEY
  • OTEL_EXPORTER_OTLP_TRACES_CLIENT_KEY
  • OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY
  • OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE
  • OTEL_EXPORTER_OTLP_TRACES_CLIENT_CERTIFICATE
  • OTEL_EXPORTER_OTLP_METRICS_CLIENT_CERTIFICATE
• The View type and related NewView function to create a view according to the OpenTelemetry specification are added to go.opentelemetry.io/otel/sdk/metric.
  These additions are replacements for the View type and New function from go.opentelemetry.io/otel/sdk/metric/view. (Add View, NewView, Instrument, Stream, and InstrumentKind to sdk/metric with unit tests #3459)
• The Instrument and InstrumentKind type are added to go.opentelemetry.io/otel/sdk/metric.
  These additions are replacements for the Instrument and InstrumentKind types from go.opentelemetry.io/otel/sdk/metric/view. (Add View, NewView, Instrument, Stream, and InstrumentKind to sdk/metric with unit tests #3459)
• The Stream type is added to go.opentelemetry.io/otel/sdk/metric to define a metric data stream a view will produce. (Add View, NewView, Instrument, Stream, and InstrumentKind to sdk/metric with unit tests #3459)
• The AssertHasAttributes allows instrument authors to test that datapoints returned have appropriate attributes. (Adds an Attribute assertion to metric data test #3487)

Changed

• The "go.opentelemetry.io/otel/sdk/metric".WithReader option no longer accepts views to associate with the Reader.
  Instead, views are now registered directly with the MeterProvider via the new WithView option.
  The views registered with the MeterProvider apply to all Readers. (Associate views with MeterProvider instead of Reader #3387)
• The Temporality(view.InstrumentKind) metricdata.Temporality and Aggregation(view.InstrumentKind) aggregation.Aggregation methods are added to the "go.opentelemetry.io/otel/sdk/metric".Exporter interface. (Move Aggregation/Temporality selection to the Exporter interface #3260)
• The Temporality(view.InstrumentKind) metricdata.Temporality and Aggregation(view.InstrumentKind) aggregation.Aggregation methods are added to the "go.opentelemetry.io/otel/exporters/otlp/otlpmetric".Client interface. (Move Aggregation/Temporality selection to the Exporter interface #3260)
• The WithTemporalitySelector and WithAggregationSelector ReaderOptions have been changed to ManualReaderOptions in the go.opentelemetry.io/otel/sdk/metric package. (Move Aggregation/Temporality selection to the Exporter interface #3260)
• The periodic reader in the go.opentelemetry.io/otel/sdk/metric package now uses the temporality and aggregation selectors from its configured exporter instead of accepting them as options. (Move Aggregation/Temporality selection to the Exporter interface #3260)

Fixed

• The go.opentelemetry.io/otel/exporters/prometheus exporter fixes duplicated _total suffixes. (Fix prometheus name duplicate _total suffix #3369)
• Remove comparable requirement for Readers. (Associate views with MeterProvider instead of Reader #3387)
• Cumulative metrics from the OpenCensus bridge (go.opentelemetry.io/otel/bridge/opencensus) are defined as monotonic sums, instead of non-monotonic. (Set IsMonotonic to true for opencensus sum #3389)
• Asynchronous counters (Counter and UpDownCounter) from the metric SDK now produce delta sums when configured with delta temporality. (Calculate delta sums for delta async counter/up-down-counter types #3398)
• Exported Status codes in the go.opentelemetry.io/otel/exporters/zipkin exporter are now exported as all upper case values. (fix wrong representation of status value in zipkin exporter #3340)
• Aggregations from go.opentelemetry.io/otel/sdk/metric with no data are not exported. ( Exporter version 0.32.0 and higher is not compatible with opentelemetry-collector-contrib #3394, Do not export aggregations without any data points #3436)
• Reenabled Attribute Filters in the Metric SDK. (Adds attribute filter logic #3396)
• Asynchronous callbacks are only called if they are registered with at least one instrument that does not use drop aggragation. (Only registers callbacks if non-drop aggregation is used #3408)
• Do not report empty partial-success responses in the go.opentelemetry.io/otel/exporters/otlp exporters. (Do not handle empty partial OTLP successes #3438, Extraneous Partial Success Error Message Exporting Traces to OTel Collector #3432)
• Handle partial success responses in go.opentelemetry.io/otel/exporters/otlp/otlpmetric exporters. (Partial-success responses for OTLP metrics #3162, Handle partial success response from OTLP server in otlpmetric exporters #3440)
• Prevent duplicate Prometheus description, unit, and type. (prevent conflict metric description #3469)
• Prevents panic when using incorrect attribute.Value.As[Type]Slice(). (Make the AsType functions not panic #3489)

Removed

• The go.opentelemetry.io/otel/exporters/otlp/otlpmetric.Client interface is removed. (Move otlpmetrics Client to an internal package. #3486)
• The go.opentelemetry.io/otel/exporters/otlp/otlpmetric.New function is removed. Use the otlpmetric[http|grpc].New directly. (Move otlpmetrics Client to an internal package. #3486)

Deprecated

• The go.opentelemetry.io/otel/sdk/metric/view package is deprecated.
  Use Instrument, InstrumentKind, View, and NewView in go.opentelemetry.io/otel/sdk/metric instead. (Deprecate the sdk/metric/view package #3476)

[codecov]

Codecov Report

❗ No coverage uploaded for pull request base (main@2243431). Click here to learn what that means.
The diff coverage is 100.0%.

❗ Current head 7c1c4db differs from pull request most recent head 0928e40. Consider uploading reports for the commit 0928e40 to get more accurate results

Additional details and impacted files

@@          Coverage Diff           @@
##             main   #3512   +/-   ##
======================================
  Coverage        ?   78.0%           
======================================
  Files           ?     165           
  Lines           ?   11809           
  Branches        ?       0           
======================================
  Hits            ?    9222           
  Misses          ?    2391           
  Partials        ?     196           

Impacted Files	Coverage Δ
version.go	100.0% <100.0%> (ø)

[yurishkuro]

How do you rationalize this being a patch version 1.11.2, considering how many new features are released?

[christoffer-a63e]

Seems like a new release of https://pkg.go.dev/go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc to match 1.11.2 and 0.34 must also be published? (latest is currently https://pkg.go.dev/go.opentelemetry.io/otel/exporters/otlp/otlpmetric/[email protected])

My go.mod (excerpt):

go 1.19

require (
        go.opentelemetry.io/otel v1.11.2
        go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc v0.33.0
        go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.11.2
        go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc v1.11.2
        go.opentelemetry.io/otel/metric v0.34.0
        go.opentelemetry.io/otel/sdk v1.11.2
        go.opentelemetry.io/otel/sdk/metric v0.34.0
)

$ go build .
>>

~/go/pkg/mod/go.opentelemetry.io/otel/exporters/otlp/otlpmetric/[email protected]/client.go:48:20: undefined: otlpmetric.New
~/go/pkg/mod/go.opentelemetry.io/otel/exporters/otlp/otlpmetric/[email protected]/client.go:66:68: undefined: otlpmetric.Client