1# Changelog
2
3All notable changes to this project will be documented in this file.
4
5The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
6
7This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
8
9## [Unreleased]
10
11## [1.21.0/0.44.0] 2023-11-16
12
13### Removed
14
15- Remove the deprecated `go.opentelemetry.io/otel/bridge/opencensus.NewTracer`. (#4706)
16- Remove the deprecated `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` module. (#4707)
17- Remove the deprecated `go.opentelemetry.io/otel/example/view` module. (#4708)
18- Remove the deprecated `go.opentelemetry.io/otel/example/fib` module. (#4723)
19
20### Fixed
21
22- Do not parse non-protobuf responses in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#4719)
23- Do not parse non-protobuf responses in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#4719)
24
25## [1.20.0/0.43.0] 2023-11-10
26
27This release brings a breaking change for custom trace API implementations. Some interfaces (`TracerProvider`, `Tracer`, `Span`) now embed the `go.opentelemetry.io/otel/trace/embedded` types. Implementors need to update their implementations based on what they want the default behavior to be. See the "API Implementations" section of the [trace API] package documentation for more information about how to accomplish this.
28
29### Added
30
31- Add `go.opentelemetry.io/otel/bridge/opencensus.InstallTraceBridge`, which installs the OpenCensus trace bridge, and replaces `opencensus.NewTracer`. (#4567)
32- Add scope version to trace and metric bridges in `go.opentelemetry.io/otel/bridge/opencensus`. (#4584)
33- Add the `go.opentelemetry.io/otel/trace/embedded` package to be embedded in the exported trace API interfaces. (#4620)
34- Add the `go.opentelemetry.io/otel/trace/noop` package as a default no-op implementation of the trace API. (#4620)
35- Add context propagation in `go.opentelemetry.io/otel/example/dice`. (#4644)
36- Add view configuration to `go.opentelemetry.io/otel/example/prometheus`. (#4649)
37- Add `go.opentelemetry.io/otel/metric.WithExplicitBucketBoundaries`, which allows defining default explicit bucket boundaries when creating histogram instruments. (#4603)
38- Add `Version` function in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#4660)
39- Add `Version` function in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#4660)
40- Add Summary, SummaryDataPoint, and QuantileValue to `go.opentelemetry.io/sdk/metric/metricdata`. (#4622)
41- `go.opentelemetry.io/otel/bridge/opencensus.NewMetricProducer` now supports exemplars from OpenCensus. (#4585)
42- Add support for `WithExplicitBucketBoundaries` in `go.opentelemetry.io/otel/sdk/metric`. (#4605)
43- Add support for Summary metrics in `go.opentelemetry.io/otel/bridge/opencensus`. (#4668)
44
45### Deprecated
46
47- Deprecate `go.opentelemetry.io/otel/bridge/opencensus.NewTracer` in favor of `opencensus.InstallTraceBridge`. (#4567)
48- Deprecate `go.opentelemetry.io/otel/example/fib` package is in favor of `go.opentelemetry.io/otel/example/dice`. (#4618)
49- Deprecate `go.opentelemetry.io/otel/trace.NewNoopTracerProvider`.
50 Use the added `NewTracerProvider` function in `go.opentelemetry.io/otel/trace/noop` instead. (#4620)
51- Deprecate `go.opentelemetry.io/otel/example/view` package in favor of `go.opentelemetry.io/otel/example/prometheus`. (#4649)
52- Deprecate `go.opentelemetry.io/otel/exporters/otlp/otlpmetric`. (#4693)
53
54### Changed
55
56- `go.opentelemetry.io/otel/bridge/opencensus.NewMetricProducer` returns a `*MetricProducer` struct instead of the metric.Producer interface. (#4583)
57- The `TracerProvider` in `go.opentelemetry.io/otel/trace` now embeds the `go.opentelemetry.io/otel/trace/embedded.TracerProvider` type.
58 This extends the `TracerProvider` interface and is is a breaking change for any existing implementation.
59 Implementors need to update their implementations based on what they want the default behavior of the interface to be.
60 See the "API Implementations" section of the `go.opentelemetry.io/otel/trace` package documentation for more information about how to accomplish this. (#4620)
61- The `Tracer` in `go.opentelemetry.io/otel/trace` now embeds the `go.opentelemetry.io/otel/trace/embedded.Tracer` type.
62 This extends the `Tracer` interface and is is a breaking change for any existing implementation.
63 Implementors need to update their implementations based on what they want the default behavior of the interface to be.
64 See the "API Implementations" section of the `go.opentelemetry.io/otel/trace` package documentation for more information about how to accomplish this. (#4620)
65- The `Span` in `go.opentelemetry.io/otel/trace` now embeds the `go.opentelemetry.io/otel/trace/embedded.Span` type.
66 This extends the `Span` interface and is is a breaking change for any existing implementation.
67 Implementors need to update their implementations based on what they want the default behavior of the interface to be.
68 See the "API Implementations" section of the `go.opentelemetry.io/otel/trace` package documentation for more information about how to accomplish this. (#4620)
69- `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` does no longer depend on `go.opentelemetry.io/otel/exporters/otlp/otlpmetric`. (#4660)
70- `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp` does no longer depend on `go.opentelemetry.io/otel/exporters/otlp/otlpmetric`. (#4660)
71- Retry for `502 Bad Gateway` and `504 Gateway Timeout` HTTP statuses in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#4670)
72- Retry for `502 Bad Gateway` and `504 Gateway Timeout` HTTP statuses in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#4670)
73- Retry for `RESOURCE_EXHAUSTED` only if RetryInfo is returned in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#4669)
74- Retry for `RESOURCE_EXHAUSTED` only if RetryInfo is returned in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`. (#4669)
75- Retry temporary HTTP request failures in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#4679)
76- Retry temporary HTTP request failures in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#4679)
77
78### Fixed
79
80- Fix improper parsing of characters such us `+`, `/` by `Parse` in `go.opentelemetry.io/otel/baggage` as they were rendered as a whitespace. (#4667)
81- Fix improper parsing of characters such us `+`, `/` passed via `OTEL_RESOURCE_ATTRIBUTES` in `go.opentelemetry.io/otel/sdk/resource` as they were rendered as a whitespace. (#4699)
82- Fix improper parsing of characters such us `+`, `/` passed via `OTEL_EXPORTER_OTLP_HEADERS` and `OTEL_EXPORTER_OTLP_METRICS_HEADERS` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` as they were rendered as a whitespace. (#4699)
83- Fix improper parsing of characters such us `+`, `/` passed via `OTEL_EXPORTER_OTLP_HEADERS` and `OTEL_EXPORTER_OTLP_METRICS_HEADERS` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp` as they were rendered as a whitespace. (#4699)
84- Fix improper parsing of characters such us `+`, `/` passed via `OTEL_EXPORTER_OTLP_HEADERS` and `OTEL_EXPORTER_OTLP_TRACES_HEADERS` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlptracegrpc` as they were rendered as a whitespace. (#4699)
85- Fix improper parsing of characters such us `+`, `/` passed via `OTEL_EXPORTER_OTLP_HEADERS` and `OTEL_EXPORTER_OTLP_TRACES_HEADERS` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlptracehttp` as they were rendered as a whitespace. (#4699)
86- In `go.opentelemetry.op/otel/exporters/prometheus`, the exporter no longer `Collect`s metrics after `Shutdown` is invoked. (#4648)
87- Fix documentation for `WithCompressor` in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`. (#4695)
88- Fix documentation for `WithCompressor` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#4695)
89
90## [1.19.0/0.42.0/0.0.7] 2023-09-28
91
92This release contains the first stable release of the OpenTelemetry Go [metric SDK].
93Our project stability guarantees now apply to the `go.opentelemetry.io/otel/sdk/metric` package.
94See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
95
96### Added
97
98- Add the "Roll the dice" getting started application example in `go.opentelemetry.io/otel/example/dice`. (#4539)
99- The `WithWriter` and `WithPrettyPrint` options to `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric` to set a custom `io.Writer`, and allow displaying the output in human-readable JSON. (#4507)
100
101### Changed
102
103- Allow '/' characters in metric instrument names. (#4501)
104- The exporter in `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric` does not prettify its output by default anymore. (#4507)
105- Upgrade `gopkg.io/yaml` from `v2` to `v3` in `go.opentelemetry.io/otel/schema`. (#4535)
106
107### Fixed
108
109- In `go.opentelemetry.op/otel/exporters/prometheus`, don't try to create the Prometheus metric on every `Collect` if we know the scope is invalid. (#4499)
110
111### Removed
112
113- Remove `"go.opentelemetry.io/otel/bridge/opencensus".NewMetricExporter`, which is replaced by `NewMetricProducer`. (#4566)
114
115## [1.19.0-rc.1/0.42.0-rc.1] 2023-09-14
116
117This is a release candidate for the v1.19.0/v0.42.0 release.
118That release is expected to include the `v1` release of the OpenTelemetry Go metric SDK and will provide stability guarantees of that SDK.
119See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
120
121### Changed
122
123- Allow '/' characters in metric instrument names. (#4501)
124
125### Fixed
126
127- In `go.opentelemetry.op/otel/exporters/prometheus`, don't try to create the prometheus metric on every `Collect` if we know the scope is invalid. (#4499)
128
129## [1.18.0/0.41.0/0.0.6] 2023-09-12
130
131This release drops the compatibility guarantee of [Go 1.19].
132
133### Added
134
135- Add `WithProducer` option in `go.opentelemetry.op/otel/exporters/prometheus` to restore the ability to register producers on the prometheus exporter's manual reader. (#4473)
136- Add `IgnoreValue` option in `go.opentelemetry.io/otel/sdk/metric/metricdata/metricdatatest` to allow ignoring values when comparing metrics. (#4447)
137
138### Changed
139
140- Use a `TestingT` interface instead of `*testing.T` struct in `go.opentelemetry.io/otel/sdk/metric/metricdata/metricdatatest`. (#4483)
141
142### Deprecated
143
144- The `NewMetricExporter` in `go.opentelemetry.io/otel/bridge/opencensus` was deprecated in `v0.35.0` (#3541).
145 The deprecation notice format for the function has been corrected to trigger Go documentation and build tooling. (#4470)
146
147### Removed
148
149- Removed the deprecated `go.opentelemetry.io/otel/exporters/jaeger` package. (#4467)
150- Removed the deprecated `go.opentelemetry.io/otel/example/jaeger` package. (#4467)
151- Removed the deprecated `go.opentelemetry.io/otel/sdk/metric/aggregation` package. (#4468)
152- Removed the deprecated internal packages in `go.opentelemetry.io/otel/exporters/otlp` and its sub-packages. (#4469)
153- Dropped guaranteed support for versions of Go less than 1.20. (#4481)
154
155## [1.17.0/0.40.0/0.0.5] 2023-08-28
156
157### Added
158
159- Export the `ManualReader` struct in `go.opentelemetry.io/otel/sdk/metric`. (#4244)
160- Export the `PeriodicReader` struct in `go.opentelemetry.io/otel/sdk/metric`. (#4244)
161- Add support for exponential histogram aggregations.
162 A histogram can be configured as an exponential histogram using a view with `"go.opentelemetry.io/otel/sdk/metric".ExponentialHistogram` as the aggregation. (#4245)
163- Export the `Exporter` struct in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#4272)
164- Export the `Exporter` struct in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#4272)
165- The exporters in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` now support the `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` environment variable. (#4287)
166- Add `WithoutCounterSuffixes` option in `go.opentelemetry.io/otel/exporters/prometheus` to disable addition of `_total` suffixes. (#4306)
167- Add info and debug logging to the metric SDK in `go.opentelemetry.io/otel/sdk/metric`. (#4315)
168- The `go.opentelemetry.io/otel/semconv/v1.21.0` package.
169 The package contains semantic conventions from the `v1.21.0` version of the OpenTelemetry Semantic Conventions. (#4362)
170- 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`. (#4365)
171- Document the `Temporality` and `Aggregation` methods of the `"go.opentelemetry.io/otel/sdk/metric".Exporter"` need to be concurrent safe. (#4381)
172- 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` (#4374)
173- Move the `Aggregation` interface and its implementations from `go.opentelemetry.io/otel/sdk/metric/aggregation` to `go.opentelemetry.io/otel/sdk/metric`. (#4435)
174- The exporters in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` now support the `OTEL_EXPORTER_OTLP_METRICS_DEFAULT_HISTOGRAM_AGGREGATION` environment variable. (#4437)
175- Add the `NewAllowKeysFilter` and `NewDenyKeysFilter` functions to `go.opentelemetry.io/otel/attribute` to allow convenient creation of allow-keys and deny-keys filters. (#4444)
176- Support Go 1.21. (#4463)
177
178### Changed
179
180- 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. (#4145)
181- Log duplicate instrument conflict at a warning level instead of info in `go.opentelemetry.io/otel/sdk/metric`. (#4202)
182- Return an error on the creation of new instruments in `go.opentelemetry.io/otel/sdk/metric` if their name doesn't pass regexp validation. (#4210)
183- `NewManualReader` in `go.opentelemetry.io/otel/sdk/metric` returns `*ManualReader` instead of `Reader`. (#4244)
184- `NewPeriodicReader` in `go.opentelemetry.io/otel/sdk/metric` returns `*PeriodicReader` instead of `Reader`. (#4244)
185- Count the Collect time in the `PeriodicReader` timeout in `go.opentelemetry.io/otel/sdk/metric`. (#4221)
186- The function `New` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` returns `*Exporter` instead of `"go.opentelemetry.io/otel/sdk/metric".Exporter`. (#4272)
187- The function `New` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp` returns `*Exporter` instead of `"go.opentelemetry.io/otel/sdk/metric".Exporter`. (#4272)
188- 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`. (#4290)
189- 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. (#4289)
190- 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. (#4332)
191- Restrict `Meter`s in `go.opentelemetry.io/otel/sdk/metric` to only register and collect instruments it created. (#4333)
192- `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. (#4356, #4377)
193- Upgrade all use of `go.opentelemetry.io/otel/semconv` to use `v1.21.0`. (#4408)
194- Increase instrument name maximum length from 63 to 255 characters in `go.opentelemetry.io/otel/sdk/metric`. (#4434)
195- 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`. (#4346)
196
197### Removed
198
199- Remove `Reader.RegisterProducer` in `go.opentelemetry.io/otel/metric`.
200 Use the added `WithProducer` option instead. (#4346)
201- Remove `Reader.ForceFlush` in `go.opentelemetry.io/otel/metric`.
202 Notice that `PeriodicReader.ForceFlush` is still available. (#4375)
203
204### Fixed
205
206- Correctly format log messages from the `go.opentelemetry.io/otel/exporters/zipkin` exporter. (#4143)
207- Log an error for calls to `NewView` in `go.opentelemetry.io/otel/sdk/metric` that have empty criteria. (#4307)
208- Fix `"go.opentelemetry.io/otel/sdk/resource".WithHostID()` to not set an empty `host.id`. (#4317)
209- Use the instrument identifying fields to cache aggregators and determine duplicate instrument registrations in `go.opentelemetry.io/otel/sdk/metric`. (#4337)
210- Detect duplicate instruments for case-insensitive names in `go.opentelemetry.io/otel/sdk/metric`. (#4338)
211- The `ManualReader` will not panic if `AggregationSelector` returns `nil` in `go.opentelemetry.io/otel/sdk/metric`. (#4350)
212- If a `Reader`'s `AggregationSelector` returns `nil` or `DefaultAggregation` the pipeline will use the default aggregation. (#4350)
213- Log a suggested view that fixes instrument conflicts in `go.opentelemetry.io/otel/sdk/metric`. (#4349)
214- Fix possible panic, deadlock and race condition in batch span processor in `go.opentelemetry.io/otel/sdk/trace`. (#4353)
215- Improve context cancellation handling in batch span processor's `ForceFlush` in `go.opentelemetry.io/otel/sdk/trace`. (#4369)
216- Decouple `go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal` from `go.opentelemetry.io/otel/exporters/otlp/internal` using gotmpl. (#4397, #3846)
217- 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. (#4404, #3846)
218- 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. (#4407, #3846)
219- 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. (#4400, #3846)
220- 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. (#4401, #3846)
221- 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`. (#3925, #4395)
222- Do not append `_total` if the counter already has that suffix for the Prometheus exproter in `go.opentelemetry.io/otel/exporter/prometheus`. (#4373)
223- Fix resource detection data race in `go.opentelemetry.io/otel/sdk/resource`. (#4409)
224- Use the first-seen instrument name during instrument name conflicts in `go.opentelemetry.io/otel/sdk/metric`. (#4428)
225
226### Deprecated
227
228- The `go.opentelemetry.io/otel/exporters/jaeger` package is deprecated.
229 OpenTelemetry dropped support for Jaeger exporter in July 2023.
230 Use `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`
231 or `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc` instead. (#4423)
232- The `go.opentelemetry.io/otel/example/jaeger` package is deprecated. (#4423)
233- The `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal` package is deprecated. (#4420)
234- The `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal/oconf` package is deprecated. (#4420)
235- The `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal/otest` package is deprecated. (#4420)
236- The `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal/transform` package is deprecated. (#4420)
237- The `go.opentelemetry.io/otel/exporters/otlp/internal` package is deprecated. (#4421)
238- The `go.opentelemetry.io/otel/exporters/otlp/internal/envconfig` package is deprecated. (#4421)
239- The `go.opentelemetry.io/otel/exporters/otlp/internal/retry` package is deprecated. (#4421)
240- The `go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal` package is deprecated. (#4425)
241- The `go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal/envconfig` package is deprecated. (#4425)
242- The `go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal/otlpconfig` package is deprecated. (#4425)
243- The `go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal/otlptracetest` package is deprecated. (#4425)
244- The `go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal/retry` package is deprecated. (#4425)
245- The `go.opentelemetry.io/otel/sdk/metric/aggregation` package is deprecated.
246 Use the aggregation types added to `go.opentelemetry.io/otel/sdk/metric` instead. (#4435)
247
248## [1.16.0/0.39.0] 2023-05-18
249
250This release contains the first stable release of the OpenTelemetry Go [metric API].
251Our project stability guarantees now apply to the `go.opentelemetry.io/otel/metric` package.
252See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
253
254### Added
255
256- The `go.opentelemetry.io/otel/semconv/v1.19.0` package.
257 The package contains semantic conventions from the `v1.19.0` version of the OpenTelemetry specification. (#3848)
258- The `go.opentelemetry.io/otel/semconv/v1.20.0` package.
259 The package contains semantic conventions from the `v1.20.0` version of the OpenTelemetry specification. (#4078)
260- The Exponential Histogram data types in `go.opentelemetry.io/otel/sdk/metric/metricdata`. (#4165)
261- OTLP metrics exporter now supports the Exponential Histogram Data Type. (#4222)
262- Fix serialization of `time.Time` zero values in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` and `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp` packages. (#4271)
263
264### Changed
265
266- Use `strings.Cut()` instead of `string.SplitN()` for better readability and memory use. (#4049)
267- `MeterProvider` returns noop meters once it has been shutdown. (#4154)
268
269### Removed
270
271- The deprecated `go.opentelemetry.io/otel/metric/instrument` package is removed.
272 Use `go.opentelemetry.io/otel/metric` instead. (#4055)
273
274### Fixed
275
276- Fix build for BSD based systems in `go.opentelemetry.io/otel/sdk/resource`. (#4077)
277
278## [1.16.0-rc.1/0.39.0-rc.1] 2023-05-03
279
280This is a release candidate for the v1.16.0/v0.39.0 release.
281That release is expected to include the `v1` release of the OpenTelemetry Go metric API and will provide stability guarantees of that API.
282See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
283
284### Added
285
286- Support global `MeterProvider` in `go.opentelemetry.io/otel`. (#4039)
287 - Use `Meter` for a `metric.Meter` from the global `metric.MeterProvider`.
288 - Use `GetMeterProivder` for a global `metric.MeterProvider`.
289 - Use `SetMeterProivder` to set the global `metric.MeterProvider`.
290
291### Changed
292
293- Move the `go.opentelemetry.io/otel/metric` module to the `stable-v1` module set.
294 This stages the metric API to be released as a stable module. (#4038)
295
296### Removed
297
298- The `go.opentelemetry.io/otel/metric/global` package is removed.
299 Use `go.opentelemetry.io/otel` instead. (#4039)
300
301## [1.15.1/0.38.1] 2023-05-02
302
303### Fixed
304
305- Remove unused imports from `sdk/resource/host_id_bsd.go` which caused build failures. (#4040, #4041)
306
307## [1.15.0/0.38.0] 2023-04-27
308
309### Added
310
311- The `go.opentelemetry.io/otel/metric/embedded` package. (#3916)
312- The `Version` function to `go.opentelemetry.io/otel/sdk` to return the SDK version. (#3949)
313- Add a `WithNamespace` option to `go.opentelemetry.io/otel/exporters/prometheus` to allow users to prefix metrics with a namespace. (#3970)
314- The following configuration types were added to `go.opentelemetry.io/otel/metric/instrument` to be used in the configuration of measurement methods. (#3971)
315 - The `AddConfig` used to hold configuration for addition measurements
316 - `NewAddConfig` used to create a new `AddConfig`
317 - `AddOption` used to configure an `AddConfig`
318 - The `RecordConfig` used to hold configuration for recorded measurements
319 - `NewRecordConfig` used to create a new `RecordConfig`
320 - `RecordOption` used to configure a `RecordConfig`
321 - The `ObserveConfig` used to hold configuration for observed measurements
322 - `NewObserveConfig` used to create a new `ObserveConfig`
323 - `ObserveOption` used to configure an `ObserveConfig`
324- `WithAttributeSet` and `WithAttributes` are added to `go.opentelemetry.io/otel/metric/instrument`.
325 They return an option used during a measurement that defines the attribute Set associated with the measurement. (#3971)
326- The `Version` function to `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` to return the OTLP metrics client version. (#3956)
327- The `Version` function to `go.opentelemetry.io/otel/exporters/otlp/otlptrace` to return the OTLP trace client version. (#3956)
328
329### Changed
330
331- The `Extrema` in `go.opentelemetry.io/otel/sdk/metric/metricdata` is redefined with a generic argument of `[N int64 | float64]`. (#3870)
332- Update all exported interfaces from `go.opentelemetry.io/otel/metric` to embed their corresponding interface from `go.opentelemetry.io/otel/metric/embedded`.
333 This adds an implementation requirement to set the interface default behavior for unimplemented methods. (#3916)
334- Move No-Op implementation from `go.opentelemetry.io/otel/metric` into its own package `go.opentelemetry.io/otel/metric/noop`. (#3941)
335 - `metric.NewNoopMeterProvider` is replaced with `noop.NewMeterProvider`
336- Add all the methods from `"go.opentelemetry.io/otel/trace".SpanContext` to `bridgeSpanContext` by embedding `otel.SpanContext` in `bridgeSpanContext`. (#3966)
337- Wrap `UploadMetrics` error in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/` to improve error message when encountering generic grpc errors. (#3974)
338- The measurement methods for all instruments in `go.opentelemetry.io/otel/metric/instrument` accept an option instead of the variadic `"go.opentelemetry.io/otel/attribute".KeyValue`. (#3971)
339 - The `Int64Counter.Add` method now accepts `...AddOption`
340 - The `Float64Counter.Add` method now accepts `...AddOption`
341 - The `Int64UpDownCounter.Add` method now accepts `...AddOption`
342 - The `Float64UpDownCounter.Add` method now accepts `...AddOption`
343 - The `Int64Histogram.Record` method now accepts `...RecordOption`
344 - The `Float64Histogram.Record` method now accepts `...RecordOption`
345 - The `Int64Observer.Observe` method now accepts `...ObserveOption`
346 - The `Float64Observer.Observe` method now accepts `...ObserveOption`
347- The `Observer` methods in `go.opentelemetry.io/otel/metric` accept an option instead of the variadic `"go.opentelemetry.io/otel/attribute".KeyValue`. (#3971)
348 - The `Observer.ObserveInt64` method now accepts `...ObserveOption`
349 - The `Observer.ObserveFloat64` method now accepts `...ObserveOption`
350- Move global metric back to `go.opentelemetry.io/otel/metric/global` from `go.opentelemetry.io/otel`. (#3986)
351
352### Fixed
353
354- `TracerProvider` allows calling `Tracer()` while it's shutting down.
355 It used to deadlock. (#3924)
356- Use the SDK version for the Telemetry SDK resource detector in `go.opentelemetry.io/otel/sdk/resource`. (#3949)
357- Fix a data race in `SpanProcessor` returned by `NewSimpleSpanProcessor` in `go.opentelemetry.io/otel/sdk/trace`. (#3951)
358- Automatically figure out the default aggregation with `aggregation.Default`. (#3967)
359
360### Deprecated
361
362- The `go.opentelemetry.io/otel/metric/instrument` package is deprecated.
363 Use the equivalent types added to `go.opentelemetry.io/otel/metric` instead. (#4018)
364
365## [1.15.0-rc.2/0.38.0-rc.2] 2023-03-23
366
367This is a release candidate for the v1.15.0/v0.38.0 release.
368That release will include the `v1` release of the OpenTelemetry Go metric API and will provide stability guarantees of that API.
369See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
370
371### Added
372
373- The `WithHostID` option to `go.opentelemetry.io/otel/sdk/resource`. (#3812)
374- The `WithoutTimestamps` option to `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric` to sets all timestamps to zero. (#3828)
375- The new `Exemplar` type is added to `go.opentelemetry.io/otel/sdk/metric/metricdata`.
376 Both the `DataPoint` and `HistogramDataPoint` types from that package have a new field of `Exemplars` containing the sampled exemplars for their timeseries. (#3849)
377- Configuration for each metric instrument in `go.opentelemetry.io/otel/sdk/metric/instrument`. (#3895)
378- The internal logging introduces a warning level verbosity equal to `V(1)`. (#3900)
379- Added a log message warning about usage of `SimpleSpanProcessor` in production environments. (#3854)
380
381### Changed
382
383- Optimize memory allocation when creation a new `Set` using `NewSet` or `NewSetWithFiltered` in `go.opentelemetry.io/otel/attribute`. (#3832)
384- Optimize memory allocation when creation new metric instruments in `go.opentelemetry.io/otel/sdk/metric`. (#3832)
385- Avoid creating new objects on all calls to `WithDeferredSetup` and `SkipContextSetup` in OpenTracing bridge. (#3833)
386- The `New` and `Detect` functions from `go.opentelemetry.io/otel/sdk/resource` return errors that wrap underlying errors instead of just containing the underlying error strings. (#3844)
387- Both the `Histogram` and `HistogramDataPoint` are redefined with a generic argument of `[N int64 | float64]` in `go.opentelemetry.io/otel/sdk/metric/metricdata`. (#3849)
388- The metric `Export` interface from `go.opentelemetry.io/otel/sdk/metric` accepts a `*ResourceMetrics` instead of `ResourceMetrics`. (#3853)
389- Rename `Asynchronous` to `Observable` in `go.opentelemetry.io/otel/metric/instrument`. (#3892)
390- Rename `Int64ObserverOption` to `Int64ObservableOption` in `go.opentelemetry.io/otel/metric/instrument`. (#3895)
391- Rename `Float64ObserverOption` to `Float64ObservableOption` in `go.opentelemetry.io/otel/metric/instrument`. (#3895)
392- The internal logging changes the verbosity level of info to `V(4)`, the verbosity level of debug to `V(8)`. (#3900)
393
394### Fixed
395
396- `TracerProvider` consistently doesn't allow to register a `SpanProcessor` after shutdown. (#3845)
397
398### Removed
399
400- The deprecated `go.opentelemetry.io/otel/metric/global` package is removed. (#3829)
401- The unneeded `Synchronous` interface in `go.opentelemetry.io/otel/metric/instrument` was removed. (#3892)
402- The `Float64ObserverConfig` and `NewFloat64ObserverConfig` in `go.opentelemetry.io/otel/sdk/metric/instrument`.
403 Use the added `float64` instrument configuration instead. (#3895)
404- The `Int64ObserverConfig` and `NewInt64ObserverConfig` in `go.opentelemetry.io/otel/sdk/metric/instrument`.
405 Use the added `int64` instrument configuration instead. (#3895)
406- The `NewNoopMeter` function in `go.opentelemetry.io/otel/metric`, use `NewMeterProvider().Meter("")` instead. (#3893)
407
408## [1.15.0-rc.1/0.38.0-rc.1] 2023-03-01
409
410This is a release candidate for the v1.15.0/v0.38.0 release.
411That release will include the `v1` release of the OpenTelemetry Go metric API and will provide stability guarantees of that API.
412See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
413
414This release drops the compatibility guarantee of [Go 1.18].
415
416### Added
417
418- Support global `MeterProvider` in `go.opentelemetry.io/otel`. (#3818)
419 - Use `Meter` for a `metric.Meter` from the global `metric.MeterProvider`.
420 - Use `GetMeterProivder` for a global `metric.MeterProvider`.
421 - Use `SetMeterProivder` to set the global `metric.MeterProvider`.
422
423### Changed
424
425- Dropped compatibility testing for [Go 1.18].
426 The project no longer guarantees support for this version of Go. (#3813)
427
428### Fixed
429
430- Handle empty environment variable as it they were not set. (#3764)
431- Clarify the `httpconv` and `netconv` packages in `go.opentelemetry.io/otel/semconv/*` provide tracing semantic conventions. (#3823)
432- Fix race conditions in `go.opentelemetry.io/otel/exporters/metric/prometheus` that could cause a panic. (#3899)
433- Fix sending nil `scopeInfo` to metrics channel in `go.opentelemetry.io/otel/exporters/metric/prometheus` that could cause a panic in `github.com/prometheus/client_golang/prometheus`. (#3899)
434
435### Deprecated
436
437- The `go.opentelemetry.io/otel/metric/global` package is deprecated.
438 Use `go.opentelemetry.io/otel` instead. (#3818)
439
440### Removed
441
442- The deprecated `go.opentelemetry.io/otel/metric/unit` package is removed. (#3814)
443
444## [1.14.0/0.37.0/0.0.4] 2023-02-27
445
446This release is the last to support [Go 1.18].
447The next release will require at least [Go 1.19].
448
449### Added
450
451- The `event` type semantic conventions are added to `go.opentelemetry.io/otel/semconv/v1.17.0`. (#3697)
452- Support [Go 1.20]. (#3693)
453- The `go.opentelemetry.io/otel/semconv/v1.18.0` package.
454 The package contains semantic conventions from the `v1.18.0` version of the OpenTelemetry specification. (#3719)
455 - The following `const` renames from `go.opentelemetry.io/otel/semconv/v1.17.0` are included:
456 - `OtelScopeNameKey` -> `OTelScopeNameKey`
457 - `OtelScopeVersionKey` -> `OTelScopeVersionKey`
458 - `OtelLibraryNameKey` -> `OTelLibraryNameKey`
459 - `OtelLibraryVersionKey` -> `OTelLibraryVersionKey`
460 - `OtelStatusCodeKey` -> `OTelStatusCodeKey`
461 - `OtelStatusDescriptionKey` -> `OTelStatusDescriptionKey`
462 - `OtelStatusCodeOk` -> `OTelStatusCodeOk`
463 - `OtelStatusCodeError` -> `OTelStatusCodeError`
464 - The following `func` renames from `go.opentelemetry.io/otel/semconv/v1.17.0` are included:
465 - `OtelScopeName` -> `OTelScopeName`
466 - `OtelScopeVersion` -> `OTelScopeVersion`
467 - `OtelLibraryName` -> `OTelLibraryName`
468 - `OtelLibraryVersion` -> `OTelLibraryVersion`
469 - `OtelStatusDescription` -> `OTelStatusDescription`
470- A `IsSampled` method is added to the `SpanContext` implementation in `go.opentelemetry.io/otel/bridge/opentracing` to expose the span sampled state.
471 See the [README](./bridge/opentracing/README.md) for more information. (#3570)
472- The `WithInstrumentationAttributes` option to `go.opentelemetry.io/otel/metric`. (#3738)
473- The `WithInstrumentationAttributes` option to `go.opentelemetry.io/otel/trace`. (#3739)
474- The following environment variables are supported by the periodic `Reader` in `go.opentelemetry.io/otel/sdk/metric`. (#3763)
475 - `OTEL_METRIC_EXPORT_INTERVAL` sets the time between collections and exports.
476 - `OTEL_METRIC_EXPORT_TIMEOUT` sets the timeout an export is attempted.
477
478### Changed
479
480- Fall-back to `TextMapCarrier` when it's not `HttpHeader`s in `go.opentelemetry.io/otel/bridge/opentracing`. (#3679)
481- 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.
482 This change is made to enable memory reuse by SDK users. (#3732)
483- The `WithUnit` option in `go.opentelemetry.io/otel/sdk/metric/instrument` is updated to accept a `string` for the unit value. (#3776)
484
485### Fixed
486
487- Ensure `go.opentelemetry.io/otel` does not use generics. (#3723, #3725)
488- Multi-reader `MeterProvider`s now export metrics for all readers, instead of just the first reader. (#3720, #3724)
489- Remove use of deprecated `"math/rand".Seed` in `go.opentelemetry.io/otel/example/prometheus`. (#3733)
490- Do not silently drop unknown schema data with `Parse` in `go.opentelemetry.io/otel/schema/v1.1`. (#3743)
491- Data race issue in OTLP exporter retry mechanism. (#3755, #3756)
492- Wrapping empty errors when exporting in `go.opentelemetry.io/otel/sdk/metric`. (#3698, #3772)
493- Incorrect "all" and "resource" definition for schema files in `go.opentelemetry.io/otel/schema/v1.1`. (#3777)
494
495### Deprecated
496
497- The `go.opentelemetry.io/otel/metric/unit` package is deprecated.
498 Use the equivalent unit string instead. (#3776)
499 - Use `"1"` instead of `unit.Dimensionless`
500 - Use `"By"` instead of `unit.Bytes`
501 - Use `"ms"` instead of `unit.Milliseconds`
502
503## [1.13.0/0.36.0] 2023-02-07
504
505### Added
506
507- Attribute `KeyValue` creations functions to `go.opentelemetry.io/otel/semconv/v1.17.0` for all non-enum semantic conventions.
508 These functions ensure semantic convention type correctness. (#3675)
509
510### Fixed
511
512- Removed the `http.target` attribute from being added by `ServerRequest` in the following packages. (#3687)
513 - `go.opentelemetry.io/otel/semconv/v1.13.0/httpconv`
514 - `go.opentelemetry.io/otel/semconv/v1.14.0/httpconv`
515 - `go.opentelemetry.io/otel/semconv/v1.15.0/httpconv`
516 - `go.opentelemetry.io/otel/semconv/v1.16.0/httpconv`
517 - `go.opentelemetry.io/otel/semconv/v1.17.0/httpconv`
518
519### Removed
520
521- The deprecated `go.opentelemetry.io/otel/metric/instrument/asyncfloat64` package is removed. (#3631)
522- The deprecated `go.opentelemetry.io/otel/metric/instrument/asyncint64` package is removed. (#3631)
523- The deprecated `go.opentelemetry.io/otel/metric/instrument/syncfloat64` package is removed. (#3631)
524- The deprecated `go.opentelemetry.io/otel/metric/instrument/syncint64` package is removed. (#3631)
525
526## [1.12.0/0.35.0] 2023-01-28
527
528### Added
529
530- The `WithInt64Callback` option to `go.opentelemetry.io/otel/metric/instrument`.
531 This options is used to configure `int64` Observer callbacks during their creation. (#3507)
532- The `WithFloat64Callback` option to `go.opentelemetry.io/otel/metric/instrument`.
533 This options is used to configure `float64` Observer callbacks during their creation. (#3507)
534- The `Producer` interface and `Reader.RegisterProducer(Producer)` to `go.opentelemetry.io/otel/sdk/metric`.
535 These additions are used to enable external metric Producers. (#3524)
536- The `Callback` function type to `go.opentelemetry.io/otel/metric`.
537 This new named function type is registered with a `Meter`. (#3564)
538- The `go.opentelemetry.io/otel/semconv/v1.13.0` package.
539 The package contains semantic conventions from the `v1.13.0` version of the OpenTelemetry specification. (#3499)
540 - The `EndUserAttributesFromHTTPRequest` function in `go.opentelemetry.io/otel/semconv/v1.12.0` is merged into `ClientRequest` and `ServerRequest` in `go.opentelemetry.io/otel/semconv/v1.13.0/httpconv`.
541 - The `HTTPAttributesFromHTTPStatusCode` function in `go.opentelemetry.io/otel/semconv/v1.12.0` is merged into `ClientResponse` in `go.opentelemetry.io/otel/semconv/v1.13.0/httpconv`.
542 - The `HTTPClientAttributesFromHTTPRequest` function in `go.opentelemetry.io/otel/semconv/v1.12.0` is replaced by `ClientRequest` in `go.opentelemetry.io/otel/semconv/v1.13.0/httpconv`.
543 - The `HTTPServerAttributesFromHTTPRequest` function in `go.opentelemetry.io/otel/semconv/v1.12.0` is replaced by `ServerRequest` in `go.opentelemetry.io/otel/semconv/v1.13.0/httpconv`.
544 - The `HTTPServerMetricAttributesFromHTTPRequest` function in `go.opentelemetry.io/otel/semconv/v1.12.0` is replaced by `ServerRequest` in `go.opentelemetry.io/otel/semconv/v1.13.0/httpconv`.
545 - The `NetAttributesFromHTTPRequest` function in `go.opentelemetry.io/otel/semconv/v1.12.0` is split into `Transport` in `go.opentelemetry.io/otel/semconv/v1.13.0/netconv` and `ClientRequest` or `ServerRequest` in `go.opentelemetry.io/otel/semconv/v1.13.0/httpconv`.
546 - The `SpanStatusFromHTTPStatusCode` function in `go.opentelemetry.io/otel/semconv/v1.12.0` is replaced by `ClientStatus` in `go.opentelemetry.io/otel/semconv/v1.13.0/httpconv`.
547 - The `SpanStatusFromHTTPStatusCodeAndSpanKind` function in `go.opentelemetry.io/otel/semconv/v1.12.0` is split into `ClientStatus` and `ServerStatus` in `go.opentelemetry.io/otel/semconv/v1.13.0/httpconv`.
548 - The `Client` function is included in `go.opentelemetry.io/otel/semconv/v1.13.0/netconv` to generate attributes for a `net.Conn`.
549 - The `Server` function is included in `go.opentelemetry.io/otel/semconv/v1.13.0/netconv` to generate attributes for a `net.Listener`.
550- The `go.opentelemetry.io/otel/semconv/v1.14.0` package.
551 The package contains semantic conventions from the `v1.14.0` version of the OpenTelemetry specification. (#3566)
552- The `go.opentelemetry.io/otel/semconv/v1.15.0` package.
553 The package contains semantic conventions from the `v1.15.0` version of the OpenTelemetry specification. (#3578)
554- The `go.opentelemetry.io/otel/semconv/v1.16.0` package.
555 The package contains semantic conventions from the `v1.16.0` version of the OpenTelemetry specification. (#3579)
556- Metric instruments to `go.opentelemetry.io/otel/metric/instrument`.
557 These instruments are use as replacements of the deprecated `go.opentelemetry.io/otel/metric/instrument/{asyncfloat64,asyncint64,syncfloat64,syncint64}` packages.(#3575, #3586)
558 - `Float64ObservableCounter` replaces the `asyncfloat64.Counter`
559 - `Float64ObservableUpDownCounter` replaces the `asyncfloat64.UpDownCounter`
560 - `Float64ObservableGauge` replaces the `asyncfloat64.Gauge`
561 - `Int64ObservableCounter` replaces the `asyncint64.Counter`
562 - `Int64ObservableUpDownCounter` replaces the `asyncint64.UpDownCounter`
563 - `Int64ObservableGauge` replaces the `asyncint64.Gauge`
564 - `Float64Counter` replaces the `syncfloat64.Counter`
565 - `Float64UpDownCounter` replaces the `syncfloat64.UpDownCounter`
566 - `Float64Histogram` replaces the `syncfloat64.Histogram`
567 - `Int64Counter` replaces the `syncint64.Counter`
568 - `Int64UpDownCounter` replaces the `syncint64.UpDownCounter`
569 - `Int64Histogram` replaces the `syncint64.Histogram`
570- `NewTracerProvider` to `go.opentelemetry.io/otel/bridge/opentracing`.
571 This is used to create `WrapperTracer` instances from a `TracerProvider`. (#3116)
572- The `Extrema` type to `go.opentelemetry.io/otel/sdk/metric/metricdata`.
573 This type is used to represent min/max values and still be able to distinguish unset and zero values. (#3487)
574- The `go.opentelemetry.io/otel/semconv/v1.17.0` package.
575 The package contains semantic conventions from the `v1.17.0` version of the OpenTelemetry specification. (#3599)
576
577### Changed
578
579- Jaeger and Zipkin exporter use `github.com/go-logr/logr` as the logging interface, and add the `WithLogr` option. (#3497, #3500)
580- Instrument configuration in `go.opentelemetry.io/otel/metric/instrument` is split into specific options and configuration based on the instrument type. (#3507)
581 - Use the added `Int64Option` type to configure instruments from `go.opentelemetry.io/otel/metric/instrument/syncint64`.
582 - Use the added `Float64Option` type to configure instruments from `go.opentelemetry.io/otel/metric/instrument/syncfloat64`.
583 - Use the added `Int64ObserverOption` type to configure instruments from `go.opentelemetry.io/otel/metric/instrument/asyncint64`.
584 - Use the added `Float64ObserverOption` type to configure instruments from `go.opentelemetry.io/otel/metric/instrument/asyncfloat64`.
585- Return a `Registration` from the `RegisterCallback` method of a `Meter` in the `go.opentelemetry.io/otel/metric` package.
586 This `Registration` can be used to unregister callbacks. (#3522)
587- Global error handler uses an atomic value instead of a mutex. (#3543)
588- Add `NewMetricProducer` to `go.opentelemetry.io/otel/bridge/opencensus`, which can be used to pass OpenCensus metrics to an OpenTelemetry Reader. (#3541)
589- Global logger uses an atomic value instead of a mutex. (#3545)
590- The `Shutdown` method of the `"go.opentelemetry.io/otel/sdk/trace".TracerProvider` releases all computational resources when called the first time. (#3551)
591- The `Sampler` returned from `TraceIDRatioBased` `go.opentelemetry.io/otel/sdk/trace` now uses the rightmost bits for sampling decisions.
592 This fixes random sampling when using ID generators like `xray.IDGenerator` and increasing parity with other language implementations. (#3557)
593- Errors from `go.opentelemetry.io/otel/exporters/otlp/otlptrace` exporters are wrapped in errors identifying their signal name.
594 Existing users of the exporters attempting to identify specific errors will need to use `errors.Unwrap()` to get the underlying error. (#3516)
595- Exporters from `go.opentelemetry.io/otel/exporters/otlp` will print the final retryable error message when attempts to retry time out. (#3514)
596- The instrument kind names in `go.opentelemetry.io/otel/sdk/metric` are updated to match the API. (#3562)
597 - `InstrumentKindSyncCounter` is renamed to `InstrumentKindCounter`
598 - `InstrumentKindSyncUpDownCounter` is renamed to `InstrumentKindUpDownCounter`
599 - `InstrumentKindSyncHistogram` is renamed to `InstrumentKindHistogram`
600 - `InstrumentKindAsyncCounter` is renamed to `InstrumentKindObservableCounter`
601 - `InstrumentKindAsyncUpDownCounter` is renamed to `InstrumentKindObservableUpDownCounter`
602 - `InstrumentKindAsyncGauge` is renamed to `InstrumentKindObservableGauge`
603- The `RegisterCallback` method of the `Meter` in `go.opentelemetry.io/otel/metric` changed.
604 - The named `Callback` replaces the inline function parameter. (#3564)
605 - `Callback` is required to return an error. (#3576)
606 - `Callback` accepts the added `Observer` parameter added.
607 This new parameter is used by `Callback` implementations to observe values for asynchronous instruments instead of calling the `Observe` method of the instrument directly. (#3584)
608 - The slice of `instrument.Asynchronous` is now passed as a variadic argument. (#3587)
609- The exporter from `go.opentelemetry.io/otel/exporters/zipkin` is updated to use the `v1.16.0` version of semantic conventions.
610 This means it no longer uses the removed `net.peer.ip` or `http.host` attributes to determine the remote endpoint.
611 Instead it uses the `net.sock.peer` attributes. (#3581)
612- The `Min` and `Max` fields of the `HistogramDataPoint` in `go.opentelemetry.io/otel/sdk/metric/metricdata` are now defined with the added `Extrema` type instead of a `*float64`. (#3487)
613
614### Fixed
615
616- Asynchronous instruments that use sum aggregators and attribute filters correctly add values from equivalent attribute sets that have been filtered. (#3439, #3549)
617- The `RegisterCallback` method of the `Meter` from `go.opentelemetry.io/otel/sdk/metric` only registers a callback for instruments created by that meter.
618 Trying to register a callback with instruments from a different meter will result in an error being returned. (#3584)
619
620### Deprecated
621
622- The `NewMetricExporter` in `go.opentelemetry.io/otel/bridge/opencensus` is deprecated.
623 Use `NewMetricProducer` instead. (#3541)
624- The `go.opentelemetry.io/otel/metric/instrument/asyncfloat64` package is deprecated.
625 Use the instruments from `go.opentelemetry.io/otel/metric/instrument` instead. (#3575)
626- The `go.opentelemetry.io/otel/metric/instrument/asyncint64` package is deprecated.
627 Use the instruments from `go.opentelemetry.io/otel/metric/instrument` instead. (#3575)
628- The `go.opentelemetry.io/otel/metric/instrument/syncfloat64` package is deprecated.
629 Use the instruments from `go.opentelemetry.io/otel/metric/instrument` instead. (#3575)
630- The `go.opentelemetry.io/otel/metric/instrument/syncint64` package is deprecated.
631 Use the instruments from `go.opentelemetry.io/otel/metric/instrument` instead. (#3575)
632- The `NewWrappedTracerProvider` in `go.opentelemetry.io/otel/bridge/opentracing` is now deprecated.
633 Use `NewTracerProvider` instead. (#3116)
634
635### Removed
636
637- The deprecated `go.opentelemetry.io/otel/sdk/metric/view` package is removed. (#3520)
638- The `InstrumentProvider` from `go.opentelemetry.io/otel/sdk/metric/asyncint64` is removed.
639 Use the new creation methods of the `Meter` in `go.opentelemetry.io/otel/sdk/metric` instead. (#3530)
640 - The `Counter` method is replaced by `Meter.Int64ObservableCounter`
641 - The `UpDownCounter` method is replaced by `Meter.Int64ObservableUpDownCounter`
642 - The `Gauge` method is replaced by `Meter.Int64ObservableGauge`
643- The `InstrumentProvider` from `go.opentelemetry.io/otel/sdk/metric/asyncfloat64` is removed.
644 Use the new creation methods of the `Meter` in `go.opentelemetry.io/otel/sdk/metric` instead. (#3530)
645 - The `Counter` method is replaced by `Meter.Float64ObservableCounter`
646 - The `UpDownCounter` method is replaced by `Meter.Float64ObservableUpDownCounter`
647 - The `Gauge` method is replaced by `Meter.Float64ObservableGauge`
648- The `InstrumentProvider` from `go.opentelemetry.io/otel/sdk/metric/syncint64` is removed.
649 Use the new creation methods of the `Meter` in `go.opentelemetry.io/otel/sdk/metric` instead. (#3530)
650 - The `Counter` method is replaced by `Meter.Int64Counter`
651 - The `UpDownCounter` method is replaced by `Meter.Int64UpDownCounter`
652 - The `Histogram` method is replaced by `Meter.Int64Histogram`
653- The `InstrumentProvider` from `go.opentelemetry.io/otel/sdk/metric/syncfloat64` is removed.
654 Use the new creation methods of the `Meter` in `go.opentelemetry.io/otel/sdk/metric` instead. (#3530)
655 - The `Counter` method is replaced by `Meter.Float64Counter`
656 - The `UpDownCounter` method is replaced by `Meter.Float64UpDownCounter`
657 - The `Histogram` method is replaced by `Meter.Float64Histogram`
658
659## [1.11.2/0.34.0] 2022-12-05
660
661### Added
662
663- The `WithView` `Option` is added to the `go.opentelemetry.io/otel/sdk/metric` package.
664 This option is used to configure the view(s) a `MeterProvider` will use for all `Reader`s that are registered with it. (#3387)
665- Add Instrumentation Scope and Version as info metric and label in Prometheus exporter.
666 This can be disabled using the `WithoutScopeInfo()` option added to that package.(#3273, #3357)
667- OTLP exporters now recognize: (#3363)
668 - `OTEL_EXPORTER_OTLP_INSECURE`
669 - `OTEL_EXPORTER_OTLP_TRACES_INSECURE`
670 - `OTEL_EXPORTER_OTLP_METRICS_INSECURE`
671 - `OTEL_EXPORTER_OTLP_CLIENT_KEY`
672 - `OTEL_EXPORTER_OTLP_TRACES_CLIENT_KEY`
673 - `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY`
674 - `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`
675 - `OTEL_EXPORTER_OTLP_TRACES_CLIENT_CERTIFICATE`
676 - `OTEL_EXPORTER_OTLP_METRICS_CLIENT_CERTIFICATE`
677- 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`.
678 These additions are replacements for the `View` type and `New` function from `go.opentelemetry.io/otel/sdk/metric/view`. (#3459)
679- The `Instrument` and `InstrumentKind` type are added to `go.opentelemetry.io/otel/sdk/metric`.
680 These additions are replacements for the `Instrument` and `InstrumentKind` types from `go.opentelemetry.io/otel/sdk/metric/view`. (#3459)
681- The `Stream` type is added to `go.opentelemetry.io/otel/sdk/metric` to define a metric data stream a view will produce. (#3459)
682- The `AssertHasAttributes` allows instrument authors to test that datapoints returned have appropriate attributes. (#3487)
683
684### Changed
685
686- The `"go.opentelemetry.io/otel/sdk/metric".WithReader` option no longer accepts views to associate with the `Reader`.
687 Instead, views are now registered directly with the `MeterProvider` via the new `WithView` option.
688 The views registered with the `MeterProvider` apply to all `Reader`s. (#3387)
689- 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. (#3260)
690- 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. (#3260)
691- The `WithTemporalitySelector` and `WithAggregationSelector` `ReaderOption`s have been changed to `ManualReaderOption`s in the `go.opentelemetry.io/otel/sdk/metric` package. (#3260)
692- 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. (#3260)
693
694### Fixed
695
696- The `go.opentelemetry.io/otel/exporters/prometheus` exporter fixes duplicated `_total` suffixes. (#3369)
697- Remove comparable requirement for `Reader`s. (#3387)
698- Cumulative metrics from the OpenCensus bridge (`go.opentelemetry.io/otel/bridge/opencensus`) are defined as monotonic sums, instead of non-monotonic. (#3389)
699- Asynchronous counters (`Counter` and `UpDownCounter`) from the metric SDK now produce delta sums when configured with delta temporality. (#3398)
700- Exported `Status` codes in the `go.opentelemetry.io/otel/exporters/zipkin` exporter are now exported as all upper case values. (#3340)
701- `Aggregation`s from `go.opentelemetry.io/otel/sdk/metric` with no data are not exported. (#3394, #3436)
702- Re-enabled Attribute Filters in the Metric SDK. (#3396)
703- Asynchronous callbacks are only called if they are registered with at least one instrument that does not use drop aggragation. (#3408)
704- Do not report empty partial-success responses in the `go.opentelemetry.io/otel/exporters/otlp` exporters. (#3438, #3432)
705- Handle partial success responses in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` exporters. (#3162, #3440)
706- Prevent duplicate Prometheus description, unit, and type. (#3469)
707- Prevents panic when using incorrect `attribute.Value.As[Type]Slice()`. (#3489)
708
709### Removed
710
711- The `go.opentelemetry.io/otel/exporters/otlp/otlpmetric.Client` interface is removed. (#3486)
712- The `go.opentelemetry.io/otel/exporters/otlp/otlpmetric.New` function is removed. Use the `otlpmetric[http|grpc].New` directly. (#3486)
713
714### Deprecated
715
716- The `go.opentelemetry.io/otel/sdk/metric/view` package is deprecated.
717 Use `Instrument`, `InstrumentKind`, `View`, and `NewView` in `go.opentelemetry.io/otel/sdk/metric` instead. (#3476)
718
719## [1.11.1/0.33.0] 2022-10-19
720
721### Added
722
723- The Prometheus exporter in `go.opentelemetry.io/otel/exporters/prometheus` registers with a Prometheus registerer on creation.
724 By default, it will register with the default Prometheus registerer.
725 A non-default registerer can be used by passing the `WithRegisterer` option. (#3239)
726- Added the `WithAggregationSelector` option to the `go.opentelemetry.io/otel/exporters/prometheus` package to change the default `AggregationSelector` used. (#3341)
727- The Prometheus exporter in `go.opentelemetry.io/otel/exporters/prometheus` converts the `Resource` associated with metric exports into a `target_info` metric. (#3285)
728
729### Changed
730
731- The `"go.opentelemetry.io/otel/exporters/prometheus".New` function is updated to return an error.
732 It will return an error if the exporter fails to register with Prometheus. (#3239)
733
734### Fixed
735
736- The URL-encoded values from the `OTEL_RESOURCE_ATTRIBUTES` environment variable are decoded. (#2963)
737- The `baggage.NewMember` function decodes the `value` parameter instead of directly using it.
738 This fixes the implementation to be compliant with the W3C specification. (#3226)
739- Slice attributes of the `attribute` package are now comparable based on their value, not instance. (#3108 #3252)
740- The `Shutdown` and `ForceFlush` methods of the `"go.opentelemetry.io/otel/sdk/trace".TraceProvider` no longer return an error when no processor is registered. (#3268)
741- The Prometheus exporter in `go.opentelemetry.io/otel/exporters/prometheus` cumulatively sums histogram buckets. (#3281)
742- The sum of each histogram data point is now uniquely exported by the `go.opentelemetry.io/otel/exporters/otlpmetric` exporters. (#3284, #3293)
743- Recorded values for asynchronous counters (`Counter` and `UpDownCounter`) are interpreted as exact, not incremental, sum values by the metric SDK. (#3350, #3278)
744- `UpDownCounters` are now correctly output as Prometheus gauges in the `go.opentelemetry.io/otel/exporters/prometheus` exporter. (#3358)
745- The Prometheus exporter in `go.opentelemetry.io/otel/exporters/prometheus` no longer describes the metrics it will send to Prometheus on startup.
746 Instead the exporter is defined as an "unchecked" collector for Prometheus.
747 This fixes the `reader is not registered` warning currently emitted on startup. (#3291 #3342)
748- The `go.opentelemetry.io/otel/exporters/prometheus` exporter now correctly adds `_total` suffixes to counter metrics. (#3360)
749- The `go.opentelemetry.io/otel/exporters/prometheus` exporter now adds a unit suffix to metric names.
750 This can be disabled using the `WithoutUnits()` option added to that package. (#3352)
751
752## [1.11.0/0.32.3] 2022-10-12
753
754### Added
755
756- Add default User-Agent header to OTLP exporter requests (`go.opentelemetry.io/otel/exporters/otlptrace/otlptracegrpc` and `go.opentelemetry.io/otel/exporters/otlptrace/otlptracehttp`). (#3261)
757
758### Changed
759
760- `span.SetStatus` has been updated such that calls that lower the status are now no-ops. (#3214)
761- Upgrade `golang.org/x/sys/unix` from `v0.0.0-20210423185535-09eb48e85fd7` to `v0.0.0-20220919091848-fb04ddd9f9c8`.
762 This addresses [GO-2022-0493](https://pkg.go.dev/vuln/GO-2022-0493). (#3235)
763
764## [0.32.2] Metric SDK (Alpha) - 2022-10-11
765
766### Added
767
768- Added an example of using metric views to customize instruments. (#3177)
769- Add default User-Agent header to OTLP exporter requests (`go.opentelemetry.io/otel/exporters/otlpmetric/otlpmetricgrpc` and `go.opentelemetry.io/otel/exporters/otlpmetric/otlpmetrichttp`). (#3261)
770
771### Changed
772
773- Flush pending measurements with the `PeriodicReader` in the `go.opentelemetry.io/otel/sdk/metric` when `ForceFlush` or `Shutdown` are called. (#3220)
774- Update histogram default bounds to match the requirements of the latest specification. (#3222)
775- Encode the HTTP status code in the OpenTracing bridge (`go.opentelemetry.io/otel/bridge/opentracing`) as an integer. (#3265)
776
777### Fixed
778
779- Use default view if instrument does not match any registered view of a reader. (#3224, #3237)
780- Return the same instrument every time a user makes the exact same instrument creation call. (#3229, #3251)
781- Return the existing instrument when a view transforms a creation call to match an existing instrument. (#3240, #3251)
782- Log a warning when a conflicting instrument (e.g. description, unit, data-type) is created instead of returning an error. (#3251)
783- The OpenCensus bridge no longer sends empty batches of metrics. (#3263)
784
785## [0.32.1] Metric SDK (Alpha) - 2022-09-22
786
787### Changed
788
789- The Prometheus exporter sanitizes OpenTelemetry instrument names when exporting.
790 Invalid characters are replaced with `_`. (#3212)
791
792### Added
793
794- The metric portion of the OpenCensus bridge (`go.opentelemetry.io/otel/bridge/opencensus`) has been reintroduced. (#3192)
795- The OpenCensus bridge example (`go.opentelemetry.io/otel/example/opencensus`) has been reintroduced. (#3206)
796
797### Fixed
798
799- Updated go.mods to point to valid versions of the sdk. (#3216)
800- Set the `MeterProvider` resource on all exported metric data. (#3218)
801
802## [0.32.0] Revised Metric SDK (Alpha) - 2022-09-18
803
804### Changed
805
806- The metric SDK in `go.opentelemetry.io/otel/sdk/metric` is completely refactored to comply with the OpenTelemetry specification.
807 Please see the package documentation for how the new SDK is initialized and configured. (#3175)
808- Update the minimum supported go version to go1.18. Removes support for go1.17 (#3179)
809
810### Removed
811
812- The metric portion of the OpenCensus bridge (`go.opentelemetry.io/otel/bridge/opencensus`) has been removed.
813 A new bridge compliant with the revised metric SDK will be added back in a future release. (#3175)
814- The `go.opentelemetry.io/otel/sdk/metric/aggregator/aggregatortest` package is removed, see the new metric SDK. (#3175)
815- The `go.opentelemetry.io/otel/sdk/metric/aggregator/histogram` package is removed, see the new metric SDK. (#3175)
816- The `go.opentelemetry.io/otel/sdk/metric/aggregator/lastvalue` package is removed, see the new metric SDK. (#3175)
817- The `go.opentelemetry.io/otel/sdk/metric/aggregator/sum` package is removed, see the new metric SDK. (#3175)
818- The `go.opentelemetry.io/otel/sdk/metric/aggregator` package is removed, see the new metric SDK. (#3175)
819- The `go.opentelemetry.io/otel/sdk/metric/controller/basic` package is removed, see the new metric SDK. (#3175)
820- The `go.opentelemetry.io/otel/sdk/metric/controller/controllertest` package is removed, see the new metric SDK. (#3175)
821- The `go.opentelemetry.io/otel/sdk/metric/controller/time` package is removed, see the new metric SDK. (#3175)
822- The `go.opentelemetry.io/otel/sdk/metric/export/aggregation` package is removed, see the new metric SDK. (#3175)
823- The `go.opentelemetry.io/otel/sdk/metric/export` package is removed, see the new metric SDK. (#3175)
824- The `go.opentelemetry.io/otel/sdk/metric/metrictest` package is removed.
825 A replacement package that supports the new metric SDK will be added back in a future release. (#3175)
826- The `go.opentelemetry.io/otel/sdk/metric/number` package is removed, see the new metric SDK. (#3175)
827- The `go.opentelemetry.io/otel/sdk/metric/processor/basic` package is removed, see the new metric SDK. (#3175)
828- The `go.opentelemetry.io/otel/sdk/metric/processor/processortest` package is removed, see the new metric SDK. (#3175)
829- The `go.opentelemetry.io/otel/sdk/metric/processor/reducer` package is removed, see the new metric SDK. (#3175)
830- The `go.opentelemetry.io/otel/sdk/metric/registry` package is removed, see the new metric SDK. (#3175)
831- The `go.opentelemetry.io/otel/sdk/metric/sdkapi` package is removed, see the new metric SDK. (#3175)
832- The `go.opentelemetry.io/otel/sdk/metric/selector/simple` package is removed, see the new metric SDK. (#3175)
833- The `"go.opentelemetry.io/otel/sdk/metric".ErrUninitializedInstrument` variable was removed. (#3175)
834- The `"go.opentelemetry.io/otel/sdk/metric".ErrBadInstrument` variable was removed. (#3175)
835- The `"go.opentelemetry.io/otel/sdk/metric".Accumulator` type was removed, see the `MeterProvider`in the new metric SDK. (#3175)
836- The `"go.opentelemetry.io/otel/sdk/metric".NewAccumulator` function was removed, see `NewMeterProvider`in the new metric SDK. (#3175)
837- The deprecated `"go.opentelemetry.io/otel/sdk/metric".AtomicFieldOffsets` function was removed. (#3175)
838
839## [1.10.0] - 2022-09-09
840
841### Added
842
843- Support Go 1.19. (#3077)
844 Include compatibility testing and document support. (#3077)
845- Support the OTLP ExportTracePartialSuccess response; these are passed to the registered error handler. (#3106)
846- Upgrade go.opentelemetry.io/proto/otlp from v0.18.0 to v0.19.0 (#3107)
847
848### Changed
849
850- Fix misidentification of OpenTelemetry `SpanKind` in OpenTracing bridge (`go.opentelemetry.io/otel/bridge/opentracing`). (#3096)
851- Attempting to start a span with a nil `context` will no longer cause a panic. (#3110)
852- All exporters will be shutdown even if one reports an error (#3091)
853- Ensure valid UTF-8 when truncating over-length attribute values. (#3156)
854
855## [1.9.0/0.0.3] - 2022-08-01
856
857### Added
858
859- Add support for Schema Files format 1.1.x (metric "split" transform) with the new `go.opentelemetry.io/otel/schema/v1.1` package. (#2999)
860- Add the `go.opentelemetry.io/otel/semconv/v1.11.0` package.
861 The package contains semantic conventions from the `v1.11.0` version of the OpenTelemetry specification. (#3009)
862- Add the `go.opentelemetry.io/otel/semconv/v1.12.0` package.
863 The package contains semantic conventions from the `v1.12.0` version of the OpenTelemetry specification. (#3010)
864- Add the `http.method` attribute to HTTP server metric from all `go.opentelemetry.io/otel/semconv/*` packages. (#3018)
865
866### Fixed
867
868- Invalid warning for context setup being deferred in `go.opentelemetry.io/otel/bridge/opentracing` package. (#3029)
869
870## [1.8.0/0.31.0] - 2022-07-08
871
872### Added
873
874- Add support for `opentracing.TextMap` format in the `Inject` and `Extract` methods
875of the `"go.opentelemetry.io/otel/bridge/opentracing".BridgeTracer` type. (#2911)
876
877### Changed
878
879- The `crosslink` make target has been updated to use the `go.opentelemetry.io/build-tools/crosslink` package. (#2886)
880- In the `go.opentelemetry.io/otel/sdk/instrumentation` package rename `Library` to `Scope` and alias `Library` as `Scope` (#2976)
881- Move metric no-op implementation form `nonrecording` to `metric` package. (#2866)
882
883### Removed
884
885- Support for go1.16. Support is now only for go1.17 and go1.18 (#2917)
886
887### Deprecated
888
889- The `Library` struct in the `go.opentelemetry.io/otel/sdk/instrumentation` package is deprecated.
890 Use the equivalent `Scope` struct instead. (#2977)
891- The `ReadOnlySpan.InstrumentationLibrary` method from the `go.opentelemetry.io/otel/sdk/trace` package is deprecated.
892 Use the equivalent `ReadOnlySpan.InstrumentationScope` method instead. (#2977)
893
894## [1.7.0/0.30.0] - 2022-04-28
895
896### Added
897
898- Add the `go.opentelemetry.io/otel/semconv/v1.8.0` package.
899 The package contains semantic conventions from the `v1.8.0` version of the OpenTelemetry specification. (#2763)
900- Add the `go.opentelemetry.io/otel/semconv/v1.9.0` package.
901 The package contains semantic conventions from the `v1.9.0` version of the OpenTelemetry specification. (#2792)
902- Add the `go.opentelemetry.io/otel/semconv/v1.10.0` package.
903 The package contains semantic conventions from the `v1.10.0` version of the OpenTelemetry specification. (#2842)
904- Added an in-memory exporter to metrictest to aid testing with a full SDK. (#2776)
905
906### Fixed
907
908- Globally delegated instruments are unwrapped before delegating asynchronous callbacks. (#2784)
909- Remove import of `testing` package in non-tests builds of the `go.opentelemetry.io/otel` package. (#2786)
910
911### Changed
912
913- The `WithLabelEncoder` option from the `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric` package is renamed to `WithAttributeEncoder`. (#2790)
914- The `LabelFilterSelector` interface from `go.opentelemetry.io/otel/sdk/metric/processor/reducer` is renamed to `AttributeFilterSelector`.
915 The method included in the renamed interface also changed from `LabelFilterFor` to `AttributeFilterFor`. (#2790)
916- The `Metadata.Labels` method from the `go.opentelemetry.io/otel/sdk/metric/export` package is renamed to `Metadata.Attributes`.
917 Consequentially, the `Record` type from the same package also has had the embedded method renamed. (#2790)
918
919### Deprecated
920
921- The `Iterator.Label` method in the `go.opentelemetry.io/otel/attribute` package is deprecated.
922 Use the equivalent `Iterator.Attribute` method instead. (#2790)
923- The `Iterator.IndexedLabel` method in the `go.opentelemetry.io/otel/attribute` package is deprecated.
924 Use the equivalent `Iterator.IndexedAttribute` method instead. (#2790)
925- The `MergeIterator.Label` method in the `go.opentelemetry.io/otel/attribute` package is deprecated.
926 Use the equivalent `MergeIterator.Attribute` method instead. (#2790)
927
928### Removed
929
930- Removed the `Batch` type from the `go.opentelemetry.io/otel/sdk/metric/metrictest` package. (#2864)
931- Removed the `Measurement` type from the `go.opentelemetry.io/otel/sdk/metric/metrictest` package. (#2864)
932
933## [0.29.0] - 2022-04-11
934
935### Added
936
937- The metrics global package was added back into several test files. (#2764)
938- The `Meter` function is added back to the `go.opentelemetry.io/otel/metric/global` package.
939 This function is a convenience function equivalent to calling `global.MeterProvider().Meter(...)`. (#2750)
940
941### Removed
942
943- Removed module the `go.opentelemetry.io/otel/sdk/export/metric`.
944 Use the `go.opentelemetry.io/otel/sdk/metric` module instead. (#2720)
945
946### Changed
947
948- Don't panic anymore when setting a global MeterProvider to itself. (#2749)
949- Upgrade `go.opentelemetry.io/proto/otlp` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` from `v0.12.1` to `v0.15.0`.
950 This replaces the use of the now deprecated `InstrumentationLibrary` and `InstrumentationLibraryMetrics` types and fields in the proto library with the equivalent `InstrumentationScope` and `ScopeMetrics`. (#2748)
951
952## [1.6.3] - 2022-04-07
953
954### Fixed
955
956- Allow non-comparable global `MeterProvider`, `TracerProvider`, and `TextMapPropagator` types to be set. (#2772, #2773)
957
958## [1.6.2] - 2022-04-06
959
960### Changed
961
962- Don't panic anymore when setting a global TracerProvider or TextMapPropagator to itself. (#2749)
963- Upgrade `go.opentelemetry.io/proto/otlp` in `go.opentelemetry.io/otel/exporters/otlp/otlptrace` from `v0.12.1` to `v0.15.0`.
964 This replaces the use of the now deprecated `InstrumentationLibrary` and `InstrumentationLibrarySpans` types and fields in the proto library with the equivalent `InstrumentationScope` and `ScopeSpans`. (#2748)
965
966## [1.6.1] - 2022-03-28
967
968### Fixed
969
970- The `go.opentelemetry.io/otel/schema/*` packages now use the correct schema URL for their `SchemaURL` constant.
971 Instead of using `"https://opentelemetry.io/schemas/v<version>"` they now use the correct URL without a `v` prefix, `"https://opentelemetry.io/schemas/<version>"`. (#2743, #2744)
972
973### Security
974
975- Upgrade `go.opentelemetry.io/proto/otlp` from `v0.12.0` to `v0.12.1`.
976 This includes an indirect upgrade of `github.com/grpc-ecosystem/grpc-gateway` which resolves [a vulnerability](https://nvd.nist.gov/vuln/detail/CVE-2019-11254) from `gopkg.in/yaml.v2` in version `v2.2.3`. (#2724, #2728)
977
978## [1.6.0/0.28.0] - 2022-03-23
979
980### ⚠️ Notice ⚠️
981
982This update is a breaking change of the unstable Metrics API.
983Code instrumented with the `go.opentelemetry.io/otel/metric` will need to be modified.
984
985### Added
986
987- Add metrics exponential histogram support.
988 New mapping functions have been made available in `sdk/metric/aggregator/exponential/mapping` for other OpenTelemetry projects to take dependencies on. (#2502)
989- Add Go 1.18 to our compatibility tests. (#2679)
990- Allow configuring the Sampler with the `OTEL_TRACES_SAMPLER` and `OTEL_TRACES_SAMPLER_ARG` environment variables. (#2305, #2517)
991- Add the `metric/global` for obtaining and setting the global `MeterProvider`. (#2660)
992
993### Changed
994
995- The metrics API has been significantly changed to match the revised OpenTelemetry specification.
996 High-level changes include:
997
998 - Synchronous and asynchronous instruments are now handled by independent `InstrumentProvider`s.
999 These `InstrumentProvider`s are managed with a `Meter`.
1000 - Synchronous and asynchronous instruments are grouped into their own packages based on value types.
1001 - Asynchronous callbacks can now be registered with a `Meter`.
1002
1003 Be sure to check out the metric module documentation for more information on how to use the revised API. (#2587, #2660)
1004
1005### Fixed
1006
1007- Fallback to general attribute limits when span specific ones are not set in the environment. (#2675, #2677)
1008
1009## [1.5.0] - 2022-03-16
1010
1011### Added
1012
1013- Log the Exporters configuration in the TracerProviders message. (#2578)
1014- Added support to configure the span limits with environment variables.
1015 The following environment variables are supported. (#2606, #2637)
1016 - `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`
1017 - `OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT`
1018 - `OTEL_SPAN_EVENT_COUNT_LIMIT`
1019 - `OTEL_EVENT_ATTRIBUTE_COUNT_LIMIT`
1020 - `OTEL_SPAN_LINK_COUNT_LIMIT`
1021 - `OTEL_LINK_ATTRIBUTE_COUNT_LIMIT`
1022
1023 If the provided environment variables are invalid (negative), the default values would be used.
1024- Rename the `gc` runtime name to `go` (#2560)
1025- Add resource container ID detection. (#2418)
1026- Add span attribute value length limit.
1027 The new `AttributeValueLengthLimit` field is added to the `"go.opentelemetry.io/otel/sdk/trace".SpanLimits` type to configure this limit for a `TracerProvider`.
1028 The default limit for this resource is "unlimited". (#2637)
1029- Add the `WithRawSpanLimits` option to `go.opentelemetry.io/otel/sdk/trace`.
1030 This option replaces the `WithSpanLimits` option.
1031 Zero or negative values will not be changed to the default value like `WithSpanLimits` does.
1032 Setting a limit to zero will effectively disable the related resource it limits and setting to a negative value will mean that resource is unlimited.
1033 Consequentially, limits should be constructed using `NewSpanLimits` and updated accordingly. (#2637)
1034
1035### Changed
1036
1037- Drop oldest tracestate `Member` when capacity is reached. (#2592)
1038- Add event and link drop counts to the exported data from the `oltptrace` exporter. (#2601)
1039- Unify path cleaning functionally in the `otlpmetric` and `otlptrace` configuration. (#2639)
1040- Change the debug message from the `sdk/trace.BatchSpanProcessor` to reflect the count is cumulative. (#2640)
1041- Introduce new internal `envconfig` package for OTLP exporters. (#2608)
1042- If `http.Request.Host` is empty, fall back to use `URL.Host` when populating `http.host` in the `semconv` packages. (#2661)
1043
1044### Fixed
1045
1046- Remove the OTLP trace exporter limit of SpanEvents when exporting. (#2616)
1047- Default to port `4318` instead of `4317` for the `otlpmetrichttp` and `otlptracehttp` client. (#2614, #2625)
1048- Unlimited span limits are now supported (negative values). (#2636, #2637)
1049
1050### Deprecated
1051
1052- Deprecated `"go.opentelemetry.io/otel/sdk/trace".WithSpanLimits`.
1053 Use `WithRawSpanLimits` instead.
1054 That option allows setting unlimited and zero limits, this option does not.
1055 This option will be kept until the next major version incremented release. (#2637)
1056
1057## [1.4.1] - 2022-02-16
1058
1059### Fixed
1060
1061- Fix race condition in reading the dropped spans number for the `BatchSpanProcessor`. (#2615)
1062
1063## [1.4.0] - 2022-02-11
1064
1065### Added
1066
1067- Use `OTEL_EXPORTER_ZIPKIN_ENDPOINT` environment variable to specify zipkin collector endpoint. (#2490)
1068- Log the configuration of `TracerProvider`s, and `Tracer`s for debugging.
1069 To enable use a logger with Verbosity (V level) `>=1`. (#2500)
1070- Added support to configure the batch span-processor with environment variables.
1071 The following environment variables are used. (#2515)
1072 - `OTEL_BSP_SCHEDULE_DELAY`
1073 - `OTEL_BSP_EXPORT_TIMEOUT`
1074 - `OTEL_BSP_MAX_QUEUE_SIZE`.
1075 - `OTEL_BSP_MAX_EXPORT_BATCH_SIZE`
1076
1077### Changed
1078
1079- Zipkin exporter exports `Resource` attributes in the `Tags` field. (#2589)
1080
1081### Deprecated
1082
1083- Deprecate module the `go.opentelemetry.io/otel/sdk/export/metric`.
1084 Use the `go.opentelemetry.io/otel/sdk/metric` module instead. (#2382)
1085- Deprecate `"go.opentelemetry.io/otel/sdk/metric".AtomicFieldOffsets`. (#2445)
1086
1087### Fixed
1088
1089- Fixed the instrument kind for noop async instruments to correctly report an implementation. (#2461)
1090- Fix UDP packets overflowing with Jaeger payloads. (#2489, #2512)
1091- Change the `otlpmetric.Client` interface's `UploadMetrics` method to accept a single `ResourceMetrics` instead of a slice of them. (#2491)
1092- Specify explicit buckets in Prometheus example, fixing issue where example only has `+inf` bucket. (#2419, #2493)
1093- W3C baggage will now decode urlescaped values. (#2529)
1094- Baggage members are now only validated once, when calling `NewMember` and not also when adding it to the baggage itself. (#2522)
1095- The order attributes are dropped from spans in the `go.opentelemetry.io/otel/sdk/trace` package when capacity is reached is fixed to be in compliance with the OpenTelemetry specification.
1096 Instead of dropping the least-recently-used attribute, the last added attribute is dropped.
1097 This drop order still only applies to attributes with unique keys not already contained in the span.
1098 If an attribute is added with a key already contained in the span, that attribute is updated to the new value being added. (#2576)
1099
1100### Removed
1101
1102- Updated `go.opentelemetry.io/proto/otlp` from `v0.11.0` to `v0.12.0`. This version removes a number of deprecated methods. (#2546)
1103 - [`Metric.GetIntGauge()`](https://pkg.go.dev/go.opentelemetry.io/proto/otlp@v0.11.0/metrics/v1#Metric.GetIntGauge)
1104 - [`Metric.GetIntHistogram()`](https://pkg.go.dev/go.opentelemetry.io/proto/otlp@v0.11.0/metrics/v1#Metric.GetIntHistogram)
1105 - [`Metric.GetIntSum()`](https://pkg.go.dev/go.opentelemetry.io/proto/otlp@v0.11.0/metrics/v1#Metric.GetIntSum)
1106
1107## [1.3.0] - 2021-12-10
1108
1109### ⚠️ Notice ⚠️
1110
1111We have updated the project minimum supported Go version to 1.16
1112
1113### Added
1114
1115- Added an internal Logger.
1116 This can be used by the SDK and API to provide users with feedback of the internal state.
1117 To enable verbose logs configure the logger which will print V(1) logs. For debugging information configure to print V(5) logs. (#2343)
1118- Add the `WithRetry` `Option` and the `RetryConfig` type to the `go.opentelemetry.io/otel/exporter/otel/otlpmetric/otlpmetrichttp` package to specify retry behavior consistently. (#2425)
1119- Add `SpanStatusFromHTTPStatusCodeAndSpanKind` to all `semconv` packages to return a span status code similar to `SpanStatusFromHTTPStatusCode`, but exclude `4XX` HTTP errors as span errors if the span is of server kind. (#2296)
1120
1121### Changed
1122
1123- The `"go.opentelemetry.io/otel/exporter/otel/otlptrace/otlptracegrpc".Client` now uses the underlying gRPC `ClientConn` to handle name resolution, TCP connection establishment (with retries and backoff) and TLS handshakes, and handling errors on established connections by re-resolving the name and reconnecting. (#2329)
1124- The `"go.opentelemetry.io/otel/exporter/otel/otlpmetric/otlpmetricgrpc".Client` now uses the underlying gRPC `ClientConn` to handle name resolution, TCP connection establishment (with retries and backoff) and TLS handshakes, and handling errors on established connections by re-resolving the name and reconnecting. (#2425)
1125- The `"go.opentelemetry.io/otel/exporter/otel/otlpmetric/otlpmetricgrpc".RetrySettings` type is renamed to `RetryConfig`. (#2425)
1126- The `go.opentelemetry.io/otel/exporter/otel/*` gRPC exporters now default to using the host's root CA set if none are provided by the user and `WithInsecure` is not specified. (#2432)
1127- Change `resource.Default` to be evaluated the first time it is called, rather than on import. This allows the caller the option to update `OTEL_RESOURCE_ATTRIBUTES` first, such as with `os.Setenv`. (#2371)
1128
1129### Fixed
1130
1131- The `go.opentelemetry.io/otel/exporter/otel/*` exporters are updated to handle per-signal and universal endpoints according to the OpenTelemetry specification.
1132 Any per-signal endpoint set via an `OTEL_EXPORTER_OTLP_<signal>_ENDPOINT` environment variable is now used without modification of the path.
1133 When `OTEL_EXPORTER_OTLP_ENDPOINT` is set, if it contains a path, that path is used as a base path which per-signal paths are appended to. (#2433)
1134- Basic metric controller updated to use sync.Map to avoid blocking calls (#2381)
1135- The `go.opentelemetry.io/otel/exporter/jaeger` correctly sets the `otel.status_code` value to be a string of `ERROR` or `OK` instead of an integer code. (#2439, #2440)
1136
1137### Deprecated
1138
1139- Deprecated the `"go.opentelemetry.io/otel/exporter/otel/otlpmetric/otlpmetrichttp".WithMaxAttempts` `Option`, use the new `WithRetry` `Option` instead. (#2425)
1140- Deprecated the `"go.opentelemetry.io/otel/exporter/otel/otlpmetric/otlpmetrichttp".WithBackoff` `Option`, use the new `WithRetry` `Option` instead. (#2425)
1141
1142### Removed
1143
1144- Remove the metric Processor's ability to convert cumulative to delta aggregation temporality. (#2350)
1145- Remove the metric Bound Instruments interface and implementations. (#2399)
1146- Remove the metric MinMaxSumCount kind aggregation and the corresponding OTLP export path. (#2423)
1147- Metric SDK removes the "exact" aggregator for histogram instruments, as it performed a non-standard aggregation for OTLP export (creating repeated Gauge points) and worked its way into a number of confusing examples. (#2348)
1148
1149## [1.2.0] - 2021-11-12
1150
1151### Changed
1152
1153- Metric SDK `export.ExportKind`, `export.ExportKindSelector` types have been renamed to `aggregation.Temporality` and `aggregation.TemporalitySelector` respectively to keep in line with current specification and protocol along with built-in selectors (e.g., `aggregation.CumulativeTemporalitySelector`, ...). (#2274)
1154- The Metric `Exporter` interface now requires a `TemporalitySelector` method instead of an `ExportKindSelector`. (#2274)
1155- Metrics API cleanup. The `metric/sdkapi` package has been created to relocate the API-to-SDK interface:
1156 - The following interface types simply moved from `metric` to `metric/sdkapi`: `Descriptor`, `MeterImpl`, `InstrumentImpl`, `SyncImpl`, `BoundSyncImpl`, `AsyncImpl`, `AsyncRunner`, `AsyncSingleRunner`, and `AsyncBatchRunner`
1157 - The following struct types moved and are replaced with type aliases, since they are exposed to the user: `Observation`, `Measurement`.
1158 - The No-op implementations of sync and async instruments are no longer exported, new functions `sdkapi.NewNoopAsyncInstrument()` and `sdkapi.NewNoopSyncInstrument()` are provided instead. (#2271)
1159- Update the SDK `BatchSpanProcessor` to export all queued spans when `ForceFlush` is called. (#2080, #2335)
1160
1161### Added
1162
1163- Add the `"go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc".WithGRPCConn` option so the exporter can reuse an existing gRPC connection. (#2002)
1164- Added a new `schema` module to help parse Schema Files in OTEP 0152 format. (#2267)
1165- Added a new `MapCarrier` to the `go.opentelemetry.io/otel/propagation` package to hold propagated cross-cutting concerns as a `map[string]string` held in memory. (#2334)
1166
1167## [1.1.0] - 2021-10-27
1168
1169### Added
1170
1171- Add the `"go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc".WithGRPCConn` option so the exporter can reuse an existing gRPC connection. (#2002)
1172- Add the `go.opentelemetry.io/otel/semconv/v1.7.0` package.
1173 The package contains semantic conventions from the `v1.7.0` version of the OpenTelemetry specification. (#2320)
1174- Add the `go.opentelemetry.io/otel/semconv/v1.6.1` package.
1175 The package contains semantic conventions from the `v1.6.1` version of the OpenTelemetry specification. (#2321)
1176- Add the `go.opentelemetry.io/otel/semconv/v1.5.0` package.
1177 The package contains semantic conventions from the `v1.5.0` version of the OpenTelemetry specification. (#2322)
1178 - When upgrading from the `semconv/v1.4.0` package note the following name changes:
1179 - `K8SReplicasetUIDKey` -> `K8SReplicaSetUIDKey`
1180 - `K8SReplicasetNameKey` -> `K8SReplicaSetNameKey`
1181 - `K8SStatefulsetUIDKey` -> `K8SStatefulSetUIDKey`
1182 - `k8SStatefulsetNameKey` -> `K8SStatefulSetNameKey`
1183 - `K8SDaemonsetUIDKey` -> `K8SDaemonSetUIDKey`
1184 - `K8SDaemonsetNameKey` -> `K8SDaemonSetNameKey`
1185
1186### Changed
1187
1188- Links added to a span will be dropped by the SDK if they contain an invalid span context (#2275).
1189
1190### Fixed
1191
1192- The `"go.opentelemetry.io/otel/semconv/v1.4.0".HTTPServerAttributesFromHTTPRequest` now correctly only sets the HTTP client IP attribute even if the connection was routed with proxies and there are multiple addresses in the `X-Forwarded-For` header. (#2282, #2284)
1193- The `"go.opentelemetry.io/otel/semconv/v1.4.0".NetAttributesFromHTTPRequest` function correctly handles IPv6 addresses as IP addresses and sets the correct net peer IP instead of the net peer hostname attribute. (#2283, #2285)
1194- The simple span processor shutdown method deterministically returns the exporter error status if it simultaneously finishes when the deadline is reached. (#2290, #2289)
1195
1196## [1.0.1] - 2021-10-01
1197
1198### Fixed
1199
1200- json stdout exporter no longer crashes due to concurrency bug. (#2265)
1201
1202## [Metrics 0.24.0] - 2021-10-01
1203
1204### Changed
1205
1206- NoopMeterProvider is now private and NewNoopMeterProvider must be used to obtain a noopMeterProvider. (#2237)
1207- The Metric SDK `Export()` function takes a new two-level reader interface for iterating over results one instrumentation library at a time. (#2197)
1208 - The former `"go.opentelemetry.io/otel/sdk/export/metric".CheckpointSet` is renamed `Reader`.
1209 - The new interface is named `"go.opentelemetry.io/otel/sdk/export/metric".InstrumentationLibraryReader`.
1210
1211## [1.0.0] - 2021-09-20
1212
1213This is the first stable release for the project.
1214This release includes an API and SDK for the tracing signal that will comply with the stability guarantees defined by the projects [versioning policy](./VERSIONING.md).
1215
1216### Added
1217
1218- OTLP trace exporter now sets the `SchemaURL` field in the exported telemetry if the Tracer has `WithSchemaURL` option. (#2242)
1219
1220### Fixed
1221
1222- Slice-valued attributes can correctly be used as map keys. (#2223)
1223
1224### Removed
1225
1226- Removed the `"go.opentelemetry.io/otel/exporters/zipkin".WithSDKOptions` function. (#2248)
1227- Removed the deprecated package `go.opentelemetry.io/otel/oteltest`. (#2234)
1228- Removed the deprecated package `go.opentelemetry.io/otel/bridge/opencensus/utils`. (#2233)
1229- Removed deprecated functions, types, and methods from `go.opentelemetry.io/otel/attribute` package.
1230 Use the typed functions and methods added to the package instead. (#2235)
1231 - The `Key.Array` method is removed.
1232 - The `Array` function is removed.
1233 - The `Any` function is removed.
1234 - The `ArrayValue` function is removed.
1235 - The `AsArray` function is removed.
1236
1237## [1.0.0-RC3] - 2021-09-02
1238
1239### Added
1240
1241- Added `ErrorHandlerFunc` to use a function as an `"go.opentelemetry.io/otel".ErrorHandler`. (#2149)
1242- Added `"go.opentelemetry.io/otel/trace".WithStackTrace` option to add a stack trace when using `span.RecordError` or when panic is handled in `span.End`. (#2163)
1243- Added typed slice attribute types and functionality to the `go.opentelemetry.io/otel/attribute` package to replace the existing array type and functions. (#2162)
1244 - `BoolSlice`, `IntSlice`, `Int64Slice`, `Float64Slice`, and `StringSlice` replace the use of the `Array` function in the package.
1245- Added the `go.opentelemetry.io/otel/example/fib` example package.
1246 Included is an example application that computes Fibonacci numbers. (#2203)
1247
1248### Changed
1249
1250- Metric instruments have been renamed to match the (feature-frozen) metric API specification:
1251 - ValueRecorder becomes Histogram
1252 - ValueObserver becomes Gauge
1253 - SumObserver becomes CounterObserver
1254 - UpDownSumObserver becomes UpDownCounterObserver
1255 The API exported from this project is still considered experimental. (#2202)
1256- Metric SDK/API implementation type `InstrumentKind` moves into `sdkapi` sub-package. (#2091)
1257- The Metrics SDK export record no longer contains a Resource pointer, the SDK `"go.opentelemetry.io/otel/sdk/trace/export/metric".Exporter.Export()` function for push-based exporters now takes a single Resource argument, pull-based exporters use `"go.opentelemetry.io/otel/sdk/metric/controller/basic".Controller.Resource()`. (#2120)
1258- The JSON output of the `go.opentelemetry.io/otel/exporters/stdout/stdouttrace` is harmonized now such that the output is "plain" JSON objects after each other of the form `{ ... } { ... } { ... }`. Earlier the JSON objects describing a span were wrapped in a slice for each `Exporter.ExportSpans` call, like `[ { ... } ][ { ... } { ... } ]`. Outputting JSON object directly after each other is consistent with JSON loggers, and a bit easier to parse and read. (#2196)
1259- Update the `NewTracerConfig`, `NewSpanStartConfig`, `NewSpanEndConfig`, and `NewEventConfig` function in the `go.opentelemetry.io/otel/trace` package to return their respective configurations as structs instead of pointers to the struct. (#2212)
1260
1261### Deprecated
1262
1263- The `go.opentelemetry.io/otel/bridge/opencensus/utils` package is deprecated.
1264 All functionality from this package now exists in the `go.opentelemetry.io/otel/bridge/opencensus` package.
1265 The functions from that package should be used instead. (#2166)
1266- The `"go.opentelemetry.io/otel/attribute".Array` function and the related `ARRAY` value type is deprecated.
1267 Use the typed `*Slice` functions and types added to the package instead. (#2162)
1268- The `"go.opentelemetry.io/otel/attribute".Any` function is deprecated.
1269 Use the typed functions instead. (#2181)
1270- The `go.opentelemetry.io/otel/oteltest` package is deprecated.
1271 The `"go.opentelemetry.io/otel/sdk/trace/tracetest".SpanRecorder` can be registered with the default SDK (`go.opentelemetry.io/otel/sdk/trace`) as a `SpanProcessor` and used as a replacement for this deprecated package. (#2188)
1272
1273### Removed
1274
1275- Removed metrics test package `go.opentelemetry.io/otel/sdk/export/metric/metrictest`. (#2105)
1276
1277### Fixed
1278
1279- The `fromEnv` detector no longer throws an error when `OTEL_RESOURCE_ATTRIBUTES` environment variable is not set or empty. (#2138)
1280- Setting the global `ErrorHandler` with `"go.opentelemetry.io/otel".SetErrorHandler` multiple times is now supported. (#2160, #2140)
1281- The `"go.opentelemetry.io/otel/attribute".Any` function now supports `int32` values. (#2169)
1282- Multiple calls to `"go.opentelemetry.io/otel/sdk/metric/controller/basic".WithResource()` are handled correctly, and when no resources are provided `"go.opentelemetry.io/otel/sdk/resource".Default()` is used. (#2120)
1283- The `WithoutTimestamps` option for the `go.opentelemetry.io/otel/exporters/stdout/stdouttrace` exporter causes the exporter to correctly omit timestamps. (#2195)
1284- Fixed typos in resources.go. (#2201)
1285
1286## [1.0.0-RC2] - 2021-07-26
1287
1288### Added
1289
1290- Added `WithOSDescription` resource configuration option to set OS (Operating System) description resource attribute (`os.description`). (#1840)
1291- Added `WithOS` resource configuration option to set all OS (Operating System) resource attributes at once. (#1840)
1292- Added the `WithRetry` option to the `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp` package.
1293 This option is a replacement for the removed `WithMaxAttempts` and `WithBackoff` options. (#2095)
1294- Added API `LinkFromContext` to return Link which encapsulates SpanContext from provided context and also encapsulates attributes. (#2115)
1295- Added a new `Link` type under the SDK `otel/sdk/trace` package that counts the number of attributes that were dropped for surpassing the `AttributePerLinkCountLimit` configured in the Span's `SpanLimits`.
1296 This new type replaces the equal-named API `Link` type found in the `otel/trace` package for most usages within the SDK.
1297 For example, instances of this type are now returned by the `Links()` function of `ReadOnlySpan`s provided in places like the `OnEnd` function of `SpanProcessor` implementations. (#2118)
1298- Added the `SpanRecorder` type to the `go.opentelemetry.io/otel/skd/trace/tracetest` package.
1299 This type can be used with the default SDK as a `SpanProcessor` during testing. (#2132)
1300
1301### Changed
1302
1303- The `SpanModels` function is now exported from the `go.opentelemetry.io/otel/exporters/zipkin` package to convert OpenTelemetry spans into Zipkin model spans. (#2027)
1304- Rename the `"go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc".RetrySettings` to `RetryConfig`. (#2095)
1305
1306### Deprecated
1307
1308- The `TextMapCarrier` and `TextMapPropagator` from the `go.opentelemetry.io/otel/oteltest` package and their associated creation functions (`TextMapCarrier`, `NewTextMapPropagator`) are deprecated. (#2114)
1309- The `Harness` type from the `go.opentelemetry.io/otel/oteltest` package and its associated creation function, `NewHarness` are deprecated and will be removed in the next release. (#2123)
1310- The `TraceStateFromKeyValues` function from the `go.opentelemetry.io/otel/oteltest` package is deprecated.
1311 Use the `trace.ParseTraceState` function instead. (#2122)
1312
1313### Removed
1314
1315- Removed the deprecated package `go.opentelemetry.io/otel/exporters/trace/jaeger`. (#2020)
1316- Removed the deprecated package `go.opentelemetry.io/otel/exporters/trace/zipkin`. (#2020)
1317- Removed the `"go.opentelemetry.io/otel/sdk/resource".WithBuiltinDetectors` function.
1318 The explicit `With*` options for every built-in detector should be used instead. (#2026 #2097)
1319- Removed the `WithMaxAttempts` and `WithBackoff` options from the `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp` package.
1320 The retry logic of the package has been updated to match the `otlptracegrpc` package and accordingly a `WithRetry` option is added that should be used instead. (#2095)
1321- Removed `DroppedAttributeCount` field from `otel/trace.Link` struct. (#2118)
1322
1323### Fixed
1324
1325- When using WithNewRoot, don't use the parent context for making sampling decisions. (#2032)
1326- `oteltest.Tracer` now creates a valid `SpanContext` when using `WithNewRoot`. (#2073)
1327- OS type detector now sets the correct `dragonflybsd` value for DragonFly BSD. (#2092)
1328- The OTel span status is correctly transformed into the OTLP status in the `go.opentelemetry.io/otel/exporters/otlp/otlptrace` package.
1329 This fix will by default set the status to `Unset` if it is not explicitly set to `Ok` or `Error`. (#2099 #2102)
1330- The `Inject` method for the `"go.opentelemetry.io/otel/propagation".TraceContext` type no longer injects empty `tracestate` values. (#2108)
1331- Use `6831` as default Jaeger agent port instead of `6832`. (#2131)
1332
1333## [Experimental Metrics v0.22.0] - 2021-07-19
1334
1335### Added
1336
1337- Adds HTTP support for OTLP metrics exporter. (#2022)
1338
1339### Removed
1340
1341- Removed the deprecated package `go.opentelemetry.io/otel/exporters/metric/prometheus`. (#2020)
1342
1343## [1.0.0-RC1] / 0.21.0 - 2021-06-18
1344
1345With this release we are introducing a split in module versions. The tracing API and SDK are entering the `v1.0.0` Release Candidate phase with `v1.0.0-RC1`
1346while the experimental metrics API and SDK continue with `v0.x` releases at `v0.21.0`. Modules at major version 1 or greater will not depend on modules
1347with major version 0.
1348
1349### Added
1350
1351- Adds `otlpgrpc.WithRetry`option for configuring the retry policy for transient errors on the otlp/gRPC exporter. (#1832)
1352 - The following status codes are defined as transient errors:
1353 | gRPC Status Code | Description |
1354 | ---------------- | ----------- |
1355 | 1 | Cancelled |
1356 | 4 | Deadline Exceeded |
1357 | 8 | Resource Exhausted |
1358 | 10 | Aborted |
1359 | 10 | Out of Range |
1360 | 14 | Unavailable |
1361 | 15 | Data Loss |
1362- Added `Status` type to the `go.opentelemetry.io/otel/sdk/trace` package to represent the status of a span. (#1874)
1363- Added `SpanStub` type and its associated functions to the `go.opentelemetry.io/otel/sdk/trace/tracetest` package.
1364 This type can be used as a testing replacement for the `SpanSnapshot` that was removed from the `go.opentelemetry.io/otel/sdk/trace` package. (#1873)
1365- Adds support for scheme in `OTEL_EXPORTER_OTLP_ENDPOINT` according to the spec. (#1886)
1366- Adds `trace.WithSchemaURL` option for configuring the tracer with a Schema URL. (#1889)
1367- Added an example of using OpenTelemetry Go as a trace context forwarder. (#1912)
1368- `ParseTraceState` is added to the `go.opentelemetry.io/otel/trace` package.
1369 It can be used to decode a `TraceState` from a `tracestate` header string value. (#1937)
1370- Added `Len` method to the `TraceState` type in the `go.opentelemetry.io/otel/trace` package.
1371 This method returns the number of list-members the `TraceState` holds. (#1937)
1372- Creates package `go.opentelemetry.io/otel/exporters/otlp/otlptrace` that defines a trace exporter that uses a `otlptrace.Client` to send data.
1373 Creates package `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc` implementing a gRPC `otlptrace.Client` and offers convenience functions, `NewExportPipeline` and `InstallNewPipeline`, to setup and install a `otlptrace.Exporter` in tracing .(#1922)
1374- Added `Baggage`, `Member`, and `Property` types to the `go.opentelemetry.io/otel/baggage` package along with their related functions. (#1967)
1375- Added `ContextWithBaggage`, `ContextWithoutBaggage`, and `FromContext` functions to the `go.opentelemetry.io/otel/baggage` package.
1376 These functions replace the `Set`, `Value`, `ContextWithValue`, `ContextWithoutValue`, and `ContextWithEmpty` functions from that package and directly work with the new `Baggage` type. (#1967)
1377- The `OTEL_SERVICE_NAME` environment variable is the preferred source for `service.name`, used by the environment resource detector if a service name is present both there and in `OTEL_RESOURCE_ATTRIBUTES`. (#1969)
1378- Creates package `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp` implementing an HTTP `otlptrace.Client` and offers convenience functions, `NewExportPipeline` and `InstallNewPipeline`, to setup and install a `otlptrace.Exporter` in tracing. (#1963)
1379- Changes `go.opentelemetry.io/otel/sdk/resource.NewWithAttributes` to require a schema URL. The old function is still available as `resource.NewSchemaless`. This is a breaking change. (#1938)
1380- Several builtin resource detectors now correctly populate the schema URL. (#1938)
1381- Creates package `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` that defines a metrics exporter that uses a `otlpmetric.Client` to send data.
1382- Creates package `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` implementing a gRPC `otlpmetric.Client` and offers convenience functions, `New` and `NewUnstarted`, to create an `otlpmetric.Exporter`.(#1991)
1383- Added `go.opentelemetry.io/otel/exporters/stdout/stdouttrace` exporter. (#2005)
1384- Added `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric` exporter. (#2005)
1385- Added a `TracerProvider()` method to the `"go.opentelemetry.io/otel/trace".Span` interface. This can be used to obtain a `TracerProvider` from a given span that utilizes the same trace processing pipeline. (#2009)
1386
1387### Changed
1388
1389- Make `NewSplitDriver` from `go.opentelemetry.io/otel/exporters/otlp` take variadic arguments instead of a `SplitConfig` item.
1390 `NewSplitDriver` now automatically implements an internal `noopDriver` for `SplitConfig` fields that are not initialized. (#1798)
1391- `resource.New()` now creates a Resource without builtin detectors. Previous behavior is now achieved by using `WithBuiltinDetectors` Option. (#1810)
1392- Move the `Event` type from the `go.opentelemetry.io/otel` package to the `go.opentelemetry.io/otel/sdk/trace` package. (#1846)
1393- CI builds validate against last two versions of Go, dropping 1.14 and adding 1.16. (#1865)
1394- BatchSpanProcessor now report export failures when calling `ForceFlush()` method. (#1860)
1395- `Set.Encoded(Encoder)` no longer caches the result of an encoding. (#1855)
1396- Renamed `CloudZoneKey` to `CloudAvailabilityZoneKey` in Resource semantic conventions according to spec. (#1871)
1397- The `StatusCode` and `StatusMessage` methods of the `ReadOnlySpan` interface and the `Span` produced by the `go.opentelemetry.io/otel/sdk/trace` package have been replaced with a single `Status` method.
1398 This method returns the status of a span using the new `Status` type. (#1874)
1399- Updated `ExportSpans` method of the`SpanExporter` interface type to accept `ReadOnlySpan`s instead of the removed `SpanSnapshot`.
1400 This brings the export interface into compliance with the specification in that it now accepts an explicitly immutable type instead of just an implied one. (#1873)
1401- Unembed `SpanContext` in `Link`. (#1877)
1402- Generate Semantic conventions from the specification YAML. (#1891)
1403- Spans created by the global `Tracer` obtained from `go.opentelemetry.io/otel`, prior to a functioning `TracerProvider` being set, now propagate the span context from their parent if one exists. (#1901)
1404- The `"go.opentelemetry.io/otel".Tracer` function now accepts tracer options. (#1902)
1405- Move the `go.opentelemetry.io/otel/unit` package to `go.opentelemetry.io/otel/metric/unit`. (#1903)
1406- Changed `go.opentelemetry.io/otel/trace.TracerConfig` to conform to the [Contributing guidelines](CONTRIBUTING.md#config.) (#1921)
1407- Changed `go.opentelemetry.io/otel/trace.SpanConfig` to conform to the [Contributing guidelines](CONTRIBUTING.md#config). (#1921)
1408- Changed `span.End()` now only accepts Options that are allowed at `End()`. (#1921)
1409- Changed `go.opentelemetry.io/otel/metric.InstrumentConfig` to conform to the [Contributing guidelines](CONTRIBUTING.md#config). (#1921)
1410- Changed `go.opentelemetry.io/otel/metric.MeterConfig` to conform to the [Contributing guidelines](CONTRIBUTING.md#config). (#1921)
1411- Refactored option types according to the contribution style guide. (#1882)
1412- Move the `go.opentelemetry.io/otel/trace.TraceStateFromKeyValues` function to the `go.opentelemetry.io/otel/oteltest` package.
1413 This function is preserved for testing purposes where it may be useful to create a `TraceState` from `attribute.KeyValue`s, but it is not intended for production use.
1414 The new `ParseTraceState` function should be used to create a `TraceState`. (#1931)
1415- Updated `MarshalJSON` method of the `go.opentelemetry.io/otel/trace.TraceState` type to marshal the type into the string representation of the `TraceState`. (#1931)
1416- The `TraceState.Delete` method from the `go.opentelemetry.io/otel/trace` package no longer returns an error in addition to a `TraceState`. (#1931)
1417- Updated `Get` method of the `TraceState` type from the `go.opentelemetry.io/otel/trace` package to accept a `string` instead of an `attribute.Key` type. (#1931)
1418- Updated `Insert` method of the `TraceState` type from the `go.opentelemetry.io/otel/trace` package to accept a pair of `string`s instead of an `attribute.KeyValue` type. (#1931)
1419- Updated `Delete` method of the `TraceState` type from the `go.opentelemetry.io/otel/trace` package to accept a `string` instead of an `attribute.Key` type. (#1931)
1420- Renamed `NewExporter` to `New` in the `go.opentelemetry.io/otel/exporters/stdout` package. (#1985)
1421- Renamed `NewExporter` to `New` in the `go.opentelemetry.io/otel/exporters/metric/prometheus` package. (#1985)
1422- Renamed `NewExporter` to `New` in the `go.opentelemetry.io/otel/exporters/trace/jaeger` package. (#1985)
1423- Renamed `NewExporter` to `New` in the `go.opentelemetry.io/otel/exporters/trace/zipkin` package. (#1985)
1424- Renamed `NewExporter` to `New` in the `go.opentelemetry.io/otel/exporters/otlp` package. (#1985)
1425- Renamed `NewUnstartedExporter` to `NewUnstarted` in the `go.opentelemetry.io/otel/exporters/otlp` package. (#1985)
1426- The `go.opentelemetry.io/otel/semconv` package has been moved to `go.opentelemetry.io/otel/semconv/v1.4.0` to allow for multiple [telemetry schema](https://github.com/open-telemetry/oteps/blob/main/text/0152-telemetry-schemas.md) versions to be used concurrently. (#1987)
1427- Metrics test helpers in `go.opentelemetry.io/otel/oteltest` have been moved to `go.opentelemetry.io/otel/metric/metrictest`. (#1988)
1428
1429### Deprecated
1430
1431- The `go.opentelemetry.io/otel/exporters/metric/prometheus` is deprecated, use `go.opentelemetry.io/otel/exporters/prometheus` instead. (#1993)
1432- The `go.opentelemetry.io/otel/exporters/trace/jaeger` is deprecated, use `go.opentelemetry.io/otel/exporters/jaeger` instead. (#1993)
1433- The `go.opentelemetry.io/otel/exporters/trace/zipkin` is deprecated, use `go.opentelemetry.io/otel/exporters/zipkin` instead. (#1993)
1434
1435### Removed
1436
1437- Removed `resource.WithoutBuiltin()`. Use `resource.New()`. (#1810)
1438- Unexported types `resource.FromEnv`, `resource.Host`, and `resource.TelemetrySDK`, Use the corresponding `With*()` to use individually. (#1810)
1439- Removed the `Tracer` and `IsRecording` method from the `ReadOnlySpan` in the `go.opentelemetry.io/otel/sdk/trace`.
1440 The `Tracer` method is not a required to be included in this interface and given the mutable nature of the tracer that is associated with a span, this method is not appropriate.
1441 The `IsRecording` method returns if the span is recording or not.
1442 A read-only span value does not need to know if updates to it will be recorded or not.
1443 By definition, it cannot be updated so there is no point in communicating if an update is recorded. (#1873)
1444- Removed the `SpanSnapshot` type from the `go.opentelemetry.io/otel/sdk/trace` package.
1445 The use of this type has been replaced with the use of the explicitly immutable `ReadOnlySpan` type.
1446 When a concrete representation of a read-only span is needed for testing, the newly added `SpanStub` in the `go.opentelemetry.io/otel/sdk/trace/tracetest` package should be used. (#1873)
1447- Removed the `Tracer` method from the `Span` interface in the `go.opentelemetry.io/otel/trace` package.
1448 Using the same tracer that created a span introduces the error where an instrumentation library's `Tracer` is used by other code instead of their own.
1449 The `"go.opentelemetry.io/otel".Tracer` function or a `TracerProvider` should be used to acquire a library specific `Tracer` instead. (#1900)
1450 - The `TracerProvider()` method on the `Span` interface may also be used to obtain a `TracerProvider` using the same trace processing pipeline. (#2009)
1451- The `http.url` attribute generated by `HTTPClientAttributesFromHTTPRequest` will no longer include username or password information. (#1919)
1452- Removed `IsEmpty` method of the `TraceState` type in the `go.opentelemetry.io/otel/trace` package in favor of using the added `TraceState.Len` method. (#1931)
1453- Removed `Set`, `Value`, `ContextWithValue`, `ContextWithoutValue`, and `ContextWithEmpty` functions in the `go.opentelemetry.io/otel/baggage` package.
1454 Handling of baggage is now done using the added `Baggage` type and related context functions (`ContextWithBaggage`, `ContextWithoutBaggage`, and `FromContext`) in that package. (#1967)
1455- The `InstallNewPipeline` and `NewExportPipeline` creation functions in all the exporters (prometheus, otlp, stdout, jaeger, and zipkin) have been removed.
1456 These functions were deemed premature attempts to provide convenience that did not achieve this aim. (#1985)
1457- The `go.opentelemetry.io/otel/exporters/otlp` exporter has been removed. Use `go.opentelemetry.io/otel/exporters/otlp/otlptrace` instead. (#1990)
1458- The `go.opentelemetry.io/otel/exporters/stdout` exporter has been removed. Use `go.opentelemetry.io/otel/exporters/stdout/stdouttrace` or `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric` instead. (#2005)
1459
1460### Fixed
1461
1462- Only report errors from the `"go.opentelemetry.io/otel/sdk/resource".Environment` function when they are not `nil`. (#1850, #1851)
1463- The `Shutdown` method of the simple `SpanProcessor` in the `go.opentelemetry.io/otel/sdk/trace` package now honors the context deadline or cancellation. (#1616, #1856)
1464- BatchSpanProcessor now drops span batches that failed to be exported. (#1860)
1465- Use `http://localhost:14268/api/traces` as default Jaeger collector endpoint instead of `http://localhost:14250`. (#1898)
1466- Allow trailing and leading whitespace in the parsing of a `tracestate` header. (#1931)
1467- Add logic to determine if the channel is closed to fix Jaeger exporter test panic with close closed channel. (#1870, #1973)
1468- Avoid transport security when OTLP endpoint is a Unix socket. (#2001)
1469
1470### Security
1471
1472## [0.20.0] - 2021-04-23
1473
1474### Added
1475
1476- The OTLP exporter now has two new convenience functions, `NewExportPipeline` and `InstallNewPipeline`, setup and install the exporter in tracing and metrics pipelines. (#1373)
1477- Adds semantic conventions for exceptions. (#1492)
1478- Added Jaeger Environment variables: `OTEL_EXPORTER_JAEGER_AGENT_HOST`, `OTEL_EXPORTER_JAEGER_AGENT_PORT`
1479 These environment variables can be used to override Jaeger agent hostname and port (#1752)
1480- Option `ExportTimeout` was added to batch span processor. (#1755)
1481- `trace.TraceFlags` is now a defined type over `byte` and `WithSampled(bool) TraceFlags` and `IsSampled() bool` methods have been added to it. (#1770)
1482- The `Event` and `Link` struct types from the `go.opentelemetry.io/otel` package now include a `DroppedAttributeCount` field to record the number of attributes that were not recorded due to configured limits being reached. (#1771)
1483- The Jaeger exporter now reports dropped attributes for a Span event in the exported log. (#1771)
1484- Adds test to check BatchSpanProcessor ignores `OnEnd` and `ForceFlush` post `Shutdown`. (#1772)
1485- Extract resource attributes from the `OTEL_RESOURCE_ATTRIBUTES` environment variable and merge them with the `resource.Default` resource as well as resources provided to the `TracerProvider` and metric `Controller`. (#1785)
1486- Added `WithOSType` resource configuration option to set OS (Operating System) type resource attribute (`os.type`). (#1788)
1487- Added `WithProcess*` resource configuration options to set Process resource attributes. (#1788)
1488 - `process.pid`
1489 - `process.executable.name`
1490 - `process.executable.path`
1491 - `process.command_args`
1492 - `process.owner`
1493 - `process.runtime.name`
1494 - `process.runtime.version`
1495 - `process.runtime.description`
1496- Adds `k8s.node.name` and `k8s.node.uid` attribute keys to the `semconv` package. (#1789)
1497- Added support for configuring OTLP/HTTP and OTLP/gRPC Endpoints, TLS Certificates, Headers, Compression and Timeout via Environment Variables. (#1758, #1769 and #1811)
1498 - `OTEL_EXPORTER_OTLP_ENDPOINT`
1499 - `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`
1500 - `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`
1501 - `OTEL_EXPORTER_OTLP_HEADERS`
1502 - `OTEL_EXPORTER_OTLP_TRACES_HEADERS`
1503 - `OTEL_EXPORTER_OTLP_METRICS_HEADERS`
1504 - `OTEL_EXPORTER_OTLP_COMPRESSION`
1505 - `OTEL_EXPORTER_OTLP_TRACES_COMPRESSION`
1506 - `OTEL_EXPORTER_OTLP_METRICS_COMPRESSION`
1507 - `OTEL_EXPORTER_OTLP_TIMEOUT`
1508 - `OTEL_EXPORTER_OTLP_TRACES_TIMEOUT`
1509 - `OTEL_EXPORTER_OTLP_METRICS_TIMEOUT`
1510 - `OTEL_EXPORTER_OTLP_CERTIFICATE`
1511 - `OTEL_EXPORTER_OTLP_TRACES_CERTIFICATE`
1512 - `OTEL_EXPORTER_OTLP_METRICS_CERTIFICATE`
1513- Adds `otlpgrpc.WithTimeout` option for configuring timeout to the otlp/gRPC exporter. (#1821)
1514- Adds `jaeger.WithMaxPacketSize` option for configuring maximum UDP packet size used when connecting to the Jaeger agent. (#1853)
1515
1516### Fixed
1517
1518- The `Span.IsRecording` implementation from `go.opentelemetry.io/otel/sdk/trace` always returns false when not being sampled. (#1750)
1519- The Jaeger exporter now correctly sets tags for the Span status code and message.
1520 This means it uses the correct tag keys (`"otel.status_code"`, `"otel.status_description"`) and does not set the status message as a tag unless it is set on the span. (#1761)
1521- The Jaeger exporter now correctly records Span event's names using the `"event"` key for a tag.
1522 Additionally, this tag is overridden, as specified in the OTel specification, if the event contains an attribute with that key. (#1768)
1523- Zipkin Exporter: Ensure mapping between OTel and Zipkin span data complies with the specification. (#1688)
1524- Fixed typo for default service name in Jaeger Exporter. (#1797)
1525- Fix flaky OTLP for the reconnnection of the client connection. (#1527, #1814)
1526- Fix Jaeger exporter dropping of span batches that exceed the UDP packet size limit.
1527 Instead, the exporter now splits the batch into smaller sendable batches. (#1828)
1528
1529### Changed
1530
1531- Span `RecordError` now records an `exception` event to comply with the semantic convention specification. (#1492)
1532- Jaeger exporter was updated to use thrift v0.14.1. (#1712)
1533- Migrate from using internally built and maintained version of the OTLP to the one hosted at `go.opentelemetry.io/proto/otlp`. (#1713)
1534- Migrate from using `github.com/gogo/protobuf` to `google.golang.org/protobuf` to match `go.opentelemetry.io/proto/otlp`. (#1713)
1535- The storage of a local or remote Span in a `context.Context` using its SpanContext is unified to store just the current Span.
1536 The Span's SpanContext can now self-identify as being remote or not.
1537 This means that `"go.opentelemetry.io/otel/trace".ContextWithRemoteSpanContext` will now overwrite any existing current Span, not just existing remote Spans, and make it the current Span in a `context.Context`. (#1731)
1538- Improve OTLP/gRPC exporter connection errors. (#1737)
1539- Information about a parent span context in a `"go.opentelemetry.io/otel/export/trace".SpanSnapshot` is unified in a new `Parent` field.
1540 The existing `ParentSpanID` and `HasRemoteParent` fields are removed in favor of this. (#1748)
1541- The `ParentContext` field of the `"go.opentelemetry.io/otel/sdk/trace".SamplingParameters` is updated to hold a `context.Context` containing the parent span.
1542 This changes it to make `SamplingParameters` conform with the OpenTelemetry specification. (#1749)
1543- Updated Jaeger Environment Variables: `JAEGER_ENDPOINT`, `JAEGER_USER`, `JAEGER_PASSWORD`
1544 to `OTEL_EXPORTER_JAEGER_ENDPOINT`, `OTEL_EXPORTER_JAEGER_USER`, `OTEL_EXPORTER_JAEGER_PASSWORD` in compliance with OTel specification. (#1752)
1545- Modify `BatchSpanProcessor.ForceFlush` to abort after timeout/cancellation. (#1757)
1546- The `DroppedAttributeCount` field of the `Span` in the `go.opentelemetry.io/otel` package now only represents the number of attributes dropped for the span itself.
1547 It no longer is a conglomerate of itself, events, and link attributes that have been dropped. (#1771)
1548- Make `ExportSpans` in Jaeger Exporter honor context deadline. (#1773)
1549- Modify Zipkin Exporter default service name, use default resource's serviceName instead of empty. (#1777)
1550- The `go.opentelemetry.io/otel/sdk/export/trace` package is merged into the `go.opentelemetry.io/otel/sdk/trace` package. (#1778)
1551- The prometheus.InstallNewPipeline example is moved from comment to example test (#1796)
1552- The convenience functions for the stdout exporter have been updated to return the `TracerProvider` implementation and enable the shutdown of the exporter. (#1800)
1553- Replace the flush function returned from the Jaeger exporter's convenience creation functions (`InstallNewPipeline` and `NewExportPipeline`) with the `TracerProvider` implementation they create.
1554 This enables the caller to shutdown and flush using the related `TracerProvider` methods. (#1822)
1555- Updated the Jaeger exporter to have a default endpoint, `http://localhost:14250`, for the collector. (#1824)
1556- Changed the function `WithCollectorEndpoint` in the Jaeger exporter to no longer accept an endpoint as an argument.
1557 The endpoint can be passed with the `CollectorEndpointOption` using the `WithEndpoint` function or by setting the `OTEL_EXPORTER_JAEGER_ENDPOINT` environment variable value appropriately. (#1824)
1558- The Jaeger exporter no longer batches exported spans itself, instead it relies on the SDK's `BatchSpanProcessor` for this functionality. (#1830)
1559- The Jaeger exporter creation functions (`NewRawExporter`, `NewExportPipeline`, and `InstallNewPipeline`) no longer accept the removed `Option` type as a variadic argument. (#1830)
1560
1561### Removed
1562
1563- Removed Jaeger Environment variables: `JAEGER_SERVICE_NAME`, `JAEGER_DISABLED`, `JAEGER_TAGS`
1564 These environment variables will no longer be used to override values of the Jaeger exporter (#1752)
1565- No longer set the links for a `Span` in `go.opentelemetry.io/otel/sdk/trace` that is configured to be a new root.
1566 This is unspecified behavior that the OpenTelemetry community plans to standardize in the future.
1567 To prevent backwards incompatible changes when it is specified, these links are removed. (#1726)
1568- Setting error status while recording error with Span from oteltest package. (#1729)
1569- The concept of a remote and local Span stored in a context is unified to just the current Span.
1570 Because of this `"go.opentelemetry.io/otel/trace".RemoteSpanContextFromContext` is removed as it is no longer needed.
1571 Instead, `"go.opentelemetry.io/otel/trace".SpanContextFromContex` can be used to return the current Span.
1572 If needed, that Span's `SpanContext.IsRemote()` can then be used to determine if it is remote or not. (#1731)
1573- The `HasRemoteParent` field of the `"go.opentelemetry.io/otel/sdk/trace".SamplingParameters` is removed.
1574 This field is redundant to the information returned from the `Remote` method of the `SpanContext` held in the `ParentContext` field. (#1749)
1575- The `trace.FlagsDebug` and `trace.FlagsDeferred` constants have been removed and will be localized to the B3 propagator. (#1770)
1576- Remove `Process` configuration, `WithProcessFromEnv` and `ProcessFromEnv`, and type from the Jaeger exporter package.
1577 The information that could be configured in the `Process` struct should be configured in a `Resource` instead. (#1776, #1804)
1578- Remove the `WithDisabled` option from the Jaeger exporter.
1579 To disable the exporter unregister it from the `TracerProvider` or use a no-operation `TracerProvider`. (#1806)
1580- Removed the functions `CollectorEndpointFromEnv` and `WithCollectorEndpointOptionFromEnv` from the Jaeger exporter.
1581 These functions for retrieving specific environment variable values are redundant of other internal functions and
1582 are not intended for end user use. (#1824)
1583- Removed the Jaeger exporter `WithSDKOptions` `Option`.
1584 This option was used to set SDK options for the exporter creation convenience functions.
1585 These functions are provided as a way to easily setup or install the exporter with what are deemed reasonable SDK settings for common use cases.
1586 If the SDK needs to be configured differently, the `NewRawExporter` function and direct setup of the SDK with the desired settings should be used. (#1825)
1587- The `WithBufferMaxCount` and `WithBatchMaxCount` `Option`s from the Jaeger exporter are removed.
1588 The exporter no longer batches exports, instead relying on the SDK's `BatchSpanProcessor` for this functionality. (#1830)
1589- The Jaeger exporter `Option` type is removed.
1590 The type is no longer used by the exporter to configure anything.
1591 All the previous configurations these options provided were duplicates of SDK configuration.
1592 They have been removed in favor of using the SDK configuration and focuses the exporter configuration to be only about the endpoints it will send telemetry to. (#1830)
1593
1594## [0.19.0] - 2021-03-18
1595
1596### Added
1597
1598- Added `Marshaler` config option to `otlphttp` to enable otlp over json or protobufs. (#1586)
1599- A `ForceFlush` method to the `"go.opentelemetry.io/otel/sdk/trace".TracerProvider` to flush all registered `SpanProcessor`s. (#1608)
1600- Added `WithSampler` and `WithSpanLimits` to tracer provider. (#1633, #1702)
1601- `"go.opentelemetry.io/otel/trace".SpanContext` now has a `remote` property, and `IsRemote()` predicate, that is true when the `SpanContext` has been extracted from remote context data. (#1701)
1602- A `Valid` method to the `"go.opentelemetry.io/otel/attribute".KeyValue` type. (#1703)
1603
1604### Changed
1605
1606- `trace.SpanContext` is now immutable and has no exported fields. (#1573)
1607 - `trace.NewSpanContext()` can be used in conjunction with the `trace.SpanContextConfig` struct to initialize a new `SpanContext` where all values are known.
1608- Update the `ForceFlush` method signature to the `"go.opentelemetry.io/otel/sdk/trace".SpanProcessor` to accept a `context.Context` and return an error. (#1608)
1609- Update the `Shutdown` method to the `"go.opentelemetry.io/otel/sdk/trace".TracerProvider` return an error on shutdown failure. (#1608)
1610- The SimpleSpanProcessor will now shut down the enclosed `SpanExporter` and gracefully ignore subsequent calls to `OnEnd` after `Shutdown` is called. (#1612)
1611- `"go.opentelemetry.io/sdk/metric/controller.basic".WithPusher` is replaced with `WithExporter` to provide consistent naming across project. (#1656)
1612- Added non-empty string check for trace `Attribute` keys. (#1659)
1613- Add `description` to SpanStatus only when `StatusCode` is set to error. (#1662)
1614- Jaeger exporter falls back to `resource.Default`'s `service.name` if the exported Span does not have one. (#1673)
1615- Jaeger exporter populates Jaeger's Span Process from Resource. (#1673)
1616- Renamed the `LabelSet` method of `"go.opentelemetry.io/otel/sdk/resource".Resource` to `Set`. (#1692)
1617- Changed `WithSDK` to `WithSDKOptions` to accept variadic arguments of `TracerProviderOption` type in `go.opentelemetry.io/otel/exporters/trace/jaeger` package. (#1693)
1618- Changed `WithSDK` to `WithSDKOptions` to accept variadic arguments of `TracerProviderOption` type in `go.opentelemetry.io/otel/exporters/trace/zipkin` package. (#1693)
1619
1620### Removed
1621
1622- Removed `serviceName` parameter from Zipkin exporter and uses resource instead. (#1549)
1623- Removed `WithConfig` from tracer provider to avoid overriding configuration. (#1633)
1624- Removed the exported `SimpleSpanProcessor` and `BatchSpanProcessor` structs.
1625 These are now returned as a SpanProcessor interface from their respective constructors. (#1638)
1626- Removed `WithRecord()` from `trace.SpanOption` when creating a span. (#1660)
1627- Removed setting status to `Error` while recording an error as a span event in `RecordError`. (#1663)
1628- Removed `jaeger.WithProcess` configuration option. (#1673)
1629- Removed `ApplyConfig` method from `"go.opentelemetry.io/otel/sdk/trace".TracerProvider` and the now unneeded `Config` struct. (#1693)
1630
1631### Fixed
1632
1633- Jaeger Exporter: Ensure mapping between OTEL and Jaeger span data complies with the specification. (#1626)
1634- `SamplingResult.TraceState` is correctly propagated to a newly created span's `SpanContext`. (#1655)
1635- The `otel-collector` example now correctly flushes metric events prior to shutting down the exporter. (#1678)
1636- Do not set span status message in `SpanStatusFromHTTPStatusCode` if it can be inferred from `http.status_code`. (#1681)
1637- Synchronization issues in global trace delegate implementation. (#1686)
1638- Reduced excess memory usage by global `TracerProvider`. (#1687)
1639
1640## [0.18.0] - 2021-03-03
1641
1642### Added
1643
1644- Added `resource.Default()` for use with meter and tracer providers. (#1507)
1645- `AttributePerEventCountLimit` and `AttributePerLinkCountLimit` for `SpanLimits`. (#1535)
1646- Added `Keys()` method to `propagation.TextMapCarrier` and `propagation.HeaderCarrier` to adapt `http.Header` to this interface. (#1544)
1647- Added `code` attributes to `go.opentelemetry.io/otel/semconv` package. (#1558)
1648- Compatibility testing suite in the CI system for the following systems. (#1567)
1649 | OS | Go Version | Architecture |
1650 | ------- | ---------- | ------------ |
1651 | Ubuntu | 1.15 | amd64 |
1652 | Ubuntu | 1.14 | amd64 |
1653 | Ubuntu | 1.15 | 386 |
1654 | Ubuntu | 1.14 | 386 |
1655 | MacOS | 1.15 | amd64 |
1656 | MacOS | 1.14 | amd64 |
1657 | Windows | 1.15 | amd64 |
1658 | Windows | 1.14 | amd64 |
1659 | Windows | 1.15 | 386 |
1660 | Windows | 1.14 | 386 |
1661
1662### Changed
1663
1664- Replaced interface `oteltest.SpanRecorder` with its existing implementation
1665 `StandardSpanRecorder`. (#1542)
1666- Default span limit values to 128. (#1535)
1667- Rename `MaxEventsPerSpan`, `MaxAttributesPerSpan` and `MaxLinksPerSpan` to `EventCountLimit`, `AttributeCountLimit` and `LinkCountLimit`, and move these fields into `SpanLimits`. (#1535)
1668- Renamed the `otel/label` package to `otel/attribute`. (#1541)
1669- Vendor the Jaeger exporter's dependency on Apache Thrift. (#1551)
1670- Parallelize the CI linting and testing. (#1567)
1671- Stagger timestamps in exact aggregator tests. (#1569)
1672- Changed all examples to use `WithBatchTimeout(5 * time.Second)` rather than `WithBatchTimeout(5)`. (#1621)
1673- Prevent end-users from implementing some interfaces (#1575)
1674
1675 ```
1676 "otel/exporters/otlp/otlphttp".Option
1677 "otel/exporters/stdout".Option
1678 "otel/oteltest".Option
1679 "otel/trace".TracerOption
1680 "otel/trace".SpanOption
1681 "otel/trace".EventOption
1682 "otel/trace".LifeCycleOption
1683 "otel/trace".InstrumentationOption
1684 "otel/sdk/resource".Option
1685 "otel/sdk/trace".ParentBasedSamplerOption
1686 "otel/sdk/trace".ReadOnlySpan
1687 "otel/sdk/trace".ReadWriteSpan
1688 ```
1689
1690### Removed
1691
1692- Removed attempt to resample spans upon changing the span name with `span.SetName()`. (#1545)
1693- The `test-benchmark` is no longer a dependency of the `precommit` make target. (#1567)
1694- Removed the `test-386` make target.
1695 This was replaced with a full compatibility testing suite (i.e. multi OS/arch) in the CI system. (#1567)
1696
1697### Fixed
1698
1699- The sequential timing check of timestamps in the stdout exporter are now setup explicitly to be sequential (#1571). (#1572)
1700- Windows build of Jaeger tests now compiles with OS specific functions (#1576). (#1577)
1701- The sequential timing check of timestamps of go.opentelemetry.io/otel/sdk/metric/aggregator/lastvalue are now setup explicitly to be sequential (#1578). (#1579)
1702- Validate tracestate header keys with vendors according to the W3C TraceContext specification (#1475). (#1581)
1703- The OTLP exporter includes related labels for translations of a GaugeArray (#1563). (#1570)
1704
1705## [0.17.0] - 2021-02-12
1706
1707### Changed
1708
1709- Rename project default branch from `master` to `main`. (#1505)
1710- Reverse order in which `Resource` attributes are merged, per change in spec. (#1501)
1711- Add tooling to maintain "replace" directives in go.mod files automatically. (#1528)
1712- Create new modules: otel/metric, otel/trace, otel/oteltest, otel/sdk/export/metric, otel/sdk/metric (#1528)
1713- Move metric-related public global APIs from otel to otel/metric/global. (#1528)
1714
1715## Fixed
1716
1717- Fixed otlpgrpc reconnection issue.
1718- The example code in the README.md of `go.opentelemetry.io/otel/exporters/otlp` is moved to a compiled example test and used the new `WithAddress` instead of `WithEndpoint`. (#1513)
1719- The otel-collector example now uses the default OTLP receiver port of the collector.
1720
1721## [0.16.0] - 2021-01-13
1722
1723### Added
1724
1725- Add the `ReadOnlySpan` and `ReadWriteSpan` interfaces to provide better control for accessing span data. (#1360)
1726- `NewGRPCDriver` function returns a `ProtocolDriver` that maintains a single gRPC connection to the collector. (#1369)
1727- Added documentation about the project's versioning policy. (#1388)
1728- Added `NewSplitDriver` for OTLP exporter that allows sending traces and metrics to different endpoints. (#1418)
1729- Added codeql workflow to GitHub Actions (#1428)
1730- Added Gosec workflow to GitHub Actions (#1429)
1731- Add new HTTP driver for OTLP exporter in `exporters/otlp/otlphttp`. Currently it only supports the binary protobuf payloads. (#1420)
1732- Add an OpenCensus exporter bridge. (#1444)
1733
1734### Changed
1735
1736- Rename `internal/testing` to `internal/internaltest`. (#1449)
1737- Rename `export.SpanData` to `export.SpanSnapshot` and use it only for exporting spans. (#1360)
1738- Store the parent's full `SpanContext` rather than just its span ID in the `span` struct. (#1360)
1739- Improve span duration accuracy. (#1360)
1740- Migrated CI/CD from CircleCI to GitHub Actions (#1382)
1741- Remove duplicate checkout from GitHub Actions workflow (#1407)
1742- Metric `array` aggregator renamed `exact` to match its `aggregation.Kind` (#1412)
1743- Metric `exact` aggregator includes per-point timestamps (#1412)
1744- Metric stdout exporter uses MinMaxSumCount aggregator for ValueRecorder instruments (#1412)
1745- `NewExporter` from `exporters/otlp` now takes a `ProtocolDriver` as a parameter. (#1369)
1746- Many OTLP Exporter options became gRPC ProtocolDriver options. (#1369)
1747- Unify endpoint API that related to OTel exporter. (#1401)
1748- Optimize metric histogram aggregator to re-use its slice of buckets. (#1435)
1749- Metric aggregator Count() and histogram Bucket.Counts are consistently `uint64`. (1430)
1750- Histogram aggregator accepts functional options, uses default boundaries if none given. (#1434)
1751- `SamplingResult` now passed a `Tracestate` from the parent `SpanContext` (#1432)
1752- Moved gRPC driver for OTLP exporter to `exporters/otlp/otlpgrpc`. (#1420)
1753- The `TraceContext` propagator now correctly propagates `TraceState` through the `SpanContext`. (#1447)
1754- Metric Push and Pull Controller components are combined into a single "basic" Controller:
1755 - `WithExporter()` and `Start()` to configure Push behavior
1756 - `Start()` is optional; use `Collect()` and `ForEach()` for Pull behavior
1757 - `Start()` and `Stop()` accept Context. (#1378)
1758- The `Event` type is moved from the `otel/sdk/export/trace` package to the `otel/trace` API package. (#1452)
1759
1760### Removed
1761
1762- Remove `errUninitializedSpan` as its only usage is now obsolete. (#1360)
1763- Remove Metric export functionality related to quantiles and summary data points: this is not specified (#1412)
1764- Remove DDSketch metric aggregator; our intention is to re-introduce this as an option of the histogram aggregator after [new OTLP histogram data types](https://github.com/open-telemetry/opentelemetry-proto/pull/226) are released (#1412)
1765
1766### Fixed
1767
1768- `BatchSpanProcessor.Shutdown()` will now shutdown underlying `export.SpanExporter`. (#1443)
1769
1770## [0.15.0] - 2020-12-10
1771
1772### Added
1773
1774- The `WithIDGenerator` `TracerProviderOption` is added to the `go.opentelemetry.io/otel/trace` package to configure an `IDGenerator` for the `TracerProvider`. (#1363)
1775
1776### Changed
1777
1778- The Zipkin exporter now uses the Span status code to determine. (#1328)
1779- `NewExporter` and `Start` functions in `go.opentelemetry.io/otel/exporters/otlp` now receive `context.Context` as a first parameter. (#1357)
1780- Move the OpenCensus example into `example` directory. (#1359)
1781- Moved the SDK's `internal.IDGenerator` interface in to the `sdk/trace` package to enable support for externally-defined ID generators. (#1363)
1782- Bump `github.com/google/go-cmp` from 0.5.3 to 0.5.4 (#1374)
1783- Bump `github.com/golangci/golangci-lint` in `/internal/tools` (#1375)
1784
1785### Fixed
1786
1787- Metric SDK `SumObserver` and `UpDownSumObserver` instruments correctness fixes. (#1381)
1788
1789## [0.14.0] - 2020-11-19
1790
1791### Added
1792
1793- An `EventOption` and the related `NewEventConfig` function are added to the `go.opentelemetry.io/otel` package to configure Span events. (#1254)
1794- A `TextMapPropagator` and associated `TextMapCarrier` are added to the `go.opentelemetry.io/otel/oteltest` package to test `TextMap` type propagators and their use. (#1259)
1795- `SpanContextFromContext` returns `SpanContext` from context. (#1255)
1796- `TraceState` has been added to `SpanContext`. (#1340)
1797- `DeploymentEnvironmentKey` added to `go.opentelemetry.io/otel/semconv` package. (#1323)
1798- Add an OpenCensus to OpenTelemetry tracing bridge. (#1305)
1799- Add a parent context argument to `SpanProcessor.OnStart` to follow the specification. (#1333)
1800- Add missing tests for `sdk/trace/attributes_map.go`. (#1337)
1801
1802### Changed
1803
1804- Move the `go.opentelemetry.io/otel/api/trace` package into `go.opentelemetry.io/otel/trace` with the following changes. (#1229) (#1307)
1805 - `ID` has been renamed to `TraceID`.
1806 - `IDFromHex` has been renamed to `TraceIDFromHex`.
1807 - `EmptySpanContext` is removed.
1808- Move the `go.opentelemetry.io/otel/api/trace/tracetest` package into `go.opentelemetry.io/otel/oteltest`. (#1229)
1809- OTLP Exporter updates:
1810 - supports OTLP v0.6.0 (#1230, #1354)
1811 - supports configurable aggregation temporality (default: Cumulative, optional: Stateless). (#1296)
1812- The Sampler is now called on local child spans. (#1233)
1813- 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. (#1240)
1814- The `MetricKind` method of the `Descriptor` type in the `go.opentelemetry.io/otel/api/metric` package was renamed to `Descriptor.InstrumentKind`.
1815 This matches the returned type and fixes misuse of the term metric. (#1240)
1816- Move test harness from the `go.opentelemetry.io/otel/api/apitest` package into `go.opentelemetry.io/otel/oteltest`. (#1241)
1817- Move the `go.opentelemetry.io/otel/api/metric/metrictest` package into `go.opentelemetry.io/oteltest` as part of #964. (#1252)
1818- Move the `go.opentelemetry.io/otel/api/metric` package into `go.opentelemetry.io/otel/metric` as part of #1303. (#1321)
1819- Move the `go.opentelemetry.io/otel/api/metric/registry` package into `go.opentelemetry.io/otel/metric/registry` as a part of #1303. (#1316)
1820- 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 #1303. (#1316)
1821- 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 `EventOption`s. (#1254)
1822- 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 `EventOption`s. (#1254)
1823- Move the `go.opentelemetry.io/otel/api/global` package to `go.opentelemetry.io/otel`. (#1262) (#1330)
1824- Move the `Version` function from `go.opentelemetry.io/otel/sdk` to `go.opentelemetry.io/otel`. (#1330)
1825- Rename correlation context header from `"otcorrelations"` to `"baggage"` to match the OpenTelemetry specification. (#1267)
1826- Fix `Code.UnmarshalJSON` to work with valid JSON only. (#1276)
1827- The `resource.New()` method changes signature to support builtin attributes and functional options, including `telemetry.sdk.*` and
1828 `host.name` semantic conventions; the former method is renamed `resource.NewWithAttributes`. (#1235)
1829- The Prometheus exporter now exports non-monotonic counters (i.e. `UpDownCounter`s) as gauges. (#1210)
1830- Correct the `Span.End` method documentation in the `otel` API to state updates are not allowed on a span after it has ended. (#1310)
1831- Updated span collection limits for attribute, event and link counts to 1000 (#1318)
1832- Renamed `semconv.HTTPUrlKey` to `semconv.HTTPURLKey`. (#1338)
1833
1834### Removed
1835
1836- The `ErrInvalidHexID`, `ErrInvalidTraceIDLength`, `ErrInvalidSpanIDLength`, `ErrInvalidSpanIDLength`, or `ErrNilSpanID` from the `go.opentelemetry.io/otel` package are unexported now. (#1243)
1837- The `AddEventWithTimestamp` method on the `Span` interface in `go.opentelemetry.io/otel` is removed due to its redundancy.
1838 It is replaced by using the `AddEvent` method with a `WithTimestamp` option. (#1254)
1839- The `MockSpan` and `MockTracer` types are removed from `go.opentelemetry.io/otel/oteltest`.
1840 `Tracer` and `Span` from the same module should be used in their place instead. (#1306)
1841- `WorkerCount` option is removed from `go.opentelemetry.io/otel/exporters/otlp`. (#1350)
1842- Remove the following labels types: INT32, UINT32, UINT64 and FLOAT32. (#1314)
1843
1844### Fixed
1845
1846- Rename `MergeItererator` to `MergeIterator` in the `go.opentelemetry.io/otel/label` package. (#1244)
1847- The `go.opentelemetry.io/otel/api/global` packages global TextMapPropagator now delegates functionality to a globally set delegate for all previously returned propagators. (#1258)
1848- Fix condition in `label.Any`. (#1299)
1849- Fix global `TracerProvider` to pass options to its configured provider. (#1329)
1850- Fix missing handler for `ExactKind` aggregator in OTLP metrics transformer (#1309)
1851
1852## [0.13.0] - 2020-10-08
1853
1854### Added
1855
1856- OTLP Metric exporter supports Histogram aggregation. (#1209)
1857- The `Code` struct from the `go.opentelemetry.io/otel/codes` package now supports JSON marshaling and unmarshaling as well as implements the `Stringer` interface. (#1214)
1858- A Baggage API to implement the OpenTelemetry specification. (#1217)
1859- Add Shutdown method to sdk/trace/provider, shutdown processors in the order they were registered. (#1227)
1860
1861### Changed
1862
1863- Set default propagator to no-op propagator. (#1184)
1864- The `HTTPSupplier`, `HTTPExtractor`, `HTTPInjector`, and `HTTPPropagator` from the `go.opentelemetry.io/otel/api/propagation` package were replaced with unified `TextMapCarrier` and `TextMapPropagator` in the `go.opentelemetry.io/otel/propagation` package. (#1212) (#1325)
1865- The `New` function from the `go.opentelemetry.io/otel/api/propagation` package was replaced with `NewCompositeTextMapPropagator` in the `go.opentelemetry.io/otel` package. (#1212)
1866- The status codes of the `go.opentelemetry.io/otel/codes` package have been updated to match the latest OpenTelemetry specification.
1867 They now are `Unset`, `Error`, and `Ok`.
1868 They no longer track the gRPC codes. (#1214)
1869- The `StatusCode` field of the `SpanData` struct in the `go.opentelemetry.io/otel/sdk/export/trace` package now uses the codes package from this package instead of the gRPC project. (#1214)
1870- Move the `go.opentelemetry.io/otel/api/baggage` package into `go.opentelemetry.io/otel/baggage`. (#1217) (#1325)
1871- A `Shutdown` method of `SpanProcessor` and all its implementations receives a context and returns an error. (#1264)
1872
1873### Fixed
1874
1875- Copies of data from arrays and slices passed to `go.opentelemetry.io/otel/label.ArrayValue()` are now used in the returned `Value` instead of using the mutable data itself. (#1226)
1876
1877### Removed
1878
1879- The `ExtractHTTP` and `InjectHTTP` functions from the `go.opentelemetry.io/otel/api/propagation` package were removed. (#1212)
1880- The `Propagators` interface from the `go.opentelemetry.io/otel/api/propagation` package was removed to conform to the OpenTelemetry specification.
1881 The explicit `TextMapPropagator` type can be used in its place as this is the `Propagator` type the specification defines. (#1212)
1882- The `SetAttribute` method of the `Span` from the `go.opentelemetry.io/otel/api/trace` package was removed given its redundancy with the `SetAttributes` method. (#1216)
1883- The internal implementation of Baggage storage is removed in favor of using the new Baggage API functionality. (#1217)
1884- Remove duplicate hostname key `HostHostNameKey` in Resource semantic conventions. (#1219)
1885- Nested array/slice support has been removed. (#1226)
1886
1887## [0.12.0] - 2020-09-24
1888
1889### Added
1890
1891- A `SpanConfigure` function in `go.opentelemetry.io/otel/api/trace` to create a new `SpanConfig` from `SpanOption`s. (#1108)
1892- In the `go.opentelemetry.io/otel/api/trace` package, `NewTracerConfig` was added to construct new `TracerConfig`s.
1893 This addition was made to conform with our project option conventions. (#1155)
1894- Instrumentation library information was added to the Zipkin exporter. (#1119)
1895- The `SpanProcessor` interface now has a `ForceFlush()` method. (#1166)
1896- More semantic conventions for k8s as resource attributes. (#1167)
1897
1898### Changed
1899
1900- Add reconnecting udp connection type to Jaeger exporter.
1901 This change adds a new optional implementation of the udp conn interface used to detect changes to an agent's host dns record.
1902 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. (#1063)
1903- Replace `StartOption` and `EndOption` in `go.opentelemetry.io/otel/api/trace` with `SpanOption`.
1904 This change is matched by replacing the `StartConfig` and `EndConfig` with a unified `SpanConfig`. (#1108)
1905- Replace the `LinkedTo` span option in `go.opentelemetry.io/otel/api/trace` with `WithLinks`.
1906 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. (#1108)
1907- The `go.opentelemetry.io/otel/api/trace` `TracerOption` was changed to an interface to conform to project option conventions. (#1109)
1908- Move the `B3` and `TraceContext` from within the `go.opentelemetry.io/otel/api/trace` package to their own `go.opentelemetry.io/otel/propagators` package.
1909 This removal of the propagators is reflective of the OpenTelemetry specification for these propagators as well as cleans up the `go.opentelemetry.io/otel/api/trace` API. (#1118)
1910- Rename Jaeger tags used for instrumentation library information to reflect changes in OpenTelemetry specification. (#1119)
1911- Rename `ProbabilitySampler` to `TraceIDRatioBased` and change semantics to ignore parent span sampling status. (#1115)
1912- Move `tools` package under `internal`. (#1141)
1913- Move `go.opentelemetry.io/otel/api/correlation` package to `go.opentelemetry.io/otel/api/baggage`. (#1142)
1914 The `correlation.CorrelationContext` propagator has been renamed `baggage.Baggage`. Other exported functions and types are unchanged.
1915- Rename `ParentOrElse` sampler to `ParentBased` and allow setting samplers depending on parent span. (#1153)
1916- In the `go.opentelemetry.io/otel/api/trace` package, `SpanConfigure` was renamed to `NewSpanConfig`. (#1155)
1917- Change `dependabot.yml` to add a `Skip Changelog` label to dependabot-sourced PRs. (#1161)
1918- The [configuration style guide](https://github.com/open-telemetry/opentelemetry-go/blob/master/CONTRIBUTING.md#config) has been updated to
1919 recommend the use of `newConfig()` instead of `configure()`. (#1163)
1920- The `otlp.Config` type has been unexported and changed to `otlp.config`, along with its initializer. (#1163)
1921- Ensure exported interface types include parameter names and update the
1922 Style Guide to reflect this styling rule. (#1172)
1923- Don't consider unset environment variable for resource detection to be an error. (#1170)
1924- Rename `go.opentelemetry.io/otel/api/metric.ConfigureInstrument` to `NewInstrumentConfig` and
1925 `go.opentelemetry.io/otel/api/metric.ConfigureMeter` to `NewMeterConfig`.
1926- ValueObserver instruments use LastValue aggregator by default. (#1165)
1927- OTLP Metric exporter supports LastValue aggregation. (#1165)
1928- Move the `go.opentelemetry.io/otel/api/unit` package to `go.opentelemetry.io/otel/unit`. (#1185)
1929- Rename `Provider` to `MeterProvider` in the `go.opentelemetry.io/otel/api/metric` package. (#1190)
1930- Rename `NoopProvider` to `NoopMeterProvider` in the `go.opentelemetry.io/otel/api/metric` package. (#1190)
1931- Rename `NewProvider` to `NewMeterProvider` in the `go.opentelemetry.io/otel/api/metric/metrictest` package. (#1190)
1932- Rename `Provider` to `MeterProvider` in the `go.opentelemetry.io/otel/api/metric/registry` package. (#1190)
1933- Rename `NewProvider` to `NewMeterProvider` in the `go.opentelemetry.io/otel/api/metri/registryc` package. (#1190)
1934- Rename `Provider` to `TracerProvider` in the `go.opentelemetry.io/otel/api/trace` package. (#1190)
1935- Rename `NoopProvider` to `NoopTracerProvider` in the `go.opentelemetry.io/otel/api/trace` package. (#1190)
1936- Rename `Provider` to `TracerProvider` in the `go.opentelemetry.io/otel/api/trace/tracetest` package. (#1190)
1937- Rename `NewProvider` to `NewTracerProvider` in the `go.opentelemetry.io/otel/api/trace/tracetest` package. (#1190)
1938- Rename `WrapperProvider` to `WrapperTracerProvider` in the `go.opentelemetry.io/otel/bridge/opentracing` package. (#1190)
1939- Rename `NewWrapperProvider` to `NewWrapperTracerProvider` in the `go.opentelemetry.io/otel/bridge/opentracing` package. (#1190)
1940- Rename `Provider` method of the pull controller to `MeterProvider` in the `go.opentelemetry.io/otel/sdk/metric/controller/pull` package. (#1190)
1941- Rename `Provider` method of the push controller to `MeterProvider` in the `go.opentelemetry.io/otel/sdk/metric/controller/push` package. (#1190)
1942- Rename `ProviderOptions` to `TracerProviderConfig` in the `go.opentelemetry.io/otel/sdk/trace` package. (#1190)
1943- Rename `ProviderOption` to `TracerProviderOption` in the `go.opentelemetry.io/otel/sdk/trace` package. (#1190)
1944- Rename `Provider` to `TracerProvider` in the `go.opentelemetry.io/otel/sdk/trace` package. (#1190)
1945- Rename `NewProvider` to `NewTracerProvider` in the `go.opentelemetry.io/otel/sdk/trace` package. (#1190)
1946- Renamed `SamplingDecision` values to comply with OpenTelemetry specification change. (#1192)
1947- Renamed Zipkin attribute names from `ot.status_code & ot.status_description` to `otel.status_code & otel.status_description`. (#1201)
1948- The default SDK now invokes registered `SpanProcessor`s in the order they were registered with the `TracerProvider`. (#1195)
1949- Add test of spans being processed by the `SpanProcessor`s in the order they were registered. (#1203)
1950
1951### Removed
1952
1953- Remove the B3 propagator from `go.opentelemetry.io/otel/propagators`. It is now located in the
1954 `go.opentelemetry.io/contrib/propagators/` module. (#1191)
1955- Remove the semantic convention for HTTP status text, `HTTPStatusTextKey` from package `go.opentelemetry.io/otel/semconv`. (#1194)
1956
1957### Fixed
1958
1959- Zipkin example no longer mentions `ParentSampler`, corrected to `ParentBased`. (#1171)
1960- Fix missing shutdown processor in otel-collector example. (#1186)
1961- Fix missing shutdown processor in basic and namedtracer examples. (#1197)
1962
1963## [0.11.0] - 2020-08-24
1964
1965### Added
1966
1967- Support for exporting array-valued attributes via OTLP. (#992)
1968- `Noop` and `InMemory` `SpanBatcher` implementations to help with testing integrations. (#994)
1969- Support for filtering metric label sets. (#1047)
1970- A dimensionality-reducing metric Processor. (#1057)
1971- Integration tests for more OTel Collector Attribute types. (#1062)
1972- A new `WithSpanProcessor` `ProviderOption` is added to the `go.opentelemetry.io/otel/sdk/trace` package to create a `Provider` and automatically register the `SpanProcessor`. (#1078)
1973
1974### Changed
1975
1976- Rename `sdk/metric/processor/test` to `sdk/metric/processor/processortest`. (#1049)
1977- Rename `sdk/metric/controller/test` to `sdk/metric/controller/controllertest`. (#1049)
1978- Rename `api/testharness` to `api/apitest`. (#1049)
1979- Rename `api/trace/testtrace` to `api/trace/tracetest`. (#1049)
1980- Change Metric Processor to merge multiple observations. (#1024)
1981- The `go.opentelemetry.io/otel/bridge/opentracing` bridge package has been made into its own module.
1982 This removes the package dependencies of this bridge from the rest of the OpenTelemetry based project. (#1038)
1983- Renamed `go.opentelemetry.io/otel/api/standard` package to `go.opentelemetry.io/otel/semconv` to avoid the ambiguous and generic name `standard` and better describe the package as containing OpenTelemetry semantic conventions. (#1016)
1984- The environment variable used for resource detection has been changed from `OTEL_RESOURCE_LABELS` to `OTEL_RESOURCE_ATTRIBUTES` (#1042)
1985- Replace `WithSyncer` with `WithBatcher` in examples. (#1044)
1986- Replace the `google.golang.org/grpc/codes` dependency in the API with an equivalent `go.opentelemetry.io/otel/codes` package. (#1046)
1987- Merge the `go.opentelemetry.io/otel/api/label` and `go.opentelemetry.io/otel/api/kv` into the new `go.opentelemetry.io/otel/label` package. (#1060)
1988- Unify Callback Function Naming.
1989 Rename `*Callback` with `*Func`. (#1061)
1990- CI builds validate against last two versions of Go, dropping 1.13 and adding 1.15. (#1064)
1991- The `go.opentelemetry.io/otel/sdk/export/trace` interfaces `SpanSyncer` and `SpanBatcher` have been replaced with a specification compliant `Exporter` interface.
1992 This interface still supports the export of `SpanData`, but only as a slice.
1993 Implementation are also required now to return any error from `ExportSpans` if one occurs as well as implement a `Shutdown` method for exporter clean-up. (#1078)
1994- The `go.opentelemetry.io/otel/sdk/trace` `NewBatchSpanProcessor` function no longer returns an error.
1995 If a `nil` exporter is passed as an argument to this function, instead of it returning an error, it now returns a `BatchSpanProcessor` that handles the export of `SpanData` by not taking any action. (#1078)
1996- The `go.opentelemetry.io/otel/sdk/trace` `NewProvider` function to create a `Provider` no longer returns an error, instead only a `*Provider`.
1997 This change is related to `NewBatchSpanProcessor` not returning an error which was the only error this function would return. (#1078)
1998
1999### Removed
2000
2001- Duplicate, unused API sampler interface. (#999)
2002 Use the [`Sampler` interface](https://github.com/open-telemetry/opentelemetry-go/blob/v0.11.0/sdk/trace/sampling.go) provided by the SDK instead.
2003- The `grpctrace` instrumentation was moved to the `go.opentelemetry.io/contrib` repository and out of this repository.
2004 This move includes moving the `grpc` example to the `go.opentelemetry.io/contrib` as well. (#1027)
2005- The `WithSpan` method of the `Tracer` interface.
2006 The functionality this method provided was limited compared to what a user can provide themselves.
2007 It was removed with the understanding that if there is sufficient user need it can be added back based on actual user usage. (#1043)
2008- The `RegisterSpanProcessor` and `UnregisterSpanProcessor` functions.
2009 These were holdovers from an approach prior to the TracerProvider design. They were not used anymore. (#1077)
2010- The `oterror` package. (#1026)
2011- The `othttp` and `httptrace` instrumentations were moved to `go.opentelemetry.io/contrib`. (#1032)
2012
2013### Fixed
2014
2015- The `semconv.HTTPServerMetricAttributesFromHTTPRequest()` function no longer generates the high-cardinality `http.request.content.length` label. (#1031)
2016- Correct instrumentation version tag in Jaeger exporter. (#1037)
2017- The SDK span will now set an error event if the `End` method is called during a panic (i.e. it was deferred). (#1043)
2018- Move internally generated protobuf code from the `go.opentelemetry.io/otel` to the OTLP exporter to reduce dependency overhead. (#1050)
2019- The `otel-collector` example referenced outdated collector processors. (#1006)
2020
2021## [0.10.0] - 2020-07-29
2022
2023This release migrates the default OpenTelemetry SDK into its own Go module, decoupling the SDK from the API and reducing dependencies for instrumentation packages.
2024
2025### Added
2026
2027- The Zipkin exporter now has `NewExportPipeline` and `InstallNewPipeline` constructor functions to match the common pattern.
2028 These function build a new exporter with default SDK options and register the exporter with the `global` package respectively. (#944)
2029- Add propagator option for gRPC instrumentation. (#986)
2030- The `testtrace` package now tracks the `trace.SpanKind` for each span. (#987)
2031
2032### Changed
2033
2034- Replace the `RegisterGlobal` `Option` in the Jaeger exporter with an `InstallNewPipeline` constructor function.
2035 This matches the other exporter constructor patterns and will register a new exporter after building it with default configuration. (#944)
2036- The trace (`go.opentelemetry.io/otel/exporters/trace/stdout`) and metric (`go.opentelemetry.io/otel/exporters/metric/stdout`) `stdout` exporters are now merged into a single exporter at `go.opentelemetry.io/otel/exporters/stdout`.
2037 This new exporter was made into its own Go module to follow the pattern of all exporters and decouple it from the `go.opentelemetry.io/otel` module. (#956, #963)
2038- Move the `go.opentelemetry.io/otel/exporters/test` test package to `go.opentelemetry.io/otel/sdk/export/metric/metrictest`. (#962)
2039- The `go.opentelemetry.io/otel/api/kv/value` package was merged into the parent `go.opentelemetry.io/otel/api/kv` package. (#968)
2040 - `value.Bool` was replaced with `kv.BoolValue`.
2041 - `value.Int64` was replaced with `kv.Int64Value`.
2042 - `value.Uint64` was replaced with `kv.Uint64Value`.
2043 - `value.Float64` was replaced with `kv.Float64Value`.
2044 - `value.Int32` was replaced with `kv.Int32Value`.
2045 - `value.Uint32` was replaced with `kv.Uint32Value`.
2046 - `value.Float32` was replaced with `kv.Float32Value`.
2047 - `value.String` was replaced with `kv.StringValue`.
2048 - `value.Int` was replaced with `kv.IntValue`.
2049 - `value.Uint` was replaced with `kv.UintValue`.
2050 - `value.Array` was replaced with `kv.ArrayValue`.
2051- Rename `Infer` to `Any` in the `go.opentelemetry.io/otel/api/kv` package. (#972)
2052- Change `othttp` to use the `httpsnoop` package to wrap the `ResponseWriter` so that optional interfaces (`http.Hijacker`, `http.Flusher`, etc.) that are implemented by the original `ResponseWriter`are also implemented by the wrapped `ResponseWriter`. (#979)
2053- Rename `go.opentelemetry.io/otel/sdk/metric/aggregator/test` package to `go.opentelemetry.io/otel/sdk/metric/aggregator/aggregatortest`. (#980)
2054- Make the SDK into its own Go module called `go.opentelemetry.io/otel/sdk`. (#985)
2055- Changed the default trace `Sampler` from `AlwaysOn` to `ParentOrElse(AlwaysOn)`. (#989)
2056
2057### Removed
2058
2059- The `IndexedAttribute` function from the `go.opentelemetry.io/otel/api/label` package was removed in favor of `IndexedLabel` which it was synonymous with. (#970)
2060
2061### Fixed
2062
2063- Bump github.com/golangci/golangci-lint from 1.28.3 to 1.29.0 in /tools. (#953)
2064- Bump github.com/google/go-cmp from 0.5.0 to 0.5.1. (#957)
2065- Use `global.Handle` for span export errors in the OTLP exporter. (#946)
2066- Correct Go language formatting in the README documentation. (#961)
2067- Remove default SDK dependencies from the `go.opentelemetry.io/otel/api` package. (#977)
2068- Remove default SDK dependencies from the `go.opentelemetry.io/otel/instrumentation` package. (#983)
2069- Move documented examples for `go.opentelemetry.io/otel/instrumentation/grpctrace` interceptors into Go example tests. (#984)
2070
2071## [0.9.0] - 2020-07-20
2072
2073### Added
2074
2075- A new Resource Detector interface is included to allow resources to be automatically detected and included. (#939)
2076- A Detector to automatically detect resources from an environment variable. (#939)
2077- Github action to generate protobuf Go bindings locally in `internal/opentelemetry-proto-gen`. (#938)
2078- OTLP .proto files from `open-telemetry/opentelemetry-proto` imported as a git submodule under `internal/opentelemetry-proto`.
2079 References to `github.com/open-telemetry/opentelemetry-proto` changed to `go.opentelemetry.io/otel/internal/opentelemetry-proto-gen`. (#942)
2080
2081### Changed
2082
2083- Non-nil value `struct`s for key-value pairs will be marshalled using JSON rather than `Sprintf`. (#948)
2084
2085### Removed
2086
2087- Removed dependency on `github.com/open-telemetry/opentelemetry-collector`. (#943)
2088
2089## [0.8.0] - 2020-07-09
2090
2091### Added
2092
2093- The `B3Encoding` type to represent the B3 encoding(s) the B3 propagator can inject.
2094 A value for HTTP supported encodings (Multiple Header: `MultipleHeader`, Single Header: `SingleHeader`) are included. (#882)
2095- The `FlagsDeferred` trace flag to indicate if the trace sampling decision has been deferred. (#882)
2096- The `FlagsDebug` trace flag to indicate if the trace is a debug trace. (#882)
2097- Add `peer.service` semantic attribute. (#898)
2098- Add database-specific semantic attributes. (#899)
2099- Add semantic convention for `faas.coldstart` and `container.id`. (#909)
2100- Add http content size semantic conventions. (#905)
2101- Include `http.request_content_length` in HTTP request basic attributes. (#905)
2102- Add semantic conventions for operating system process resource attribute keys. (#919)
2103- The Jaeger exporter now has a `WithBatchMaxCount` option to specify the maximum number of spans sent in a batch. (#931)
2104
2105### Changed
2106
2107- Update `CONTRIBUTING.md` to ask for updates to `CHANGELOG.md` with each pull request. (#879)
2108- Use lowercase header names for B3 Multiple Headers. (#881)
2109- The B3 propagator `SingleHeader` field has been replaced with `InjectEncoding`.
2110 This new field can be set to combinations of the `B3Encoding` bitmasks and will inject trace information in these encodings.
2111 If no encoding is set, the propagator will default to `MultipleHeader` encoding. (#882)
2112- The B3 propagator now extracts from either HTTP encoding of B3 (Single Header or Multiple Header) based on what is contained in the header.
2113 Preference is given to Single Header encoding with Multiple Header being the fallback if Single Header is not found or is invalid.
2114 This behavior change is made to dynamically support all correctly encoded traces received instead of having to guess the expected encoding prior to receiving. (#882)
2115- Extend semantic conventions for RPC. (#900)
2116- To match constant naming conventions in the `api/standard` package, the `FaaS*` key names are appended with a suffix of `Key`. (#920)
2117 - `"api/standard".FaaSName` -> `FaaSNameKey`
2118 - `"api/standard".FaaSID` -> `FaaSIDKey`
2119 - `"api/standard".FaaSVersion` -> `FaaSVersionKey`
2120 - `"api/standard".FaaSInstance` -> `FaaSInstanceKey`
2121
2122### Removed
2123
2124- The `FlagsUnused` trace flag is removed.
2125 The purpose of this flag was to act as the inverse of `FlagsSampled`, the inverse of `FlagsSampled` is used instead. (#882)
2126- The B3 header constants (`B3SingleHeader`, `B3DebugFlagHeader`, `B3TraceIDHeader`, `B3SpanIDHeader`, `B3SampledHeader`, `B3ParentSpanIDHeader`) are removed.
2127 If B3 header keys are needed [the authoritative OpenZipkin package constants](https://pkg.go.dev/github.com/openzipkin/zipkin-go@v0.2.2/propagation/b3?tab=doc#pkg-constants) should be used instead. (#882)
2128
2129### Fixed
2130
2131- The B3 Single Header name is now correctly `b3` instead of the previous `X-B3`. (#881)
2132- The B3 propagator now correctly supports sampling only values (`b3: 0`, `b3: 1`, or `b3: d`) for a Single B3 Header. (#882)
2133- The B3 propagator now propagates the debug flag.
2134 This removes the behavior of changing the debug flag into a set sampling bit.
2135 Instead, this now follow the B3 specification and omits the `X-B3-Sampling` header. (#882)
2136- The B3 propagator now tracks "unset" sampling state (meaning "defer the decision") and does not set the `X-B3-Sampling` header when injecting. (#882)
2137- Bump github.com/itchyny/gojq from 0.10.3 to 0.10.4 in /tools. (#883)
2138- Bump github.com/opentracing/opentracing-go from v1.1.1-0.20190913142402-a7454ce5950e to v1.2.0. (#885)
2139- The tracing time conversion for OTLP spans is now correctly set to `UnixNano`. (#896)
2140- Ensure span status is not set to `Unknown` when no HTTP status code is provided as it is assumed to be `200 OK`. (#908)
2141- Ensure `httptrace.clientTracer` closes `http.headers` span. (#912)
2142- Prometheus exporter will not apply stale updates or forget inactive metrics. (#903)
2143- Add test for api.standard `HTTPClientAttributesFromHTTPRequest`. (#905)
2144- Bump github.com/golangci/golangci-lint from 1.27.0 to 1.28.1 in /tools. (#901, #913)
2145- Update otel-colector example to use the v0.5.0 collector. (#915)
2146- The `grpctrace` instrumentation uses a span name conforming to the OpenTelemetry semantic conventions (does not contain a leading slash (`/`)). (#922)
2147- The `grpctrace` instrumentation includes an `rpc.method` attribute now set to the gRPC method name. (#900, #922)
2148- The `grpctrace` instrumentation `rpc.service` attribute now contains the package name if one exists.
2149 This is in accordance with OpenTelemetry semantic conventions. (#922)
2150- Correlation Context extractor will no longer insert an empty map into the returned context when no valid values are extracted. (#923)
2151- Bump google.golang.org/api from 0.28.0 to 0.29.0 in /exporters/trace/jaeger. (#925)
2152- Bump github.com/itchyny/gojq from 0.10.4 to 0.11.0 in /tools. (#926)
2153- Bump github.com/golangci/golangci-lint from 1.28.1 to 1.28.2 in /tools. (#930)
2154
2155## [0.7.0] - 2020-06-26
2156
2157This release implements the v0.5.0 version of the OpenTelemetry specification.
2158
2159### Added
2160
2161- The othttp instrumentation now includes default metrics. (#861)
2162- This CHANGELOG file to track all changes in the project going forward.
2163- Support for array type attributes. (#798)
2164- Apply transitive dependabot go.mod dependency updates as part of a new automatic Github workflow. (#844)
2165- Timestamps are now passed to exporters for each export. (#835)
2166- Add new `Accumulation` type to metric SDK to transport telemetry from `Accumulator`s to `Processor`s.
2167 This replaces the prior `Record` `struct` use for this purpose. (#835)
2168- New dependabot integration to automate package upgrades. (#814)
2169- `Meter` and `Tracer` implementations accept instrumentation version version as an optional argument.
2170 This instrumentation version is passed on to exporters. (#811) (#805) (#802)
2171- The OTLP exporter includes the instrumentation version in telemetry it exports. (#811)
2172- Environment variables for Jaeger exporter are supported. (#796)
2173- New `aggregation.Kind` in the export metric API. (#808)
2174- New example that uses OTLP and the collector. (#790)
2175- Handle errors in the span `SetName` during span initialization. (#791)
2176- Default service config to enable retries for retry-able failed requests in the OTLP exporter and an option to override this default. (#777)
2177- New `go.opentelemetry.io/otel/api/oterror` package to uniformly support error handling and definitions for the project. (#778)
2178- New `global` default implementation of the `go.opentelemetry.io/otel/api/oterror.Handler` interface to be used to handle errors prior to an user defined `Handler`.
2179 There is also functionality for the user to register their `Handler` as well as a convenience function `Handle` to handle an error with this global `Handler`(#778)
2180- Options to specify propagators for httptrace and grpctrace instrumentation. (#784)
2181- The required `application/json` header for the Zipkin exporter is included in all exports. (#774)
2182- Integrate HTTP semantics helpers from the contrib repository into the `api/standard` package. #769
2183
2184### Changed
2185
2186- Rename `Integrator` to `Processor` in the metric SDK. (#863)
2187- Rename `AggregationSelector` to `AggregatorSelector`. (#859)
2188- Rename `SynchronizedCopy` to `SynchronizedMove`. (#858)
2189- Rename `simple` integrator to `basic` integrator. (#857)
2190- Merge otlp collector examples. (#841)
2191- Change the metric SDK to support cumulative, delta, and pass-through exporters directly.
2192 With these changes, cumulative and delta specific exporters are able to request the correct kind of aggregation from the SDK. (#840)
2193- The `Aggregator.Checkpoint` API is renamed to `SynchronizedCopy` and adds an argument, a different `Aggregator` into which the copy is stored. (#812)
2194- The `export.Aggregator` contract is that `Update()` and `SynchronizedCopy()` are synchronized with each other.
2195 All the aggregation interfaces (`Sum`, `LastValue`, ...) are not meant to be synchronized, as the caller is expected to synchronize aggregators at a higher level after the `Accumulator`.
2196 Some of the `Aggregators` used unnecessary locking and that has been cleaned up. (#812)
2197- Use of `metric.Number` was replaced by `int64` now that we use `sync.Mutex` in the `MinMaxSumCount` and `Histogram` `Aggregators`. (#812)
2198- Replace `AlwaysParentSample` with `ParentSample(fallback)` to match the OpenTelemetry v0.5.0 specification. (#810)
2199- Rename `sdk/export/metric/aggregator` to `sdk/export/metric/aggregation`. #808
2200- Send configured headers with every request in the OTLP exporter, instead of just on connection creation. (#806)
2201- Update error handling for any one off error handlers, replacing, instead, with the `global.Handle` function. (#791)
2202- Rename `plugin` directory to `instrumentation` to match the OpenTelemetry specification. (#779)
2203- Makes the argument order to Histogram and DDSketch `New()` consistent. (#781)
2204
2205### Removed
2206
2207- `Uint64NumberKind` and related functions from the API. (#864)
2208- Context arguments from `Aggregator.Checkpoint` and `Integrator.Process` as they were unused. (#803)
2209- `SpanID` is no longer included in parameters for sampling decision to match the OpenTelemetry specification. (#775)
2210
2211### Fixed
2212
2213- Upgrade OTLP exporter to opentelemetry-proto matching the opentelemetry-collector v0.4.0 release. (#866)
2214- Allow changes to `go.sum` and `go.mod` when running dependabot tidy-up. (#871)
2215- Bump github.com/stretchr/testify from 1.4.0 to 1.6.1. (#824)
2216- Bump github.com/prometheus/client_golang from 1.7.0 to 1.7.1 in /exporters/metric/prometheus. (#867)
2217- Bump google.golang.org/grpc from 1.29.1 to 1.30.0 in /exporters/trace/jaeger. (#853)
2218- Bump google.golang.org/grpc from 1.29.1 to 1.30.0 in /exporters/trace/zipkin. (#854)
2219- Bumps github.com/golang/protobuf from 1.3.2 to 1.4.2 (#848)
2220- Bump github.com/stretchr/testify from 1.4.0 to 1.6.1 in /exporters/otlp (#817)
2221- Bump github.com/golangci/golangci-lint from 1.25.1 to 1.27.0 in /tools (#828)
2222- Bump github.com/prometheus/client_golang from 1.5.0 to 1.7.0 in /exporters/metric/prometheus (#838)
2223- Bump github.com/stretchr/testify from 1.4.0 to 1.6.1 in /exporters/trace/jaeger (#829)
2224- Bump github.com/benbjohnson/clock from 1.0.0 to 1.0.3 (#815)
2225- Bump github.com/stretchr/testify from 1.4.0 to 1.6.1 in /exporters/trace/zipkin (#823)
2226- Bump github.com/itchyny/gojq from 0.10.1 to 0.10.3 in /tools (#830)
2227- Bump github.com/stretchr/testify from 1.4.0 to 1.6.1 in /exporters/metric/prometheus (#822)
2228- Bump google.golang.org/grpc from 1.27.1 to 1.29.1 in /exporters/trace/zipkin (#820)
2229- Bump google.golang.org/grpc from 1.27.1 to 1.29.1 in /exporters/trace/jaeger (#831)
2230- Bump github.com/google/go-cmp from 0.4.0 to 0.5.0 (#836)
2231- Bump github.com/google/go-cmp from 0.4.0 to 0.5.0 in /exporters/trace/jaeger (#837)
2232- Bump github.com/google/go-cmp from 0.4.0 to 0.5.0 in /exporters/otlp (#839)
2233- Bump google.golang.org/api from 0.20.0 to 0.28.0 in /exporters/trace/jaeger (#843)
2234- Set span status from HTTP status code in the othttp instrumentation. (#832)
2235- Fixed typo in push controller comment. (#834)
2236- The `Aggregator` testing has been updated and cleaned. (#812)
2237- `metric.Number(0)` expressions are replaced by `0` where possible. (#812)
2238- Fixed `global` `handler_test.go` test failure. #804
2239- Fixed `BatchSpanProcessor.Shutdown` to wait until all spans are processed. (#766)
2240- Fixed OTLP example's accidental early close of exporter. (#807)
2241- Ensure zipkin exporter reads and closes response body. (#788)
2242- Update instrumentation to use `api/standard` keys instead of custom keys. (#782)
2243- Clean up tools and RELEASING documentation. (#762)
2244
2245## [0.6.0] - 2020-05-21
2246
2247### Added
2248
2249- Support for `Resource`s in the prometheus exporter. (#757)
2250- New pull controller. (#751)
2251- New `UpDownSumObserver` instrument. (#750)
2252- OpenTelemetry collector demo. (#711)
2253- New `SumObserver` instrument. (#747)
2254- New `UpDownCounter` instrument. (#745)
2255- New timeout `Option` and configuration function `WithTimeout` to the push controller. (#742)
2256- New `api/standards` package to implement semantic conventions and standard key-value generation. (#731)
2257
2258### Changed
2259
2260- Rename `Register*` functions in the metric API to `New*` for all `Observer` instruments. (#761)
2261- Use `[]float64` for histogram boundaries, not `[]metric.Number`. (#758)
2262- Change OTLP example to use exporter as a trace `Syncer` instead of as an unneeded `Batcher`. (#756)
2263- Replace `WithResourceAttributes()` with `WithResource()` in the trace SDK. (#754)
2264- The prometheus exporter now uses the new pull controller. (#751)
2265- Rename `ScheduleDelayMillis` to `BatchTimeout` in the trace `BatchSpanProcessor`.(#752)
2266- Support use of synchronous instruments in asynchronous callbacks (#725)
2267- Move `Resource` from the `Export` method parameter into the metric export `Record`. (#739)
2268- Rename `Observer` instrument to `ValueObserver`. (#734)
2269- The push controller now has a method (`Provider()`) to return a `metric.Provider` instead of the old `Meter` method that acted as a `metric.Provider`. (#738)
2270- Replace `Measure` instrument by `ValueRecorder` instrument. (#732)
2271- Rename correlation context header from `"Correlation-Context"` to `"otcorrelations"` to match the OpenTelemetry specification. (#727)
2272
2273### Fixed
2274
2275- Ensure gRPC `ClientStream` override methods do not panic in grpctrace package. (#755)
2276- Disable parts of `BatchSpanProcessor` test until a fix is found. (#743)
2277- Fix `string` case in `kv` `Infer` function. (#746)
2278- Fix panic in grpctrace client interceptors. (#740)
2279- Refactor the `api/metrics` push controller and add `CheckpointSet` synchronization. (#737)
2280- Rewrite span batch process queue batching logic. (#719)
2281- Remove the push controller named Meter map. (#738)
2282- Fix Histogram aggregator initial state (fix #735). (#736)
2283- Ensure golang alpine image is running `golang-1.14` for examples. (#733)
2284- Added test for grpctrace `UnaryInterceptorClient`. (#695)
2285- Rearrange `api/metric` code layout. (#724)
2286
2287## [0.5.0] - 2020-05-13
2288
2289### Added
2290
2291- Batch `Observer` callback support. (#717)
2292- Alias `api` types to root package of project. (#696)
2293- Create basic `othttp.Transport` for simple client instrumentation. (#678)
2294- `SetAttribute(string, interface{})` to the trace API. (#674)
2295- Jaeger exporter option that allows user to specify custom http client. (#671)
2296- `Stringer` and `Infer` methods to `key`s. (#662)
2297
2298### Changed
2299
2300- Rename `NewKey` in the `kv` package to just `Key`. (#721)
2301- Move `core` and `key` to `kv` package. (#720)
2302- Make the metric API `Meter` a `struct` so the abstract `MeterImpl` can be passed and simplify implementation. (#709)
2303- Rename SDK `Batcher` to `Integrator` to match draft OpenTelemetry SDK specification. (#710)
2304- Rename SDK `Ungrouped` integrator to `simple.Integrator` to match draft OpenTelemetry SDK specification. (#710)
2305- Rename SDK `SDK` `struct` to `Accumulator` to match draft OpenTelemetry SDK specification. (#710)
2306- Move `Number` from `core` to `api/metric` package. (#706)
2307- Move `SpanContext` from `core` to `trace` package. (#692)
2308- Change traceparent header from `Traceparent` to `traceparent` to implement the W3C specification. (#681)
2309
2310### Fixed
2311
2312- Update tooling to run generators in all submodules. (#705)
2313- gRPC interceptor regexp to match methods without a service name. (#683)
2314- Use a `const` for padding 64-bit B3 trace IDs. (#701)
2315- Update `mockZipkin` listen address from `:0` to `127.0.0.1:0`. (#700)
2316- Left-pad 64-bit B3 trace IDs with zero. (#698)
2317- Propagate at least the first W3C tracestate header. (#694)
2318- Remove internal `StateLocker` implementation. (#688)
2319- Increase instance size CI system uses. (#690)
2320- Add a `key` benchmark and use reflection in `key.Infer()`. (#679)
2321- Fix internal `global` test by using `global.Meter` with `RecordBatch()`. (#680)
2322- Reimplement histogram using mutex instead of `StateLocker`. (#669)
2323- Switch `MinMaxSumCount` to a mutex lock implementation instead of `StateLocker`. (#667)
2324- Update documentation to not include any references to `WithKeys`. (#672)
2325- Correct misspelling. (#668)
2326- Fix clobbering of the span context if extraction fails. (#656)
2327- Bump `golangci-lint` and work around the corrupting bug. (#666) (#670)
2328
2329## [0.4.3] - 2020-04-24
2330
2331### Added
2332
2333- `Dockerfile` and `docker-compose.yml` to run example code. (#635)
2334- New `grpctrace` package that provides gRPC client and server interceptors for both unary and stream connections. (#621)
2335- New `api/label` package, providing common label set implementation. (#651)
2336- Support for JSON marshaling of `Resources`. (#654)
2337- `TraceID` and `SpanID` implementations for `Stringer` interface. (#642)
2338- `RemoteAddrKey` in the othttp plugin to include the HTTP client address in top-level spans. (#627)
2339- `WithSpanFormatter` option to the othttp plugin. (#617)
2340- Updated README to include section for compatible libraries and include reference to the contrib repository. (#612)
2341- The prometheus exporter now supports exporting histograms. (#601)
2342- A `String` method to the `Resource` to return a hashable identifier for a now unique resource. (#613)
2343- An `Iter` method to the `Resource` to return an array `AttributeIterator`. (#613)
2344- An `Equal` method to the `Resource` test the equivalence of resources. (#613)
2345- An iterable structure (`AttributeIterator`) for `Resource` attributes.
2346
2347### Changed
2348
2349- zipkin export's `NewExporter` now requires a `serviceName` argument to ensure this needed values is provided. (#644)
2350- Pass `Resources` through the metrics export pipeline. (#659)
2351
2352### Removed
2353
2354- `WithKeys` option from the metric API. (#639)
2355
2356### Fixed
2357
2358- Use the `label.Set.Equivalent` value instead of an encoding in the batcher. (#658)
2359- Correct typo `trace.Exporter` to `trace.SpanSyncer` in comments. (#653)
2360- Use type names for return values in jaeger exporter. (#648)
2361- Increase the visibility of the `api/key` package by updating comments and fixing usages locally. (#650)
2362- `Checkpoint` only after `Update`; Keep records in the `sync.Map` longer. (#647)
2363- Do not cache `reflect.ValueOf()` in metric Labels. (#649)
2364- Batch metrics exported from the OTLP exporter based on `Resource` and labels. (#626)
2365- Add error wrapping to the prometheus exporter. (#631)
2366- Update the OTLP exporter batching of traces to use a unique `string` representation of an associated `Resource` as the batching key. (#623)
2367- Update OTLP `SpanData` transform to only include the `ParentSpanID` if one exists. (#614)
2368- Update `Resource` internal representation to uniquely and reliably identify resources. (#613)
2369- Check return value from `CheckpointSet.ForEach` in prometheus exporter. (#622)
2370- Ensure spans created by httptrace client tracer reflect operation structure. (#618)
2371- Create a new recorder rather than reuse when multiple observations in same epoch for asynchronous instruments. #610
2372- The default port the OTLP exporter uses to connect to the OpenTelemetry collector is updated to match the one the collector listens on by default. (#611)
2373
2374## [0.4.2] - 2020-03-31
2375
2376### Fixed
2377
2378- Fix `pre_release.sh` to update version in `sdk/opentelemetry.go`. (#607)
2379- Fix time conversion from internal to OTLP in OTLP exporter. (#606)
2380
2381## [0.4.1] - 2020-03-31
2382
2383### Fixed
2384
2385- Update `tag.sh` to create signed tags. (#604)
2386
2387## [0.4.0] - 2020-03-30
2388
2389### Added
2390
2391- New API package `api/metric/registry` that exposes a `MeterImpl` wrapper for use by SDKs to generate unique instruments. (#580)
2392- Script to verify examples after a new release. (#579)
2393
2394### Removed
2395
2396- The dogstatsd exporter due to lack of support.
2397 This additionally removes support for statsd. (#591)
2398- `LabelSet` from the metric API.
2399 This is replaced by a `[]core.KeyValue` slice. (#595)
2400- `Labels` from the metric API's `Meter` interface. (#595)
2401
2402### Changed
2403
2404- The metric `export.Labels` became an interface which the SDK implements and the `export` package provides a simple, immutable implementation of this interface intended for testing purposes. (#574)
2405- Renamed `internal/metric.Meter` to `MeterImpl`. (#580)
2406- Renamed `api/global/internal.obsImpl` to `asyncImpl`. (#580)
2407
2408### Fixed
2409
2410- Corrected missing return in mock span. (#582)
2411- Update License header for all source files to match CNCF guidelines and include a test to ensure it is present. (#586) (#596)
2412- Update to v0.3.0 of the OTLP in the OTLP exporter. (#588)
2413- Update pre-release script to be compatible between GNU and BSD based systems. (#592)
2414- Add a `RecordBatch` benchmark. (#594)
2415- Moved span transforms of the OTLP exporter to the internal package. (#593)
2416- Build both go-1.13 and go-1.14 in circleci to test for all supported versions of Go. (#569)
2417- Removed unneeded allocation on empty labels in OLTP exporter. (#597)
2418- Update `BatchedSpanProcessor` to process the queue until no data but respect max batch size. (#599)
2419- Update project documentation godoc.org links to pkg.go.dev. (#602)
2420
2421## [0.3.0] - 2020-03-21
2422
2423This is a first official beta release, which provides almost fully complete metrics, tracing, and context propagation functionality.
2424There is still a possibility of breaking changes.
2425
2426### Added
2427
2428- Add `Observer` metric instrument. (#474)
2429- Add global `Propagators` functionality to enable deferred initialization for propagators registered before the first Meter SDK is installed. (#494)
2430- Simplified export setup pipeline for the jaeger exporter to match other exporters. (#459)
2431- The zipkin trace exporter. (#495)
2432- The OTLP exporter to export metric and trace telemetry to the OpenTelemetry collector. (#497) (#544) (#545)
2433- Add `StatusMessage` field to the trace `Span`. (#524)
2434- Context propagation in OpenTracing bridge in terms of OpenTelemetry context propagation. (#525)
2435- The `Resource` type was added to the SDK. (#528)
2436- The global API now supports a `Tracer` and `Meter` function as shortcuts to getting a global `*Provider` and calling these methods directly. (#538)
2437- The metric API now defines a generic `MeterImpl` interface to support general purpose `Meter` construction.
2438 Additionally, `SyncImpl` and `AsyncImpl` are added to support general purpose instrument construction. (#560)
2439- A metric `Kind` is added to represent the `MeasureKind`, `ObserverKind`, and `CounterKind`. (#560)
2440- Scripts to better automate the release process. (#576)
2441
2442### Changed
2443
2444- Default to to use `AlwaysSampler` instead of `ProbabilitySampler` to match OpenTelemetry specification. (#506)
2445- Renamed `AlwaysSampleSampler` to `AlwaysOnSampler` in the trace API. (#511)
2446- Renamed `NeverSampleSampler` to `AlwaysOffSampler` in the trace API. (#511)
2447- The `Status` field of the `Span` was changed to `StatusCode` to disambiguate with the added `StatusMessage`. (#524)
2448- Updated the trace `Sampler` interface conform to the OpenTelemetry specification. (#531)
2449- Rename metric API `Options` to `Config`. (#541)
2450- Rename metric `Counter` aggregator to be `Sum`. (#541)
2451- Unify metric options into `Option` from instrument specific options. (#541)
2452- The trace API's `TraceProvider` now support `Resource`s. (#545)
2453- Correct error in zipkin module name. (#548)
2454- The jaeger trace exporter now supports `Resource`s. (#551)
2455- Metric SDK now supports `Resource`s.
2456 The `WithResource` option was added to configure a `Resource` on creation and the `Resource` method was added to the metric `Descriptor` to return the associated `Resource`. (#552)
2457- Replace `ErrNoLastValue` and `ErrEmptyDataSet` by `ErrNoData` in the metric SDK. (#557)
2458- The stdout trace exporter now supports `Resource`s. (#558)
2459- The metric `Descriptor` is now included at the API instead of the SDK. (#560)
2460- Replace `Ordered` with an iterator in `export.Labels`. (#567)
2461
2462### Removed
2463
2464- The vendor specific Stackdriver. It is now hosted on 3rd party vendor infrastructure. (#452)
2465- The `Unregister` method for metric observers as it is not in the OpenTelemetry specification. (#560)
2466- `GetDescriptor` from the metric SDK. (#575)
2467- The `Gauge` instrument from the metric API. (#537)
2468
2469### Fixed
2470
2471- Make histogram aggregator checkpoint consistent. (#438)
2472- Update README with import instructions and how to build and test. (#505)
2473- The default label encoding was updated to be unique. (#508)
2474- Use `NewRoot` in the othttp plugin for public endpoints. (#513)
2475- Fix data race in `BatchedSpanProcessor`. (#518)
2476- Skip test-386 for Mac OS 10.15.x (Catalina and upwards). #521
2477- Use a variable-size array to represent ordered labels in maps. (#523)
2478- Update the OTLP protobuf and update changed import path. (#532)
2479- Use `StateLocker` implementation in `MinMaxSumCount`. (#546)
2480- Eliminate goroutine leak in histogram stress test. (#547)
2481- Update OTLP exporter with latest protobuf. (#550)
2482- Add filters to the othttp plugin. (#556)
2483- Provide an implementation of the `Header*` filters that do not depend on Go 1.14. (#565)
2484- Encode labels once during checkpoint.
2485 The checkpoint function is executed in a single thread so we can do the encoding lazily before passing the encoded version of labels to the exporter.
2486 This is a cheap and quick way to avoid encoding the labels on every collection interval. (#572)
2487- Run coverage over all packages in `COVERAGE_MOD_DIR`. (#573)
2488
2489## [0.2.3] - 2020-03-04
2490
2491### Added
2492
2493- `RecordError` method on `Span`s in the trace API to Simplify adding error events to spans. (#473)
2494- Configurable push frequency for exporters setup pipeline. (#504)
2495
2496### Changed
2497
2498- Rename the `exporter` directory to `exporters`.
2499 The `go.opentelemetry.io/otel/exporter/trace/jaeger` package was mistakenly released with a `v1.0.0` tag instead of `v0.1.0`.
2500 This resulted in all subsequent releases not becoming the default latest.
2501 A consequence of this was that all `go get`s pulled in the incompatible `v0.1.0` release of that package when pulling in more recent packages from other otel packages.
2502 Renaming the `exporter` directory to `exporters` fixes this issue by renaming the package and therefore clearing any existing dependency tags.
2503 Consequentially, this action also renames *all* exporter packages. (#502)
2504
2505### Removed
2506
2507- The `CorrelationContextHeader` constant in the `correlation` package is no longer exported. (#503)
2508
2509## [0.2.2] - 2020-02-27
2510
2511### Added
2512
2513- `HTTPSupplier` interface in the propagation API to specify methods to retrieve and store a single value for a key to be associated with a carrier. (#467)
2514- `HTTPExtractor` interface in the propagation API to extract information from an `HTTPSupplier` into a context. (#467)
2515- `HTTPInjector` interface in the propagation API to inject information into an `HTTPSupplier.` (#467)
2516- `Config` and configuring `Option` to the propagator API. (#467)
2517- `Propagators` interface in the propagation API to contain the set of injectors and extractors for all supported carrier formats. (#467)
2518- `HTTPPropagator` interface in the propagation API to inject and extract from an `HTTPSupplier.` (#467)
2519- `WithInjectors` and `WithExtractors` functions to the propagator API to configure injectors and extractors to use. (#467)
2520- `ExtractHTTP` and `InjectHTTP` functions to apply configured HTTP extractors and injectors to a passed context. (#467)
2521- Histogram aggregator. (#433)
2522- `DefaultPropagator` function and have it return `trace.TraceContext` as the default context propagator. (#456)
2523- `AlwaysParentSample` sampler to the trace API. (#455)
2524- `WithNewRoot` option function to the trace API to specify the created span should be considered a root span. (#451)
2525
2526### Changed
2527
2528- Renamed `WithMap` to `ContextWithMap` in the correlation package. (#481)
2529- Renamed `FromContext` to `MapFromContext` in the correlation package. (#481)
2530- Move correlation context propagation to correlation package. (#479)
2531- Do not default to putting remote span context into links. (#480)
2532- `Tracer.WithSpan` updated to accept `StartOptions`. (#472)
2533- Renamed `MetricKind` to `Kind` to not stutter in the type usage. (#432)
2534- Renamed the `export` package to `metric` to match directory structure. (#432)
2535- Rename the `api/distributedcontext` package to `api/correlation`. (#444)
2536- Rename the `api/propagators` package to `api/propagation`. (#444)
2537- Move the propagators from the `propagators` package into the `trace` API package. (#444)
2538- Update `Float64Gauge`, `Int64Gauge`, `Float64Counter`, `Int64Counter`, `Float64Measure`, and `Int64Measure` metric methods to use value receivers instead of pointers. (#462)
2539- Moved all dependencies of tools package to a tools directory. (#466)
2540
2541### Removed
2542
2543- Binary propagators. (#467)
2544- NOOP propagator. (#467)
2545
2546### Fixed
2547
2548- Upgraded `github.com/golangci/golangci-lint` from `v1.21.0` to `v1.23.6` in `tools/`. (#492)
2549- Fix a possible nil-dereference crash (#478)
2550- Correct comments for `InstallNewPipeline` in the stdout exporter. (#483)
2551- Correct comments for `InstallNewPipeline` in the dogstatsd exporter. (#484)
2552- Correct comments for `InstallNewPipeline` in the prometheus exporter. (#482)
2553- Initialize `onError` based on `Config` in prometheus exporter. (#486)
2554- Correct module name in prometheus exporter README. (#475)
2555- Removed tracer name prefix from span names. (#430)
2556- Fix `aggregator_test.go` import package comment. (#431)
2557- Improved detail in stdout exporter. (#436)
2558- Fix a dependency issue (generate target should depend on stringer, not lint target) in Makefile. (#442)
2559- Reorders the Makefile targets within `precommit` target so we generate files and build the code before doing linting, so we can get much nicer errors about syntax errors from the compiler. (#442)
2560- Reword function documentation in gRPC plugin. (#446)
2561- Send the `span.kind` tag to Jaeger from the jaeger exporter. (#441)
2562- Fix `metadataSupplier` in the jaeger exporter to overwrite the header if existing instead of appending to it. (#441)
2563- Upgraded to Go 1.13 in CI. (#465)
2564- Correct opentelemetry.io URL in trace SDK documentation. (#464)
2565- Refactored reference counting logic in SDK determination of stale records. (#468)
2566- Add call to `runtime.Gosched` in instrument `acquireHandle` logic to not block the collector. (#469)
2567
2568## [0.2.1.1] - 2020-01-13
2569
2570### Fixed
2571
2572- Use stateful batcher on Prometheus exporter fixing regression introduced in #395. (#428)
2573
2574## [0.2.1] - 2020-01-08
2575
2576### Added
2577
2578- Global meter forwarding implementation.
2579 This enables deferred initialization for metric instruments registered before the first Meter SDK is installed. (#392)
2580- Global trace forwarding implementation.
2581 This enables deferred initialization for tracers registered before the first Trace SDK is installed. (#406)
2582- Standardize export pipeline creation in all exporters. (#395)
2583- A testing, organization, and comments for 64-bit field alignment. (#418)
2584- Script to tag all modules in the project. (#414)
2585
2586### Changed
2587
2588- Renamed `propagation` package to `propagators`. (#362)
2589- Renamed `B3Propagator` propagator to `B3`. (#362)
2590- Renamed `TextFormatPropagator` propagator to `TextFormat`. (#362)
2591- Renamed `BinaryPropagator` propagator to `Binary`. (#362)
2592- Renamed `BinaryFormatPropagator` propagator to `BinaryFormat`. (#362)
2593- Renamed `NoopTextFormatPropagator` propagator to `NoopTextFormat`. (#362)
2594- Renamed `TraceContextPropagator` propagator to `TraceContext`. (#362)
2595- Renamed `SpanOption` to `StartOption` in the trace API. (#369)
2596- Renamed `StartOptions` to `StartConfig` in the trace API. (#369)
2597- Renamed `EndOptions` to `EndConfig` in the trace API. (#369)
2598- `Number` now has a pointer receiver for its methods. (#375)
2599- Renamed `CurrentSpan` to `SpanFromContext` in the trace API. (#379)
2600- Renamed `SetCurrentSpan` to `ContextWithSpan` in the trace API. (#379)
2601- Renamed `Message` in Event to `Name` in the trace API. (#389)
2602- Prometheus exporter no longer aggregates metrics, instead it only exports them. (#385)
2603- Renamed `HandleImpl` to `BoundInstrumentImpl` in the metric API. (#400)
2604- Renamed `Float64CounterHandle` to `Float64CounterBoundInstrument` in the metric API. (#400)
2605- Renamed `Int64CounterHandle` to `Int64CounterBoundInstrument` in the metric API. (#400)
2606- Renamed `Float64GaugeHandle` to `Float64GaugeBoundInstrument` in the metric API. (#400)
2607- Renamed `Int64GaugeHandle` to `Int64GaugeBoundInstrument` in the metric API. (#400)
2608- Renamed `Float64MeasureHandle` to `Float64MeasureBoundInstrument` in the metric API. (#400)
2609- Renamed `Int64MeasureHandle` to `Int64MeasureBoundInstrument` in the metric API. (#400)
2610- Renamed `Release` method for bound instruments in the metric API to `Unbind`. (#400)
2611- Renamed `AcquireHandle` method for bound instruments in the metric API to `Bind`. (#400)
2612- Renamed the `File` option in the stdout exporter to `Writer`. (#404)
2613- Renamed all `Options` to `Config` for all metric exports where this wasn't already the case.
2614
2615### Fixed
2616
2617- Aggregator import path corrected. (#421)
2618- Correct links in README. (#368)
2619- The README was updated to match latest code changes in its examples. (#374)
2620- Don't capitalize error statements. (#375)
2621- Fix ignored errors. (#375)
2622- Fix ambiguous variable naming. (#375)
2623- Removed unnecessary type casting. (#375)
2624- Use named parameters. (#375)
2625- Updated release schedule. (#378)
2626- Correct http-stackdriver example module name. (#394)
2627- Removed the `http.request` span in `httptrace` package. (#397)
2628- Add comments in the metrics SDK (#399)
2629- Initialize checkpoint when creating ddsketch aggregator to prevent panic when merging into a empty one. (#402) (#403)
2630- Add documentation of compatible exporters in the README. (#405)
2631- Typo fix. (#408)
2632- Simplify span check logic in SDK tracer implementation. (#419)
2633
2634## [0.2.0] - 2019-12-03
2635
2636### Added
2637
2638- Unary gRPC tracing example. (#351)
2639- Prometheus exporter. (#334)
2640- Dogstatsd metrics exporter. (#326)
2641
2642### Changed
2643
2644- Rename `MaxSumCount` aggregation to `MinMaxSumCount` and add the `Min` interface for this aggregation. (#352)
2645- Rename `GetMeter` to `Meter`. (#357)
2646- Rename `HTTPTraceContextPropagator` to `TraceContextPropagator`. (#355)
2647- Rename `HTTPB3Propagator` to `B3Propagator`. (#355)
2648- Rename `HTTPTraceContextPropagator` to `TraceContextPropagator`. (#355)
2649- Move `/global` package to `/api/global`. (#356)
2650- Rename `GetTracer` to `Tracer`. (#347)
2651
2652### Removed
2653
2654- `SetAttribute` from the `Span` interface in the trace API. (#361)
2655- `AddLink` from the `Span` interface in the trace API. (#349)
2656- `Link` from the `Span` interface in the trace API. (#349)
2657
2658### Fixed
2659
2660- Exclude example directories from coverage report. (#365)
2661- Lint make target now implements automatic fixes with `golangci-lint` before a second run to report the remaining issues. (#360)
2662- Drop `GO111MODULE` environment variable in Makefile as Go 1.13 is the project specified minimum version and this is environment variable is not needed for that version of Go. (#359)
2663- Run the race checker for all test. (#354)
2664- Redundant commands in the Makefile are removed. (#354)
2665- Split the `generate` and `lint` targets of the Makefile. (#354)
2666- Renames `circle-ci` target to more generic `ci` in Makefile. (#354)
2667- Add example Prometheus binary to gitignore. (#358)
2668- Support negative numbers with the `MaxSumCount`. (#335)
2669- Resolve race conditions in `push_test.go` identified in #339. (#340)
2670- Use `/usr/bin/env bash` as a shebang in scripts rather than `/bin/bash`. (#336)
2671- Trace benchmark now tests both `AlwaysSample` and `NeverSample`.
2672 Previously it was testing `AlwaysSample` twice. (#325)
2673- Trace benchmark now uses a `[]byte` for `TraceID` to fix failing test. (#325)
2674- Added a trace benchmark to test variadic functions in `setAttribute` vs `setAttributes` (#325)
2675- The `defaultkeys` batcher was only using the encoded label set as its map key while building a checkpoint.
2676 This allowed distinct label sets through, but any metrics sharing a label set could be overwritten or merged incorrectly.
2677 This was corrected. (#333)
2678
2679## [0.1.2] - 2019-11-18
2680
2681### Fixed
2682
2683- Optimized the `simplelru` map for attributes to reduce the number of allocations. (#328)
2684- Removed unnecessary unslicing of parameters that are already a slice. (#324)
2685
2686## [0.1.1] - 2019-11-18
2687
2688This release contains a Metrics SDK with stdout exporter and supports basic aggregations such as counter, gauges, array, maxsumcount, and ddsketch.
2689
2690### Added
2691
2692- Metrics stdout export pipeline. (#265)
2693- Array aggregation for raw measure metrics. (#282)
2694- The core.Value now have a `MarshalJSON` method. (#281)
2695
2696### Removed
2697
2698- `WithService`, `WithResources`, and `WithComponent` methods of tracers. (#314)
2699- Prefix slash in `Tracer.Start()` for the Jaeger example. (#292)
2700
2701### Changed
2702
2703- Allocation in LabelSet construction to reduce GC overhead. (#318)
2704- `trace.WithAttributes` to append values instead of replacing (#315)
2705- Use a formula for tolerance in sampling tests. (#298)
2706- Move export types into trace and metric-specific sub-directories. (#289)
2707- `SpanKind` back to being based on an `int` type. (#288)
2708
2709### Fixed
2710
2711- URL to OpenTelemetry website in README. (#323)
2712- Name of othttp default tracer. (#321)
2713- `ExportSpans` for the stackdriver exporter now handles `nil` context. (#294)
2714- CI modules cache to correctly restore/save from/to the cache. (#316)
2715- Fix metric SDK race condition between `LoadOrStore` and the assignment `rec.recorder = i.meter.exporter.AggregatorFor(rec)`. (#293)
2716- README now reflects the new code structure introduced with these changes. (#291)
2717- Make the basic example work. (#279)
2718
2719## [0.1.0] - 2019-11-04
2720
2721This is the first release of open-telemetry go library.
2722It contains api and sdk for trace and meter.
2723
2724### Added
2725
2726- Initial OpenTelemetry trace and metric API prototypes.
2727- Initial OpenTelemetry trace, metric, and export SDK packages.
2728- A wireframe bridge to support compatibility with OpenTracing.
2729- Example code for a basic, http-stackdriver, http, jaeger, and named tracer setup.
2730- Exporters for Jaeger, Stackdriver, and stdout.
2731- Propagators for binary, B3, and trace-context protocols.
2732- Project information and guidelines in the form of a README and CONTRIBUTING.
2733- Tools to build the project and a Makefile to automate the process.
2734- Apache-2.0 license.
2735- CircleCI build CI manifest files.
2736- CODEOWNERS file to track owners of this project.
2737
2738[Unreleased]: https://github.com/open-telemetry/opentelemetry-go/compare/v1.21.0...HEAD
2739[1.21.0/0.44.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.21.0
2740[1.20.0/0.43.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.20.0
2741[1.19.0/0.42.0/0.0.7]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.19.0
2742[1.19.0-rc.1/0.42.0-rc.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.19.0-rc.1
2743[1.18.0/0.41.0/0.0.6]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.18.0
2744[1.17.0/0.40.0/0.0.5]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.17.0
2745[1.16.0/0.39.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.16.0
2746[1.16.0-rc.1/0.39.0-rc.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.16.0-rc.1
2747[1.15.1/0.38.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.15.1
2748[1.15.0/0.38.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.15.0
2749[1.15.0-rc.2/0.38.0-rc.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.15.0-rc.2
2750[1.15.0-rc.1/0.38.0-rc.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.15.0-rc.1
2751[1.14.0/0.37.0/0.0.4]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.14.0
2752[1.13.0/0.36.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.13.0
2753[1.12.0/0.35.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.12.0
2754[1.11.2/0.34.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.11.2
2755[1.11.1/0.33.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.11.1
2756[1.11.0/0.32.3]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.11.0
2757[0.32.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/sdk/metric/v0.32.2
2758[0.32.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/sdk/metric/v0.32.1
2759[0.32.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/sdk/metric/v0.32.0
2760[1.10.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.10.0
2761[1.9.0/0.0.3]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.9.0
2762[1.8.0/0.31.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.8.0
2763[1.7.0/0.30.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.7.0
2764[0.29.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/metric/v0.29.0
2765[1.6.3]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.6.3
2766[1.6.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.6.2
2767[1.6.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.6.1
2768[1.6.0/0.28.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.6.0
2769[1.5.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.5.0
2770[1.4.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.4.1
2771[1.4.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.4.0
2772[1.3.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.3.0
2773[1.2.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.2.0
2774[1.1.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.1.0
2775[1.0.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.0.1
2776[Metrics 0.24.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/metric/v0.24.0
2777[1.0.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.0.0
2778[1.0.0-RC3]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.0.0-RC3
2779[1.0.0-RC2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.0.0-RC2
2780[Experimental Metrics v0.22.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/metric/v0.22.0
2781[1.0.0-RC1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.0.0-RC1
2782[0.20.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.20.0
2783[0.19.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.19.0
2784[0.18.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.18.0
2785[0.17.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.17.0
2786[0.16.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.16.0
2787[0.15.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.15.0
2788[0.14.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.14.0
2789[0.13.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.13.0
2790[0.12.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.12.0
2791[0.11.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.11.0
2792[0.10.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.10.0
2793[0.9.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.9.0
2794[0.8.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.8.0
2795[0.7.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.7.0
2796[0.6.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.6.0
2797[0.5.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.5.0
2798[0.4.3]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.4.3
2799[0.4.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.4.2
2800[0.4.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.4.1
2801[0.4.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.4.0
2802[0.3.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.3.0
2803[0.2.3]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.2.3
2804[0.2.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.2.2
2805[0.2.1.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.2.1.1
2806[0.2.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.2.1
2807[0.2.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.2.0
2808[0.1.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.1.2
2809[0.1.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.1.1
2810[0.1.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.1.0
2811
2812[Go 1.20]: https://go.dev/doc/go1.20
2813[Go 1.19]: https://go.dev/doc/go1.19
2814[Go 1.18]: https://go.dev/doc/go1.18
2815
2816[metric API]:https://pkg.go.dev/go.opentelemetry.io/otel/metric
2817[metric SDK]:https://pkg.go.dev/go.opentelemetry.io/otel/sdk/metric
2818[trace API]:https://pkg.go.dev/go.opentelemetry.io/otel/trace
View as plain text