Release v1.14.0/v0.37.0/v0.0.4

[MrAlias]

Part of #3809

This release is the last to support Go 1.18.
The next release will require at least Go 1.19.

Added

• The event type semantic conventions are added to go.opentelemetry.io/otel/semconv/v1.17.0. (Add semantic conventions of the event type #3697)
• Support Go 1.20. (Add testing for Go 1.20 #3693)
• The go.opentelemetry.io/otel/semconv/v1.18.0 package.
  The package contains semantic conventions from the v1.18.0 version of the OpenTelemetry specification. (Add semconv/v1.18.0 #3719)
  • The following const renames from go.opentelemetry.io/otel/semconv/v1.17.0 are included:
    • OtelScopeNameKey -> OTelScopeNameKey
    • OtelScopeVersionKey -> OTelScopeVersionKey
    • OtelLibraryNameKey -> OTelLibraryNameKey
    • OtelLibraryVersionKey -> OTelLibraryVersionKey
    • OtelStatusCodeKey -> OTelStatusCodeKey
    • OtelStatusDescriptionKey -> OTelStatusDescriptionKey
    • OtelStatusCodeOk -> OTelStatusCodeOk
    • OtelStatusCodeError -> OTelStatusCodeError
  • The following func renames from go.opentelemetry.io/otel/semconv/v1.17.0 are included:
    • OtelScopeName -> OTelScopeName
    • OtelScopeVersion -> OTelScopeVersion
    • OtelLibraryName -> OTelLibraryName
    • OtelLibraryVersion -> OTelLibraryVersion
    • OtelStatusDescription -> OTelStatusDescription
• A IsSampled method is added to the SpanContext implementation in go.opentelemetry.io/otel/bridge/opentracing to expose the span sampled state.
  See the README for more information. (Implement IsSampled for OpenTelemetry bridgeSpanContext #3570)
• The WithInstrumentationAttributes option to go.opentelemetry.io/otel/metric. (Accept scope attributes during Meter creation #3738)
• The WithInstrumentationAttributes option to go.opentelemetry.io/otel/trace. (Accept scope attributes during Tracer creation #3739)
• The following environment variables are supported by the periodic Reader in go.opentelemetry.io/otel/sdk/metric. (Support OTEL_METRIC_EXPORT_INTERVAL and OTEL_METRIC_EXPORT_TIMEOUT #3763)
  • OTEL_METRIC_EXPORT_INTERVAL sets the time between collections and exports.
  • OTEL_METRIC_EXPORT_TIMEOUT sets the timeout an export is attempted.

Changed

• Fall-back to TextMapCarrier when it's not HttpHeaders in go.opentelemetry.io/otel/bridge/opentracing. ([bridge/ot] Fall-back to TextMap carrier when it's not ot.HttpHeaders #3679)
• The Collect method of the "go.opentelemetry.io/otel/sdk/metric".Reader interface is updated to accept the metricdata.ResourceMetrics value the collection will be made into.
  This change is made to enable memory reuse by SDK users. (Change the Reader.Collect Signature. #3732)
• The WithUnit option in go.opentelemetry.io/otel/sdk/metric/instrument is updated to accept a string for the unit value. (Deprecate metric/unit and use a string for units in the metric API/SDK #3776)

Fixed

• Ensure go.opentelemetry.io/otel does not use generics. (The otel package implicitly requires Go >= 1.18 #3723, Refactor package internal/attribute to not use generics. #3725)
• Multi-reader MeterProviders now export metrics for all readers, instead of just the first reader. (Meter provider don't work with multiple readers  #3720, Merge instrument cache to inserter #3724)
• Remove use of deprecated "math/rand".Seed in go.opentelemetry.io/otel/example/prometheus. (Bump CI default version of Go to 1.20 #3733)
• Do not silently drop unknown schema data with Parse in go.opentelemetry.io/otel/schema/v1.1. (Do no silently drop unknown schema data #3743)
• Data race issue in OTLP exporter retry mechanism. (Multiple NewTracerProvider calls with the same batcher cause data race #3755, Allow using OTLP export retrier concurrently #3756)
• Wrapping empty errors when exporting in go.opentelemetry.io/otel/sdk/metric. (Confusing error messages with metric multierror type if wrapped is unset #3698, Do not wrap error if multierror does not have one. #3772)
• Incorrect "all" and "resource" definition for schema files in go.opentelemetry.io/otel/schema/v1.1. (Fix incorrect "all" and "resource" definition for Schema File #3777)

Deprecated

• The go.opentelemetry.io/otel/metric/unit package is deprecated.
  Use the equivalent unit string instead. (Deprecate metric/unit and use a string for units in the metric API/SDK #3776)
  • Use "1" instead of unit.Dimensionless
  • Use "By" instead of unit.Bytes
  • Use "ms" instead of unit.Milliseconds

[codecov]

Codecov Report

Merging #3810 (92749c4) into main (46d7f8d) will increase coverage by 0.0%.
The diff coverage is 100.0%.

Additional details and impacted files

@@          Coverage Diff          @@
##            main   #3810   +/-   ##
=====================================
  Coverage   81.6%   81.7%           
=====================================
  Files        167     167           
  Lines      12453   12453           
=====================================
+ Hits       10171   10175    +4     
+ Misses      2067    2063    -4     
  Partials     215     215           

Impacted Files	Coverage Δ
version.go	100.0% <100.0%> (ø)
exporters/jaeger/jaeger.go	91.1% <0.0%> (+0.8%)	⬆️
sdk/trace/batch_span_processor.go	81.1% <0.0%> (+0.8%)	⬆️