Release v0.14.0

[MrAlias]

Added

• An EventOption and the related NewEventConfig function are added to the go.opentelemetry.io/otel package to configure Span events. (Update Span API event methods #1254)
• A TextMapPropagator and associated TextMapCarrier are added to the go.opentelemetry.io/otel/oteltest package to test TextMap type propagators and their use. (Add oteltest TextMap propagator and carrier #1259)
• SpanContextFromContext returns SpanContext from context. (Add SpanContextFromContext() #1255)
• DeploymentEnvironmentKey added to go.opentelemetry.io/otel/semconv package. (feat(semconv): Add DeploymentEnvironmentKey to semconv package #1323)
• Add an OpenCensus to OpenTelemetry tracing bridge. (Add opencensus tracing bridge #1305)
• Add a parent context argument to SpanProcessor.OnStart to follow the specification. (Add parent context to SpanProcessor.OnStart #1333)
• Add missing tests for sdk/trace/attributes_map.go. (Add missing tests for attributesMap #1337)

Changed

• Move the go.opentelemetry.io/otel/api/trace package into go.opentelemetry.io/otel/trace with the following changes. (Move trace api package into otel #1229) (Move tracing code to trace package #1307)
  • ID has been renamed to TraceID.
  • IDFromHex has been renamed to TraceIDFromHex.
  • EmptySpanContext is removed.
• Move the go.opentelemetry.io/otel/api/trace/tracetest package into go.opentelemetry.io/otel/oteltest. (Move trace api package into otel #1229)
• OTLP Exporter updates:
  • supports OTLP v0.6.0 (Update proto v0.5.0 #1230, Update OTLP to v0.6.0 #1354)
  • supports configurable aggregation temporality (default: Cumulative, optional: Stateless). (Support configurable AggregationTemporality in exporters; add OTLP missing sum point temporality/monotonic fields #1296)
• The Sampler is now called on local child spans. (Call sampler on local child spans. #1233)
• The Kind type from the go.opentelemetry.io/otel/api/metric package was renamed to InstrumentKind to more specifically describe what it is and avoid semantic ambiguity. (Rename Kind from the api/metric package #1240)
• The MetricKind method of the Descriptor type in the go.opentelemetry.io/otel/api/metric package was renamed to Descriptor.InstrumentKind.
  This matches the returned type and fixes misuse of the term metric. (Rename Kind from the api/metric package #1240)
• Move test harness from the go.opentelemetry.io/otel/api/apitest package into go.opentelemetry.io/otel/oteltest. (Move api/apitest into the otel/oteltest package #1241)
• Move the go.opentelemetry.io/otel/api/metric/metrictest package into go.opentelemetry.io/oteltest as part of Move OpenTelemetry API to top level go.opentelemetry.io/otel package #964. (Move metric api package into otel #1252)
• Move the go.opentelemetry.io/otel/api/metric package into go.opentelemetry.io/otel/metric as part of Encapsulate OTel API #1303. (Move metric code to a separate package #1321)
• Move the go.opentelemetry.io/otel/api/metric/registry package into go.opentelemetry.io/otel/metric/registry as a part of Encapsulate OTel API #1303. (Prepare to move metrics code to separate subpackage #1316)
• Move the Number type (together with related functions) from go.opentelemetry.io/otel/api/metric package into go.opentelemetry.io/otel/metric/number as a part of Encapsulate OTel API #1303. (Prepare to move metrics code to separate subpackage #1316)
• The function signature of the Span AddEvent method in go.opentelemetry.io/otel is updated to no longer take an unused context and instead take a required name and a variable number of EventOptions. (Update Span API event methods #1254)
• The function signature of the Span RecordError method in go.opentelemetry.io/otel is updated to no longer take an unused context and instead take a required error value and a variable number of EventOptions. (Update Span API event methods #1254)
• Move the go.opentelemetry.io/otel/api/global package to go.opentelemetry.io/otel. (Move the otel/api/global package to otel/global #1262) (Move Version function and code from global to toplevel #1330)
• Move the Version function from go.opentelemetry.io/otel/sdk to go.opentelemetry.io/otel. (Move Version function and code from global to toplevel #1330)
• Rename correlation context header from "otcorrelations" to "baggage" to match the OpenTelemetry specification. (Renaming otcorrelations header to baggage #1267)
• Fix Code.UnmarshalJSON to work with valid JSON only. (Fix Code.UnmarshalJSON to work with valid json only #1276)
• The resource.New() method changes signature to support builtin attributes and functional options, including telemetry.sdk.* and
  host.name semantic conventions; the former method is renamed resource.NewWithAttributes. (Change resource.New() to use functional options; add builtin attributes for (host.*, telemetry.sdk.*) #1235)
• The Prometheus exporter now exports non-monotonic counters (i.e. UpDownCounters) as gauges. (Prometheus exporter should use Gauge for non-monotonic sums #1210)
• Correct the Span.End method documentation in the otel API to state updates are not allowed on a span after it has ended. (Update Span End method documentation #1310)
• Updated span collection limits for attribute, event and link counts to 1000 (Update span collection limits to 1000 #1318)
• Renamed semconv.HTTPUrlKey to semconv.HTTPURLKey. (s/HTTPUrlKey/HTTPURLKey/ in semconv #1338)

Removed

• The ErrInvalidHexID, ErrInvalidTraceIDLength, ErrInvalidSpanIDLength, ErrInvalidSpanIDLength, or ErrNilSpanID from the go.opentelemetry.io/otel package are unexported now. (Fix lint issues in otel package #1243)
• The AddEventWithTimestamp method on the Span interface in go.opentelemetry.io/otel is removed due to its redundancy.
  It is replaced by using the AddEvent method with a WithTimestamp option. (Update Span API event methods #1254)
• The MockSpan and MockTracer types are removed from go.opentelemetry.io/otel/oteltest.
  Tracer and Span from the same module should be used in their place instead. (Remove MockSpan and MockTracer #1306)
• WorkerCount option is removed from go.opentelemetry.io/otel/exporters/otlp. (Some cleanups in otlp exporter #1350)

Fixed

• Rename MergeItererator to MergeIterator in the go.opentelemetry.io/otel/label package. (Fix lint issues in the label package #1244)
• The go.opentelemetry.io/otel/api/global packages global TextMapPropagator now delegates functionality to a globally set delegate for all previously returned propagators. (Add delegating global propagator #1258)
• Fix condition in label.Any. (Check marshalled value instead of iface #1299)
• Fix global TracerProvider to pass options to its configured provider. (Pass options to configured TracerProvider #1329)
• Fix missing handler for ExactKind aggregator in OTLP metrics transformer (support exact kind in OTLP metrics exporter #1309)

[codecov]

Codecov Report

Merging #1355 (dfec659) into master (34aa681) will not change coverage.
The diff coverage is 0.0%.

@@          Coverage Diff           @@
##           master   #1355   +/-   ##
======================================
  Coverage    77.4%   77.4%           
======================================
  Files         124     124           
  Lines        6104    6104           
======================================
  Hits         4730    4730           
  Misses       1125    1125           
  Partials      249     249           

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