Releases: open-o11y/opentelemetry-go
Releases · open-o11y/opentelemetry-go
Release refs/heads/cd-test-master
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog.
This project adheres to Semantic Versioning.
[Unreleased]
Changed
- Move the OpenCensus example into
example
directory. (open-telemetry#1359) NewExporter
andStart
functions ingo.opentelemetry.io/otel/exporters/otlp
now receivecontext.Context
as a first parameter. (open-telemetry#1357)
[0.14.0] - 2020-11-19
Added
- An
EventOption
and the relatedNewEventConfig
function are added to thego.opentelemetry.io/otel
package to configure Span events. (open-telemetry#1254) - A
TextMapPropagator
and associatedTextMapCarrier
are added to thego.opentelemetry.io/otel/oteltest
package to testTextMap
type propagators and their use. (open-telemetry#1259) SpanContextFromContext
returnsSpanContext
from context. (open-telemetry#1255)DeploymentEnvironmentKey
added togo.opentelemetry.io/otel/semconv
package. (open-telemetry#1323)- Add an OpenCensus to OpenTelemetry tracing bridge. (open-telemetry#1305)
- Add a parent context argument to
SpanProcessor.OnStart
to follow the specification. (open-telemetry#1333) - Add missing tests for
sdk/trace/attributes_map.go
. (open-telemetry#1337)
Changed
- Move the
go.opentelemetry.io/otel/api/trace
package intogo.opentelemetry.io/otel/trace
with the following changes. (open-telemetry#1229) (open-telemetry#1307)ID
has been renamed toTraceID
.IDFromHex
has been renamed toTraceIDFromHex
.EmptySpanContext
is removed.
- Move the
go.opentelemetry.io/otel/api/trace/tracetest
package intogo.opentelemetry.io/otel/oteltest
. (open-telemetry#1229) - OTLP Exporter updates:
- supports OTLP v0.6.0 (open-telemetry#1230, open-telemetry#1354)
- supports configurable aggregation temporality (default: Cumulative, optional: Stateless). (open-telemetry#1296)
- The Sampler is now called on local child spans. (open-telemetry#1233)
- The
Kind
type from thego.opentelemetry.io/otel/api/metric
package was renamed toInstrumentKind
to more specifically describe what it is and avoid semantic ambiguity. (open-telemetry#1240) - The
MetricKind
method of theDescriptor
type in thego.opentelemetry.io/otel/api/metric
package was renamed toDescriptor.InstrumentKind
.
This matches the returned type and fixes misuse of the term metric. (open-telemetry#1240) - Move test harness from the
go.opentelemetry.io/otel/api/apitest
package intogo.opentelemetry.io/otel/oteltest
. (open-telemetry#1241) - Move the
go.opentelemetry.io/otel/api/metric/metrictest
package intogo.opentelemetry.io/oteltest
as part of open-telemetry#964. (open-telemetry#1252) - Move the
go.opentelemetry.io/otel/api/metric
package intogo.opentelemetry.io/otel/metric
as part of open-telemetry#1303. (open-telemetry#1321) - Move the
go.opentelemetry.io/otel/api/metric/registry
package intogo.opentelemetry.io/otel/metric/registry
as a part of open-telemetry#1303. (open-telemetry#1316) - Move the
Number
type (together with related functions) fromgo.opentelemetry.io/otel/api/metric
package intogo.opentelemetry.io/otel/metric/number
as a part of open-telemetry#1303. (open-telemetry#1316) - The function signature of the Span
AddEvent
method ingo.opentelemetry.io/otel
is updated to no longer take an unused context and instead take a required name and a variable number ofEventOption
s. (open-telemetry#1254) - The function signature of the Span
RecordError
method ingo.opentelemetry.io/otel
is updated to no longer take an unused context and instead take a required error value and a variable number ofEventOption
s. (open-telemetry#1254) - Move the
go.opentelemetry.io/otel/api/global
package togo.opentelemetry.io/otel
. (open-telemetry#1262) (open-telemetry#1330) - Move the
Version
function fromgo.opentelemetry.io/otel/sdk
togo.opentelemetry.io/otel
. (open-telemetry#1330) - Rename correlation context header from
"otcorrelations"
to"baggage"
to match the OpenTelemetry specification. (open-telemetry#1267) - Fix
Code.UnmarshalJSON
to work with valid JSON only. (open-telemetry#1276) - The
resource.New()
method changes signature to support builtin attributes and functional options, includingtelemetry.sdk.*
and
host.name
semantic conventions; the former method is renamedresource.NewWithAttributes
. (open-telemetry#1235) - The Prometheus exporter now exports non-monotonic counters (i.e.
UpDownCounter
s) as gauges. (open-telemetry#1210) - Correct the
Span.End
method documentation in theotel
API to state updates are not allowed on a span after it has ended. (open-telemetry#1310) - Updated span collection limits for attribute, event and link counts to 1000 (open-telemetry#1318)
- Renamed
semconv.HTTPUrlKey
tosemconv.HTTPURLKey
. (open-telemetry#1338) - Migrated CI/CD from CircleCI to GitHub Actions (open-telemetry#1382)
Removed
- The
ErrInvalidHexID
,ErrInvalidTraceIDLength
,ErrInvalidSpanIDLength
,ErrInvalidSpanIDLength
, orErrNilSpanID
from thego.opentelemetry.io/otel
package are unexported now. (open-telemetry#1243) - The
AddEventWithTimestamp
method on theSpan
interface ingo.opentelemetry.io/otel
is removed due to its redundancy.
It is replaced by using theAddEvent
method with aWithTimestamp
option. (open-telemetry#1254) - The
MockSpan
andMockTracer
types are removed fromgo.opentelemetry.io/otel/oteltest
.
Tracer
andSpan
from the same module should be used in their place instead. (open-telemetry#1306) WorkerCount
option is removed fromgo.opentelemetry.io/otel/exporters/otlp
. (open-telemetry#1350)
Fixed
- Rename
MergeItererator
toMergeIterator
in thego.opentelemetry.io/otel/label
package. (open-telemetry#1244) - The
go.opentelemetry.io/otel/api/global
packages global TextMapPropagator now delegates functionality to a globally set delegate for all previously returned propagators. (open-telemetry#1258) - Fix condition in
label.Any
. (open-telemetry#1299) - Fix global
TracerProvider
to pass options to its configured provider. (open-telemetry#1329) - Fix missing handler for
ExactKind
aggregator in OTLP metrics transformer (open-telemetry#1309)
[0.13.0] - 2020-10-08
Added
- OTLP Metric exporter supports Histogram aggregation. (open-telemetry#1209)
- The
Code
struct from thego.opentelemetry.io/otel/codes
package now supports JSON marshaling and unmarshaling as well as implements theStringer
interface. (open-telemetry#1214) - A Baggage API to implement the OpenTelemetry specification. (open-telemetry#1217)
- Add Shutdown method to sdk/trace/provider, shutdown processors in the order they were registered. (open-telemetry#1227)
Changed
- Set default propagator to no-op propagator. (open-telemetry#1184)
- The
HTTPSupplier
,HTTPExtractor
,HTTPInjector
, andHTTPPropagator
from thego.opentelemetry.io/otel/api/propagation
package were replaced with unifiedTextMapCarrier
andTextMapPropagator
in thego.opentelemetry.io/otel/propagation
package. (open-telemetry#1212) (open-telemetry#1325) - The
New
function from thego.opentelemetry.io/otel/api/propagation
package was replaced withNewCompositeTextMapPropagator
in thego.opentelemetry.io/otel
package. (open-telemetry#1212) - The status codes of the
go.opentelemetry.io/otel/codes
package have been updated to match the latest OpenTelemetry specification.
They now areUnset
,Error
, andOk
.
They no longer track the gRPC codes. (open-telemetry#1214) - The
StatusCode
field of theSpanData
struct in thego.opentelemetry.io/otel/sdk/export/trace
package now uses the codes package from this package instead of the gRPC project. (open-telemetry#1214) - Move the
go.opentelemetry.io/otel/api/baggage
package intogo.opentelemetry.io/otel/baggage
. (open-telemetry#1217) (open-telemetry#1325) - A
Shutdown
method ofSpanProcessor
and all its implementations receives a context and returns an error. (open-telemetry#1264)
Fixed
- Copies of data from arrays and slices passed to
go.opentelemetry.io/otel/label.ArrayValue()
are now used in the returnedValue
instead of using the mutable data itself. (open-telemetry#1226)
Removed
- The
ExtractHTTP
andInjectHTTP
functions from thego.opentelemetry.io/otel/api/propagation
package were removed. (open-telemetry#1212) - The
Propagators
interface from thego.opentelemetry.io/otel/api/propagation
package was removed to conform to the OpenTelemetry specification.
The explicitTextMapPropagator
type can be used in its place as this is thePropagator
type the specification defines. (open-telemetry#1212) - The
SetAttribute
method of theSpan
from thego.opentelemetry.io/otel/api/trace
package was removed given its redundancy with theSetAttributes
method. (open-telemetry#1216) - The internal implementation of Baggage storage is removed in favor of using the new Baggage API functionality. (open-telemetry#1217)
- Remove duplicate hostname key
HostHostNameKey
in Resource semantic conventions. (open-telemetry#1219) - Nested array/slice support has been removed. (open-telemetry#1226)
[0.12.0] - 2020-09-24
Added
- A
SpanConfigure
function ingo.opentelemetry.io/otel/api/trace
to create a newSpanConfig
fromSpanOption
s. (open-telemetry#1108) - In the
go.opentelemetry.io/otel/api/trace
package,NewTracerConfig
was added to construct newTracerConfig
s.
This addition was made to conform with our project option conventions. (open-telemetry#1155) - Instrumentation library information was added to the Zipkin exporter. (open-telemetry#1119)
- The
SpanProcessor
interface now has aForceFlush()
method. (open-telemetry#1166) - More semantic conventions for k8s as resource attributes. (open-telemetry#1167)
Changed
- Add reconnecting udp connection type to Jaeger exporter.
This change adds a new optional implementation of the udp conn interface used to detect changes to an agent's host dns record.
It then adopts the new destination address to ensure the exporter doesn't get stuck. This change was ported from jaegertracing/jaeger-client-go#520. (open-telemetry#1063) - Replace
StartOption
andEndOption
ingo.opentelemetry.io/otel/api/trace
withSpanOption
.
This change is matched by replacing theStartConfig
andEndConfig
with a unifiedSpanConfig
. (open-telemetry#1108) - Replace the
LinkedTo
span option ingo.opentelemetry.io/otel/api/trace
withWithLinks
.
This is be more consistent with our other option patterns, i.e. passing the item to be configured directly instead of its component parts, and provides a cleaner function signature. (open-telemetry#1108) - The
go.opentelemetry.io/otel/api/trace
TracerOption
was changed to an interface to conform to project option conventions. (open-telemetry#1109) - Move the
B3
andTraceContext
from within t...