Debian Codegraph @

CHANGELOG.md

raw
1 # Changelog
2
3 All notable changes to this project will be documented in this file.
4
5 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
6
7 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
8
9 ## [Unreleased]
10
11 <!-- Released section -->
12 <!-- Don't change this section unless doing release -->
13
14 ## [1.43.0/0.65.0/0.19.0] 2026-04-02
15
16 ### Added
17
18 - Add `IsRandom` and `WithRandom` on `TraceFlags`, and `IsRandom` on `SpanContext` in `go.opentelemetry.io/otel/trace` for [W3C Trace Context Level 2 Random Trace ID Flag](https://www.w3.org/TR/trace-context-2/#random-trace-id-flag) support. (#8012)
19 - Add service detection with `WithService` in `go.opentelemetry.io/otel/sdk/resource`. (#7642)
20 - Add `DefaultWithContext` and `EnvironmentWithContext` in `go.opentelemetry.io/otel/sdk/resource` to support plumbing `context.Context` through default and environment detectors. (#8051)
21 - Support attributes with empty value (`attribute.EMPTY`) in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`. (#8038)
22 - Support attributes with empty value (`attribute.EMPTY`) in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#8038)
23 - Support attributes with empty value (`attribute.EMPTY`) in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc`. (#8038)
24 - Support attributes with empty value (`attribute.EMPTY`) in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#8038)
25 - Support attributes with empty value (`attribute.EMPTY`) in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#8038)
26 - Support attributes with empty value (`attribute.EMPTY`) in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#8038)
27 - Support attributes with empty value (`attribute.EMPTY`) in `go.opentelemetry.io/otel/sdk/metric/metricdata/metricdatatest`. (#8038)
28 - Add support for per-series start time tracking for cumulative metrics in `go.opentelemetry.io/otel/sdk/metric`.
29 Set `OTEL_GO_X_PER_SERIES_START_TIMESTAMPS=true` to enable. (#8060)
30 - Add `WithCardinalityLimitSelector` for metric reader for configuring cardinality limits specific to the instrument kind. (#7855)
31
32 ### Changed
33
34 - Introduce the `EMPTY` Type in `go.opentelemetry.io/otel/attribute` to reflect that an empty value is now a valid value, with `INVALID` remaining as a deprecated alias of `EMPTY`. (#8038)
35 - Improve slice handling in `go.opentelemetry.io/otel/attribute` to optimize short slice values with fixed-size fast paths. (#8039)
36 - Improve performance of span metric recording in `go.opentelemetry.io/otel/sdk/trace` by returning early if self-observability is not enabled. (#8067)
37 - Improve formatting of metric data diffs in `go.opentelemetry.io/otel/sdk/metric/metricdata/metricdatatest`. (#8073)
38
39 ### Deprecated
40
41 - Deprecate `INVALID` in `go.opentelemetry.io/otel/attribute`. Use `EMPTY` instead. (#8038)
42
43 ### Fixed
44
45 - Return spec-compliant `TraceIdRatioBased` description. This is a breaking behavioral change, but it is necessary to
46 make the implementation [spec-compliant](https://opentelemetry.io/docs/specs/otel/trace/sdk/#traceidratiobased). (#8027)
47 - Fix a race condition in `go.opentelemetry.io/otel/sdk/metric` where the lastvalue aggregation could collect the value 0 even when no zero-value measurements were recorded. (#8056)
48 - Limit HTTP response body to 4 MiB in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp` to mitigate excessive memory usage caused by a misconfigured or malicious server.
49 Responses exceeding the limit are treated as non-retryable errors. (#8108)
50 - Limit HTTP response body to 4 MiB in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp` to mitigate excessive memory usage caused by a misconfigured or malicious server.
51 Responses exceeding the limit are treated as non-retryable errors. (#8108)
52 - Limit HTTP response body to 4 MiB in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp` to mitigate excessive memory usage caused by a misconfigured or malicious server.
53 Responses exceeding the limit are treated as non-retryable errors. (#8108)
54 - `WithHostID` detector in `go.opentelemetry.io/otel/sdk/resource` to use full path for `kenv` command on BSD. (#8113)
55 - Fix missing `request.GetBody` in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp` to correctly handle HTTP2 GOAWAY frame. (#8096)
56
57 ## [1.42.0/0.64.0/0.18.0/0.0.16] 2026-03-06
58
59 ### Added
60
61 - Add `go.opentelemetry.io/otel/semconv/v1.40.0` package.
62 The package contains semantic conventions from the `v1.40.0` version of the OpenTelemetry Semantic Conventions.
63 See the [migration documentation](./semconv/v1.40.0/MIGRATION.md) for information on how to upgrade from `go.opentelemetry.io/otel/semconv/v1.39.0`. (#7985)
64 - Add `Err` and `SetErr` on `Record` in `go.opentelemetry.io/otel/log` to attach an error and set record exception attributes in `go.opentelemetry.io/otel/log/sdk`. (#7924)
65
66 ### Changed
67
68 - `TracerProvider.ForceFlush` in `go.opentelemetry.io/otel/sdk/trace` joins errors together and continues iteration through SpanProcessors as opposed to returning the first encountered error without attempting exports on subsequent SpanProcessors. (#7856)
69
70 ### Fixed
71
72 - Fix missing `request.GetBody` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp` to correctly handle HTTP2 GOAWAY frame. (#7931)
73 - Fix semconv v1.39.0 generated metric helpers skipping required attributes when extra attributes were empty. (#7964)
74 - Preserve W3C TraceFlags bitmask (including the random Trace ID flag) during trace context extraction and injection in `go.opentelemetry.io/otel/propagation`. (#7834)
75
76 ### Removed
77
78 - Drop support for [Go 1.24]. (#7984)
79
80 ## [1.41.0/0.63.0/0.17.0/0.0.15] 2026-03-02
81
82 This release is the last to support [Go 1.24].
83 The next release will require at least [Go 1.25].
84
85 ### Added
86
87 - Support testing of [Go 1.26]. (#7902)
88
89 ### Fixed
90
91 - Update `Baggage` in `go.opentelemetry.io/otel/propagation` and `Parse` and `New` in `go.opentelemetry.io/otel/baggage` to comply with W3C Baggage specification limits.
92 `New` and `Parse` now return partial baggage along with an error when limits are exceeded.
93 Errors from baggage extraction are reported to the global error handler. (#7880)
94 - Return an error when the endpoint is configured as insecure and with TLS configuration in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#7914)
95 - Return an error when the endpoint is configured as insecure and with TLS configuration in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#7914)
96 - Return an error when the endpoint is configured as insecure and with TLS configuration in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#7914)
97
98 ## [1.40.0/0.62.0/0.16.0] 2026-02-02
99
100 ### Added
101
102 - Add `AlwaysRecord` sampler in `go.opentelemetry.io/otel/sdk/trace`. (#7724)
103 - Add `Enabled` method to all synchronous instrument interfaces (`Float64Counter`, `Float64UpDownCounter`, `Float64Histogram`, `Float64Gauge`, `Int64Counter`, `Int64UpDownCounter`, `Int64Histogram`, `Int64Gauge`,) in `go.opentelemetry.io/otel/metric`.
104 This stabilizes the synchronous instrument enabled feature, allowing users to check if an instrument will process measurements before performing computationally expensive operations. (#7763)
105 - Add `go.opentelemetry.io/otel/semconv/v1.39.0` package.
106 The package contains semantic conventions from the `v1.39.0` version of the OpenTelemetry Semantic Conventions.
107 See the [migration documentation](./semconv/v1.39.0/MIGRATION.md) for information on how to upgrade from `go.opentelemetry.io/otel/semconv/v1.38.0.` (#7783, #7789)
108
109 ### Changed
110
111 - Improve the concurrent performance of `HistogramReservoir` in `go.opentelemetry.io/otel/sdk/metric/exemplar` by 4x. (#7443)
112 - Improve the concurrent performance of `FixedSizeReservoir` in `go.opentelemetry.io/otel/sdk/metric/exemplar`. (#7447)
113 - Improve performance of concurrent histogram measurements in `go.opentelemetry.io/otel/sdk/metric`. (#7474)
114 - Improve performance of concurrent synchronous gauge measurements in `go.opentelemetry.io/otel/sdk/metric`. (#7478)
115 - Add experimental observability metrics in `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric`. (#7492)
116 - `Exporter` in `go.opentelemetry.io/otel/exporters/prometheus` ignores metrics with the scope `go.opentelemetry.io/contrib/bridges/prometheus`.
117 This prevents scrape failures when the Prometheus exporter is misconfigured to get data from the Prometheus bridge. (#7688)
118 - Improve performance of concurrent exponential histogram measurements in `go.opentelemetry.io/otel/sdk/metric`. (#7702)
119 - The `rpc.grpc.status_code` attribute in the experimental metrics emitted from `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc` is replaced with the `rpc.response.status_code` attribute to align with the semantic conventions. (#7854)
120 - The `rpc.grpc.status_code` attribute in the experimental metrics emitted from `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc` is replaced with the `rpc.response.status_code` attribute to align with the semantic conventions. (#7854)
121
122 ### Fixed
123
124 - Fix bad log message when key-value pairs are dropped because of key duplication in `go.opentelemetry.io/otel/sdk/log`. (#7662)
125 - Fix `DroppedAttributes` on `Record` in `go.opentelemetry.io/otel/sdk/log` to not count the non-attribute key-value pairs dropped because of key duplication. (#7662)
126 - Fix `SetAttributes` on `Record` in `go.opentelemetry.io/otel/sdk/log` to not log that attributes are dropped when they are actually not dropped. (#7662)
127 - Fix missing `request.GetBody` in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp` to correctly handle HTTP/2 `GOAWAY` frame. (#7794)
128 - `WithHostID` detector in `go.opentelemetry.io/otel/sdk/resource` to use full path for `ioreg` command on Darwin (macOS). (#7818)
129
130 ### Deprecated
131
132 - Deprecate `go.opentelemetry.io/otel/exporters/zipkin`.
133 For more information, see the [OTel blog post deprecating the Zipkin exporter](https://opentelemetry.io/blog/2025/deprecating-zipkin-exporters/). (#7670)
134
135 ## [1.39.0/0.61.0/0.15.0/0.0.14] 2025-12-05
136
137 ### Added
138
139 - Greatly reduce the cost of recording metrics in `go.opentelemetry.io/otel/sdk/metric` using hashing for map keys. (#7175)
140 - Add `WithInstrumentationAttributeSet` option to `go.opentelemetry.io/otel/log`, `go.opentelemetry.io/otel/metric`, and `go.opentelemetry.io/otel/trace` packages.
141 This provides a concurrent-safe and performant alternative to `WithInstrumentationAttributes` by accepting a pre-constructed `attribute.Set`. (#7287)
142 - Add experimental observability for the Prometheus exporter in `go.opentelemetry.io/otel/exporters/prometheus`.
143 Check the `go.opentelemetry.io/otel/exporters/prometheus/internal/x` package documentation for more information. (#7345)
144 - Add experimental observability metrics in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc`. (#7353)
145 - Add temporality selector functions `DeltaTemporalitySelector`, `CumulativeTemporalitySelector`, `LowMemoryTemporalitySelector` to `go.opentelemetry.io/otel/sdk/metric`. (#7434)
146 - Add experimental observability metrics for simple log processor in `go.opentelemetry.io/otel/sdk/log`. (#7548)
147 - Add experimental observability metrics in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`. (#7459)
148 - Add experimental observability metrics in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#7486)
149 - Add experimental observability metrics for simple span processor in `go.opentelemetry.io/otel/sdk/trace`. (#7374)
150 - Add experimental observability metrics in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#7512)
151 - Add experimental observability metrics for manual reader in `go.opentelemetry.io/otel/sdk/metric`. (#7524)
152 - Add experimental observability metrics for periodic reader in `go.opentelemetry.io/otel/sdk/metric`. (#7571)
153 - Support `OTEL_EXPORTER_OTLP_LOGS_INSECURE` and `OTEL_EXPORTER_OTLP_INSECURE` environmental variables in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#7608)
154 - Add `Enabled` method to the `Processor` interface in `go.opentelemetry.io/otel/sdk/log`.
155 All `Processor` implementations now include an `Enabled` method. (#7639)
156 - The `go.opentelemetry.io/otel/semconv/v1.38.0` package.
157 The package contains semantic conventions from the `v1.38.0` version of the OpenTelemetry Semantic Conventions.
158 See the [migration documentation](./semconv/v1.38.0/MIGRATION.md) for information on how to upgrade from `go.opentelemetry.io/otel/semconv/v1.37.0.`(#7648)
159
160 ### Changed
161
162 - `Distinct` in `go.opentelemetry.io/otel/attribute` is no longer guaranteed to uniquely identify an attribute set.
163 Collisions between `Distinct` values for different Sets are possible with extremely high cardinality (billions of series per instrument), but are highly unlikely. (#7175)
164 - `WithInstrumentationAttributes` in `go.opentelemetry.io/otel/trace` synchronously de-duplicates the passed attributes instead of delegating it to the returned `TracerOption`. (#7266)
165 - `WithInstrumentationAttributes` in `go.opentelemetry.io/otel/meter` synchronously de-duplicates the passed attributes instead of delegating it to the returned `MeterOption`. (#7266)
166 - `WithInstrumentationAttributes` in `go.opentelemetry.io/otel/log` synchronously de-duplicates the passed attributes instead of delegating it to the returned `LoggerOption`. (#7266)
167 - Rename the `OTEL_GO_X_SELF_OBSERVABILITY` environment variable to `OTEL_GO_X_OBSERVABILITY` in `go.opentelemetry.io/otel/sdk/trace`, `go.opentelemetry.io/otel/sdk/log`, and `go.opentelemetry.io/otel/exporters/stdout/stdouttrace`. (#7302)
168 - Improve performance of histogram `Record` in `go.opentelemetry.io/otel/sdk/metric` when min and max are disabled using `NoMinMax`. (#7306)
169 - Improve error handling for dropped data during translation by using `prometheus.NewInvalidMetric` in `go.opentelemetry.io/otel/exporters/prometheus`.
170 ⚠️ **Breaking Change:** Previously, these cases were only logged and scrapes succeeded.
171 Now, when translation would drop data (e.g., invalid label/value), the exporter emits a `NewInvalidMetric`, and Prometheus scrapes **fail with HTTP 500** by default.
172 To preserve the prior behavior (scrapes succeed while errors are logged), configure your Prometheus HTTP handler with: `promhttp.HandlerOpts{ ErrorHandling: promhttp.ContinueOnError }`. (#7363)
173 - Replace fnv hash with xxhash in `go.opentelemetry.io/otel/attribute` for better performance. (#7371)
174 - The default `TranslationStrategy` in `go.opentelemetry.io/exporters/prometheus` is changed from `otlptranslator.NoUTF8EscapingWithSuffixes` to `otlptranslator.UnderscoreEscapingWithSuffixes`. (#7421)
175 - Improve performance of concurrent measurements in `go.opentelemetry.io/otel/sdk/metric`. (#7427)
176 - Include W3C TraceFlags (bits 0–7) in the OTLP `Span.Flags` field in `go.opentelemetry.io/exporters/otlp/otlptrace/otlptracehttp` and `go.opentelemetry.io/exporters/otlp/otlptrace/otlptracegrpc`. (#7438)
177 - The `ErrorType` function in `go.opentelemetry.io/otel/semconv/v1.37.0` now handles custom error types.
178 If an error implements an `ErrorType() string` method, the return value of that method will be used as the error type. (#7442)
179
180 ### Fixed
181
182 - Fix `WithInstrumentationAttributes` options in `go.opentelemetry.io/otel/trace`, `go.opentelemetry.io/otel/metric`, and `go.opentelemetry.io/otel/log` to properly merge attributes when passed multiple times instead of replacing them.
183 Attributes with duplicate keys will use the last value passed. (#7300)
184 - The equality of `attribute.Set` when using the `Equal` method is not affected by the user overriding the empty set pointed to by `attribute.EmptySet` in `go.opentelemetry.io/otel/attribute`. (#7357)
185 - Return partial OTLP export errors to the caller in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc`. (#7372)
186 - Return partial OTLP export errors to the caller in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#7372)
187 - Return partial OTLP export errors to the caller in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#7372)
188 - Return partial OTLP export errors to the caller in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#7372)
189 - Return partial OTLP export errors to the caller in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`. (#7372)
190 - Return partial OTLP export errors to the caller in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#7372)
191 - Fix `AddAttributes`, `SetAttributes`, `SetBody` on `Record` in `go.opentelemetry.io/otel/sdk/log` to not mutate input. (#7403)
192 - Do not double record measurements of `RecordSet` methods in `go.opentelemetry.io/otel/semconv/v1.37.0`. (#7655)
193 - Do not double record measurements of `RecordSet` methods in `go.opentelemetry.io/otel/semconv/v1.36.0`. (#7656)
194
195 ### Removed
196
197 - Drop support for [Go 1.23]. (#7274)
198 - Remove the `FilterProcessor` interface in `go.opentelemetry.io/otel/sdk/log`.
199 The `Enabled` method has been added to the `Processor` interface instead.
200 All `Processor` implementations must now implement the `Enabled` method.
201 Custom processors that do not filter records can implement `Enabled` to return `true`. (#7639)
202
203 ## [1.38.0/0.60.0/0.14.0/0.0.13] 2025-08-29
204
205 This release is the last to support [Go 1.23].
206 The next release will require at least [Go 1.24].
207
208 ### Added
209
210 - Add native histogram exemplar support in `go.opentelemetry.io/otel/exporters/prometheus`. (#6772)
211 - Add template attribute functions to the `go.opentelmetry.io/otel/semconv/v1.34.0` package. (#6939)
212 - `ContainerLabel`
213 - `DBOperationParameter`
214 - `DBSystemParameter`
215 - `HTTPRequestHeader`
216 - `HTTPResponseHeader`
217 - `K8SCronJobAnnotation`
218 - `K8SCronJobLabel`
219 - `K8SDaemonSetAnnotation`
220 - `K8SDaemonSetLabel`
221 - `K8SDeploymentAnnotation`
222 - `K8SDeploymentLabel`
223 - `K8SJobAnnotation`
224 - `K8SJobLabel`
225 - `K8SNamespaceAnnotation`
226 - `K8SNamespaceLabel`
227 - `K8SNodeAnnotation`
228 - `K8SNodeLabel`
229 - `K8SPodAnnotation`
230 - `K8SPodLabel`
231 - `K8SReplicaSetAnnotation`
232 - `K8SReplicaSetLabel`
233 - `K8SStatefulSetAnnotation`
234 - `K8SStatefulSetLabel`
235 - `ProcessEnvironmentVariable`
236 - `RPCConnectRPCRequestMetadata`
237 - `RPCConnectRPCResponseMetadata`
238 - `RPCGRPCRequestMetadata`
239 - `RPCGRPCResponseMetadata`
240 - Add `ErrorType` attribute helper function to the `go.opentelmetry.io/otel/semconv/v1.34.0` package. (#6962)
241 - Add `WithAllowKeyDuplication` in `go.opentelemetry.io/otel/sdk/log` which can be used to disable deduplication for log records. (#6968)
242 - Add `WithCardinalityLimit` option to configure the cardinality limit in `go.opentelemetry.io/otel/sdk/metric`. (#6996, #7065, #7081, #7164, #7165, #7179)
243 - Add `Clone` method to `Record` in `go.opentelemetry.io/otel/log` that returns a copy of the record with no shared state. (#7001)
244 - Add experimental self-observability span and batch span processor metrics in `go.opentelemetry.io/otel/sdk/trace`.
245 Check the `go.opentelemetry.io/otel/sdk/trace/internal/x` package documentation for more information. (#7027, #6393, #7209)
246 - The `go.opentelemetry.io/otel/semconv/v1.36.0` package.
247 The package contains semantic conventions from the `v1.36.0` version of the OpenTelemetry Semantic Conventions.
248 See the [migration documentation](./semconv/v1.36.0/MIGRATION.md) for information on how to upgrade from `go.opentelemetry.io/otel/semconv/v1.34.0.`(#7032, #7041)
249 - Add support for configuring Prometheus name translation using `WithTranslationStrategy` option in `go.opentelemetry.io/otel/exporters/prometheus`. The current default translation strategy when UTF-8 mode is enabled is `NoUTF8EscapingWithSuffixes`, but a future release will change the default strategy to `UnderscoreEscapingWithSuffixes` for compliance with the specification. (#7111)
250 - Add experimental self-observability log metrics in `go.opentelemetry.io/otel/sdk/log`.
251 Check the `go.opentelemetry.io/otel/sdk/log/internal/x` package documentation for more information. (#7121)
252 - Add experimental self-observability trace exporter metrics in `go.opentelemetry.io/otel/exporters/stdout/stdouttrace`.
253 Check the `go.opentelemetry.io/otel/exporters/stdout/stdouttrace/internal/x` package documentation for more information. (#7133)
254 - Support testing of [Go 1.25]. (#7187)
255 - The `go.opentelemetry.io/otel/semconv/v1.37.0` package.
256 The package contains semantic conventions from the `v1.37.0` version of the OpenTelemetry Semantic Conventions.
257 See the [migration documentation](./semconv/v1.37.0/MIGRATION.md) for information on how to upgrade from `go.opentelemetry.io/otel/semconv/v1.36.0.`(#7254)
258
259 ### Changed
260
261 - Optimize `TraceIDFromHex` and `SpanIDFromHex` in `go.opentelemetry.io/otel/sdk/trace`. (#6791)
262 - Change `AssertEqual` in `go.opentelemetry.io/otel/log/logtest` to accept `TestingT` in order to support benchmarks and fuzz tests. (#6908)
263 - Change `DefaultExemplarReservoirProviderSelector` in `go.opentelemetry.io/otel/sdk/metric` to use `runtime.GOMAXPROCS(0)` instead of `runtime.NumCPU()` for the `FixedSizeReservoirProvider` default size. (#7094)
264
265 ### Fixed
266
267 - `SetBody` method of `Record` in `go.opentelemetry.io/otel/sdk/log` now deduplicates key-value collections (`log.Value` of `log.KindMap` from `go.opentelemetry.io/otel/log`). (#7002)
268 - Fix `go.opentelemetry.io/otel/exporters/prometheus` to not append a suffix if it's already present in metric name. (#7088)
269 - Fix the `go.opentelemetry.io/otel/exporters/stdout/stdouttrace` self-observability component type and name. (#7195)
270 - Fix partial export count metric in `go.opentelemetry.io/otel/exporters/stdout/stdouttrace`. (#7199)
271
272 ### Deprecated
273
274 - Deprecate `WithoutUnits` and `WithoutCounterSuffixes` options, preferring `WithTranslationStrategy` instead. (#7111)
275 - Deprecate support for `OTEL_GO_X_CARDINALITY_LIMIT` environment variable in `go.opentelemetry.io/otel/sdk/metric`. Use `WithCardinalityLimit` option instead. (#7166)
276
277 ## [0.59.1] 2025-07-21
278
279 ### Changed
280
281 - Retract `v0.59.0` release of `go.opentelemetry.io/otel/exporters/prometheus` module which appends incorrect unit suffixes. (#7046)
282 - Change `go.opentelemetry.io/otel/exporters/prometheus` to no longer deduplicate suffixes when UTF8 is enabled.
283 It is recommended to disable unit and counter suffixes in the exporter, and manually add suffixes if you rely on the existing behavior. (#7044)
284
285 ### Fixed
286
287 - Fix `go.opentelemetry.io/otel/exporters/prometheus` to properly handle unit suffixes when the unit is in brackets.
288 E.g. `{spans}`. (#7044)
289
290 ## [1.37.0/0.59.0/0.13.0] 2025-06-25
291
292 ### Added
293
294 - The `go.opentelemetry.io/otel/semconv/v1.33.0` package.
295 The package contains semantic conventions from the `v1.33.0` version of the OpenTelemetry Semantic Conventions.
296 See the [migration documentation](./semconv/v1.33.0/MIGRATION.md) for information on how to upgrade from `go.opentelemetry.io/otel/semconv/v1.32.0.`(#6799)
297 - The `go.opentelemetry.io/otel/semconv/v1.34.0` package.
298 The package contains semantic conventions from the `v1.34.0` version of the OpenTelemetry Semantic Conventions. (#6812)
299 - Add metric's schema URL as `otel_scope_schema_url` label in `go.opentelemetry.io/otel/exporters/prometheus`. (#5947)
300 - Add metric's scope attributes as `otel_scope_[attribute]` labels in `go.opentelemetry.io/otel/exporters/prometheus`. (#5947)
301 - Add `EventName` to `EnabledParameters` in `go.opentelemetry.io/otel/log`. (#6825)
302 - Add `EventName` to `EnabledParameters` in `go.opentelemetry.io/otel/sdk/log`. (#6825)
303 - Changed handling of `go.opentelemetry.io/otel/exporters/prometheus` metric renaming to add unit suffixes when it doesn't match one of the pre-defined values in the unit suffix map. (#6839)
304
305 ### Changed
306
307 - The semantic conventions have been upgraded from `v1.26.0` to `v1.34.0` in `go.opentelemetry.io/otel/bridge/opentracing`. (#6827)
308 - The semantic conventions have been upgraded from `v1.26.0` to `v1.34.0` in `go.opentelemetry.io/otel/exporters/zipkin`. (#6829)
309 - The semantic conventions have been upgraded from `v1.26.0` to `v1.34.0` in `go.opentelemetry.io/otel/metric`. (#6832)
310 - The semantic conventions have been upgraded from `v1.26.0` to `v1.34.0` in `go.opentelemetry.io/otel/sdk/resource`. (#6834)
311 - The semantic conventions have been upgraded from `v1.26.0` to `v1.34.0` in `go.opentelemetry.io/otel/sdk/trace`. (#6835)
312 - The semantic conventions have been upgraded from `v1.26.0` to `v1.34.0` in `go.opentelemetry.io/otel/trace`. (#6836)
313 - `Record.Resource` now returns `*resource.Resource` instead of `resource.Resource` in `go.opentelemetry.io/otel/sdk/log`. (#6864)
314 - Retry now shows error cause for context timeout in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`, `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`, `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc`, `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`, `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`, `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#6898)
315
316 ### Fixed
317
318 - Stop stripping trailing slashes from configured endpoint URL in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`. (#6710)
319 - Stop stripping trailing slashes from configured endpoint URL in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#6710)
320 - Stop stripping trailing slashes from configured endpoint URL in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#6710)
321 - Stop stripping trailing slashes from configured endpoint URL in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#6710)
322 - Validate exponential histogram scale range for Prometheus compatibility in `go.opentelemetry.io/otel/exporters/prometheus`. (#6822)
323 - Context cancellation during metric pipeline produce does not corrupt data in `go.opentelemetry.io/otel/sdk/metric`. (#6914)
324
325 ### Removed
326
327 - `go.opentelemetry.io/otel/exporters/prometheus` no longer exports `otel_scope_info` metric. (#6770)
328
329 ## [0.12.2] 2025-05-22
330
331 ### Fixed
332
333 - Retract `v0.12.0` release of `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc` module that contains invalid dependencies. (#6804)
334 - Retract `v0.12.0` release of `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp` module that contains invalid dependencies. (#6804)
335 - Retract `v0.12.0` release of `go.opentelemetry.io/otel/exporters/stdout/stdoutlog` module that contains invalid dependencies. (#6804)
336
337 ## [0.12.1] 2025-05-21
338
339 ### Fixes
340
341 - Use the proper dependency version of `go.opentelemetry.io/otel/sdk/log/logtest` in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc`. (#6800)
342 - Use the proper dependency version of `go.opentelemetry.io/otel/sdk/log/logtest` in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#6800)
343 - Use the proper dependency version of `go.opentelemetry.io/otel/sdk/log/logtest` in `go.opentelemetry.io/otel/exporters/stdout/stdoutlog`. (#6800)
344
345 ## [1.36.0/0.58.0/0.12.0] 2025-05-20
346
347 ### Added
348
349 - Add exponential histogram support in `go.opentelemetry.io/otel/exporters/prometheus`. (#6421)
350 - The `go.opentelemetry.io/otel/semconv/v1.31.0` package.
351 The package contains semantic conventions from the `v1.31.0` version of the OpenTelemetry Semantic Conventions.
352 See the [migration documentation](./semconv/v1.31.0/MIGRATION.md) for information on how to upgrade from `go.opentelemetry.io/otel/semconv/v1.30.0`. (#6479)
353 - Add `Recording`, `Scope`, and `Record` types in `go.opentelemetry.io/otel/log/logtest`. (#6507)
354 - Add `WithHTTPClient` option to configure the `http.Client` used by `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#6751)
355 - Add `WithHTTPClient` option to configure the `http.Client` used by `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#6752)
356 - Add `WithHTTPClient` option to configure the `http.Client` used by `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#6688)
357 - Add `ValuesGetter` in `go.opentelemetry.io/otel/propagation`, a `TextMapCarrier` that supports retrieving multiple values for a single key. (#5973)
358 - Add `Values` method to `HeaderCarrier` to implement the new `ValuesGetter` interface in `go.opentelemetry.io/otel/propagation`. (#5973)
359 - Update `Baggage` in `go.opentelemetry.io/otel/propagation` to retrieve multiple values for a key when the carrier implements `ValuesGetter`. (#5973)
360 - Add `AssertEqual` function in `go.opentelemetry.io/otel/log/logtest`. (#6662)
361 - The `go.opentelemetry.io/otel/semconv/v1.32.0` package.
362 The package contains semantic conventions from the `v1.32.0` version of the OpenTelemetry Semantic Conventions.
363 See the [migration documentation](./semconv/v1.32.0/MIGRATION.md) for information on how to upgrade from `go.opentelemetry.io/otel/semconv/v1.31.0`(#6782)
364 - Add `Transform` option in `go.opentelemetry.io/otel/log/logtest`. (#6794)
365 - Add `Desc` option in `go.opentelemetry.io/otel/log/logtest`. (#6796)
366
367 ### Removed
368
369 - Drop support for [Go 1.22]. (#6381, #6418)
370 - Remove `Resource` field from `EnabledParameters` in `go.opentelemetry.io/otel/sdk/log`. (#6494)
371 - Remove `RecordFactory` type from `go.opentelemetry.io/otel/log/logtest`. (#6492)
372 - Remove `ScopeRecords`, `EmittedRecord`, and `RecordFactory` types from `go.opentelemetry.io/otel/log/logtest`. (#6507)
373 - Remove `AssertRecordEqual` function in `go.opentelemetry.io/otel/log/logtest`, use `AssertEqual` instead. (#6662)
374
375 ### Changed
376
377 - ⚠️ Update `github.com/prometheus/client_golang` to `v1.21.1`, which changes the `NameValidationScheme` to `UTF8Validation`.
378 This allows metrics names to keep original delimiters (e.g. `.`), rather than replacing with underscores.
379 This can be reverted by setting `github.com/prometheus/common/model.NameValidationScheme` to `LegacyValidation` in `github.com/prometheus/common/model`. (#6433)
380 - Initialize map with `len(keys)` in `NewAllowKeysFilter` and `NewDenyKeysFilter` to avoid unnecessary allocations in `go.opentelemetry.io/otel/attribute`. (#6455)
381 - `go.opentelemetry.io/otel/log/logtest` is now a separate Go module. (#6465)
382 - `go.opentelemetry.io/otel/sdk/log/logtest` is now a separate Go module. (#6466)
383 - `Recorder` in `go.opentelemetry.io/otel/log/logtest` no longer separately stores records emitted by loggers with the same instrumentation scope. (#6507)
384 - Improve performance of `BatchProcessor` in `go.opentelemetry.io/otel/sdk/log` by not exporting when exporter cannot accept more. (#6569, #6641)
385
386 ### Deprecated
387
388 - Deprecate support for `model.LegacyValidation` for `go.opentelemetry.io/otel/exporters/prometheus`. (#6449)
389
390 ### Fixes
391
392 - Stop percent encoding header environment variables in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc` and `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#6392)
393 - Ensure the `noopSpan.tracerProvider` method is not inlined in `go.opentelemetry.io/otel/trace` so the `go.opentelemetry.io/auto` instrumentation can instrument non-recording spans. (#6456)
394 - Use a `sync.Pool` instead of allocating `metricdata.ResourceMetrics` in `go.opentelemetry.io/otel/exporters/prometheus`. (#6472)
395
396 ## [1.35.0/0.57.0/0.11.0] 2025-03-05
397
398 This release is the last to support [Go 1.22].
399 The next release will require at least [Go 1.23].
400
401 ### Added
402
403 - Add `ValueFromAttribute` and `KeyValueFromAttribute` in `go.opentelemetry.io/otel/log`. (#6180)
404 - Add `EventName` and `SetEventName` to `Record` in `go.opentelemetry.io/otel/log`. (#6187)
405 - Add `EventName` to `RecordFactory` in `go.opentelemetry.io/otel/log/logtest`. (#6187)
406 - `AssertRecordEqual` in `go.opentelemetry.io/otel/log/logtest` checks `Record.EventName`. (#6187)
407 - Add `EventName` and `SetEventName` to `Record` in `go.opentelemetry.io/otel/sdk/log`. (#6193)
408 - Add `EventName` to `RecordFactory` in `go.opentelemetry.io/otel/sdk/log/logtest`. (#6193)
409 - Emit `Record.EventName` field in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc`. (#6211)
410 - Emit `Record.EventName` field in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#6211)
411 - Emit `Record.EventName` field in `go.opentelemetry.io/otel/exporters/stdout/stdoutlog` (#6210)
412 - The `go.opentelemetry.io/otel/semconv/v1.28.0` package.
413 The package contains semantic conventions from the `v1.28.0` version of the OpenTelemetry Semantic Conventions.
414 See the [migration documentation](./semconv/v1.28.0/MIGRATION.md) for information on how to upgrade from `go.opentelemetry.io/otel/semconv/v1.27.0`(#6236)
415 - The `go.opentelemetry.io/otel/semconv/v1.30.0` package.
416 The package contains semantic conventions from the `v1.30.0` version of the OpenTelemetry Semantic Conventions.
417 See the [migration documentation](./semconv/v1.30.0/MIGRATION.md) for information on how to upgrade from `go.opentelemetry.io/otel/semconv/v1.28.0`(#6240)
418 - Document the pitfalls of using `Resource` as a comparable type.
419 `Resource.Equal` and `Resource.Equivalent` should be used instead. (#6272)
420 - Support [Go 1.24]. (#6304)
421 - Add `FilterProcessor` and `EnabledParameters` in `go.opentelemetry.io/otel/sdk/log`.
422 It replaces `go.opentelemetry.io/otel/sdk/log/internal/x.FilterProcessor`.
423 Compared to previous version it additionally gives the possibility to filter by resource and instrumentation scope. (#6317)
424
425 ### Changed
426
427 - Update `github.com/prometheus/common` to `v0.62.0`, which changes the `NameValidationScheme` to `NoEscaping`.
428 This allows metrics names to keep original delimiters (e.g. `.`), rather than replacing with underscores.
429 This is controlled by the `Content-Type` header, or can be reverted by setting `NameValidationScheme` to `LegacyValidation` in `github.com/prometheus/common/model`. (#6198)
430
431 ### Fixes
432
433 - Eliminate goroutine leak for the processor returned by `NewSimpleSpanProcessor` in `go.opentelemetry.io/otel/sdk/trace` when `Shutdown` is called and the passed `ctx` is canceled and `SpanExporter.Shutdown` has not returned. (#6368)
434 - Eliminate goroutine leak for the processor returned by `NewBatchSpanProcessor` in `go.opentelemetry.io/otel/sdk/trace` when `ForceFlush` is called and the passed `ctx` is canceled and `SpanExporter.Export` has not returned. (#6369)
435
436 ## [1.34.0/0.56.0/0.10.0] 2025-01-17
437
438 ### Changed
439
440 - Remove the notices from `Logger` to make the whole Logs API user-facing in `go.opentelemetry.io/otel/log`. (#6167)
441
442 ### Fixed
443
444 - Relax minimum Go version to 1.22.0 in various modules. (#6073)
445 - The `Type` name logged for the `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc` client is corrected from `otlphttpgrpc` to `otlptracegrpc`. (#6143)
446 - The `Type` name logged for the `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlphttpgrpc` client is corrected from `otlphttphttp` to `otlptracehttp`. (#6143)
447
448 ## [1.33.0/0.55.0/0.9.0/0.0.12] 2024-12-12
449
450 ### Added
451
452 - Add `Reset` method to `SpanRecorder` in `go.opentelemetry.io/otel/sdk/trace/tracetest`. (#5994)
453 - Add `EnabledInstrument` interface in `go.opentelemetry.io/otel/sdk/metric/internal/x`.
454 This is an experimental interface that is implemented by synchronous instruments provided by `go.opentelemetry.io/otel/sdk/metric`.
455 Users can use it to avoid performing computationally expensive operations when recording measurements.
456 It does not fall within the scope of the OpenTelemetry Go versioning and stability [policy](./VERSIONING.md) and it may be changed in backwards incompatible ways or removed in feature releases. (#6016)
457
458 ### Changed
459
460 - The default global API now supports full auto-instrumentation from the `go.opentelemetry.io/auto` package.
461 See that package for more information. (#5920)
462 - Propagate non-retryable error messages to client in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#5929)
463 - Propagate non-retryable error messages to client in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#5929)
464 - Propagate non-retryable error messages to client in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#5929)
465 - Performance improvements for attribute value `AsStringSlice`, `AsFloat64Slice`, `AsInt64Slice`, `AsBoolSlice`. (#6011)
466 - Change `EnabledParameters` to have a `Severity` field instead of a getter and setter in `go.opentelemetry.io/otel/log`. (#6009)
467
468 ### Fixed
469
470 - Fix inconsistent request body closing in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#5954)
471 - Fix inconsistent request body closing in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#5954)
472 - Fix inconsistent request body closing in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#5954)
473 - Fix invalid exemplar keys in `go.opentelemetry.io/otel/exporters/prometheus`. (#5995)
474 - Fix attribute value truncation in `go.opentelemetry.io/otel/sdk/trace`. (#5997)
475 - Fix attribute value truncation in `go.opentelemetry.io/otel/sdk/log`. (#6032)
476
477 ## [1.32.0/0.54.0/0.8.0/0.0.11] 2024-11-08
478
479 ### Added
480
481 - Add `go.opentelemetry.io/otel/sdk/metric/exemplar.AlwaysOffFilter`, which can be used to disable exemplar recording. (#5850)
482 - Add `go.opentelemetry.io/otel/sdk/metric.WithExemplarFilter`, which can be used to configure the exemplar filter used by the metrics SDK. (#5850)
483 - Add `ExemplarReservoirProviderSelector` and `DefaultExemplarReservoirProviderSelector` to `go.opentelemetry.io/otel/sdk/metric`, which defines the exemplar reservoir to use based on the aggregation of the metric. (#5861)
484 - Add `ExemplarReservoirProviderSelector` to `go.opentelemetry.io/otel/sdk/metric.Stream` to allow using views to configure the exemplar reservoir to use for a metric. (#5861)
485 - Add `ReservoirProvider`, `HistogramReservoirProvider` and `FixedSizeReservoirProvider` to `go.opentelemetry.io/otel/sdk/metric/exemplar` to make it convenient to use providers of Reservoirs. (#5861)
486 - The `go.opentelemetry.io/otel/semconv/v1.27.0` package.
487 The package contains semantic conventions from the `v1.27.0` version of the OpenTelemetry Semantic Conventions. (#5894)
488 - Add `Attributes attribute.Set` field to `Scope` in `go.opentelemetry.io/otel/sdk/instrumentation`. (#5903)
489 - Add `Attributes attribute.Set` field to `ScopeRecords` in `go.opentelemetry.io/otel/log/logtest`. (#5927)
490 - `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc` adds instrumentation scope attributes. (#5934)
491 - `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp` adds instrumentation scope attributes. (#5934)
492 - `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` adds instrumentation scope attributes. (#5935)
493 - `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp` adds instrumentation scope attributes. (#5935)
494 - `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc` adds instrumentation scope attributes. (#5933)
495 - `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp` adds instrumentation scope attributes. (#5933)
496 - `go.opentelemetry.io/otel/exporters/prometheus` adds instrumentation scope attributes in `otel_scope_info` metric as labels. (#5932)
497
498 ### Changed
499
500 - Support scope attributes and make them as identifying for `Tracer` in `go.opentelemetry.io/otel` and `go.opentelemetry.io/otel/sdk/trace`. (#5924)
501 - Support scope attributes and make them as identifying for `Meter` in `go.opentelemetry.io/otel` and `go.opentelemetry.io/otel/sdk/metric`. (#5926)
502 - Support scope attributes and make them as identifying for `Logger` in `go.opentelemetry.io/otel` and `go.opentelemetry.io/otel/sdk/log`. (#5925)
503 - Make schema URL and scope attributes as identifying for `Tracer` in `go.opentelemetry.io/otel/bridge/opentracing`. (#5931)
504 - Clear unneeded slice elements to allow GC to collect the objects in `go.opentelemetry.io/otel/sdk/metric` and `go.opentelemetry.io/otel/sdk/trace`. (#5804)
505
506 ### Fixed
507
508 - Global MeterProvider registration unwraps global instrument Observers, the undocumented Unwrap() methods are now private. (#5881)
509 - `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` now keeps the metadata already present in the context when `WithHeaders` is used. (#5892)
510 - `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc` now keeps the metadata already present in the context when `WithHeaders` is used. (#5911)
511 - `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc` now keeps the metadata already present in the context when `WithHeaders` is used. (#5915)
512 - Fix `go.opentelemetry.io/otel/exporters/prometheus` trying to add exemplars to Gauge metrics, which is unsupported. (#5912)
513 - Fix `WithEndpointURL` to always use a secure connection when an https URL is passed in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#5944)
514 - Fix `WithEndpointURL` to always use a secure connection when an https URL is passed in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#5944)
515 - Fix `WithEndpointURL` to always use a secure connection when an https URL is passed in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`. (#5944)
516 - Fix `WithEndpointURL` to always use a secure connection when an https URL is passed in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#5944)
517 - Fix incorrect metrics generated from callbacks when multiple readers are used in `go.opentelemetry.io/otel/sdk/metric`. (#5900)
518
519 ### Removed
520
521 - Remove all examples under `go.opentelemetry.io/otel/example` as they are moved to [Contrib repository](https://github.com/open-telemetry/opentelemetry-go-contrib/tree/main/examples). (#5930)
522
523 ## [1.31.0/0.53.0/0.7.0/0.0.10] 2024-10-11
524
525 ### Added
526
527 - Add `go.opentelemetry.io/otel/sdk/metric/exemplar` package which includes `Exemplar`, `Filter`, `TraceBasedFilter`, `AlwaysOnFilter`, `HistogramReservoir`, `FixedSizeReservoir`, `Reservoir`, `Value` and `ValueType` types. These will be used for configuring the exemplar reservoir for the metrics sdk. (#5747, #5862)
528 - Add `WithExportBufferSize` option to log batch processor.(#5877)
529
530 ### Changed
531
532 - Enable exemplars by default in `go.opentelemetry.io/otel/sdk/metric`. Exemplars can be disabled by setting `OTEL_METRICS_EXEMPLAR_FILTER=always_off` (#5778)
533 - `Logger.Enabled` in `go.opentelemetry.io/otel/log` now accepts a newly introduced `EnabledParameters` type instead of `Record`. (#5791)
534 - `FilterProcessor.Enabled` in `go.opentelemetry.io/otel/sdk/log/internal/x` now accepts `EnabledParameters` instead of `Record`. (#5791)
535 - The `Record` type in `go.opentelemetry.io/otel/log` is no longer comparable. (#5847)
536 - Performance improvements for the trace SDK `SetAttributes` method in `Span`. (#5864)
537 - Reduce memory allocations for the `Event` and `Link` lists in `Span`. (#5858)
538 - Performance improvements for the trace SDK `AddEvent`, `AddLink`, `RecordError` and `End` methods in `Span`. (#5874)
539
540 ### Deprecated
541
542 - Deprecate all examples under `go.opentelemetry.io/otel/example` as they are moved to [Contrib repository](https://github.com/open-telemetry/opentelemetry-go-contrib/tree/main/examples). (#5854)
543
544 ### Fixed
545
546 - The race condition for multiple `FixedSize` exemplar reservoirs identified in #5814 is resolved. (#5819)
547 - Fix log records duplication in case of heterogeneous resource attributes by correctly mapping each log record to it's resource and scope. (#5803)
548 - Fix timer channel drain to avoid hanging on Go 1.23. (#5868)
549 - Fix delegation for global meter providers, and panic when calling otel.SetMeterProvider. (#5827)
550 - Change the `reflect.TypeOf` to use a nil pointer to not allocate on the heap unless necessary. (#5827)
551
552 ## [1.30.0/0.52.0/0.6.0/0.0.9] 2024-09-09
553
554 ### Added
555
556 - Support `OTEL_EXPORTER_OTLP_LOGS_INSECURE` and `OTEL_EXPORTER_OTLP_INSECURE` environments in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc`. (#5739)
557 - The `WithResource` option for `NewMeterProvider` now merges the provided resources with the ones from environment variables. (#5773)
558 - The `WithResource` option for `NewLoggerProvider` now merges the provided resources with the ones from environment variables. (#5773)
559 - Add UTF-8 support to `go.opentelemetry.io/otel/exporters/prometheus`. (#5755)
560
561 ### Fixed
562
563 - Fix memory leak in the global `MeterProvider` when identical instruments are repeatedly created. (#5754)
564 - Fix panic on instruments creation when setting meter provider. (#5758)
565 - Fix an issue where `SetMeterProvider` in `go.opentelemetry.io/otel` might miss the delegation for instruments and registries. (#5780)
566
567 ### Removed
568
569 - Drop support for [Go 1.21]. (#5736, #5740, #5800)
570
571 ## [1.29.0/0.51.0/0.5.0] 2024-08-23
572
573 This release is the last to support [Go 1.21].
574 The next release will require at least [Go 1.22].
575
576 ### Added
577
578 - Add MacOS ARM64 platform to the compatibility testing suite. (#5577)
579 - Add `InstrumentationScope` field to `SpanStub` in `go.opentelemetry.io/otel/sdk/trace/tracetest`, as a replacement for the deprecated `InstrumentationLibrary`. (#5627)
580 - Make the initial release of `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc`.
581 This new module contains an OTLP exporter that transmits log telemetry using gRPC.
582 This module is unstable and breaking changes may be introduced.
583 See our [versioning policy](VERSIONING.md) for more information about these stability guarantees. (#5629)
584 - Add `Walk` function to `TraceState` in `go.opentelemetry.io/otel/trace` to iterate all the key-value pairs. (#5651)
585 - Bridge the trace state in `go.opentelemetry.io/otel/bridge/opencensus`. (#5651)
586 - Zero value of `SimpleProcessor` in `go.opentelemetry.io/otel/sdk/log` no longer panics. (#5665)
587 - The `FilterProcessor` interface type is added in `go.opentelemetry.io/otel/sdk/log/internal/x`.
588 This is an optional and experimental interface that log `Processor`s can implement to instruct the `Logger` if a `Record` will be processed or not.
589 It replaces the existing `Enabled` method that is removed from the `Processor` interface itself.
590 It does not fall within the scope of the OpenTelemetry Go versioning and stability [policy](./VERSIONING.md) and it may be changed in backwards incompatible ways or removed in feature releases. (#5692)
591 - Support [Go 1.23]. (#5720)
592
593 ### Changed
594
595 - `NewMemberRaw`, `NewKeyProperty` and `NewKeyValuePropertyRaw` in `go.opentelemetry.io/otel/baggage` allow UTF-8 string in key. (#5132)
596 - `Processor.OnEmit` in `go.opentelemetry.io/otel/sdk/log` now accepts a pointer to `Record` instead of a value so that the record modifications done in a processor are propagated to subsequent registered processors. (#5636)
597 - `SimpleProcessor.Enabled` in `go.opentelemetry.io/otel/sdk/log` now returns `false` if the exporter is `nil`. (#5665)
598 - Update the concurrency requirements of `Exporter` in `go.opentelemetry.io/otel/sdk/log`. (#5666)
599 - `SimpleProcessor` in `go.opentelemetry.io/otel/sdk/log` synchronizes `OnEmit` calls. (#5666)
600 - The `Processor` interface in `go.opentelemetry.io/otel/sdk/log` no longer includes the `Enabled` method.
601 See the `FilterProcessor` interface type added in `go.opentelemetry.io/otel/sdk/log/internal/x` to continue providing this functionality. (#5692)
602 - The `SimpleProcessor` type in `go.opentelemetry.io/otel/sdk/log` is no longer comparable. (#5693)
603 - The `BatchProcessor` type in `go.opentelemetry.io/otel/sdk/log` is no longer comparable. (#5693)
604
605 ### Fixed
606
607 - Correct comments for the priority of the `WithEndpoint` and `WithEndpointURL` options and their corresponding environment variables in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#5584)
608 - Pass the underlying error rather than a generic retry-able failure in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`, `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp` and `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#5541)
609 - Correct the `Tracer`, `Meter`, and `Logger` names used in `go.opentelemetry.io/otel/example/dice`. (#5612)
610 - Correct the `Tracer` names used in `go.opentelemetry.io/otel/example/namedtracer`. (#5612)
611 - Correct the `Tracer` name used in `go.opentelemetry.io/otel/example/opencensus`. (#5612)
612 - Correct the `Tracer` and `Meter` names used in `go.opentelemetry.io/otel/example/otel-collector`. (#5612)
613 - Correct the `Tracer` names used in `go.opentelemetry.io/otel/example/passthrough`. (#5612)
614 - Correct the `Meter` name used in `go.opentelemetry.io/otel/example/prometheus`. (#5612)
615 - Correct the `Tracer` names used in `go.opentelemetry.io/otel/example/zipkin`. (#5612)
616 - Correct comments for the priority of the `WithEndpoint` and `WithEndpointURL` options and their corresponding environment variables in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` and `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#5641)
617 - Correct comments for the priority of the `WithEndpoint` and `WithEndpointURL` options and their corresponding environment variables in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#5650)
618 - Stop percent encoding header environment variables in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`, `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`, `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` and `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp` (#5705)
619 - Remove invalid environment variable header keys in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`, `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`, `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` and `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp` (#5705)
620
621 ### Removed
622
623 - The `Enabled` method of the `SimpleProcessor` in `go.opentelemetry.io/otel/sdk/log` is removed. (#5692)
624 - The `Enabled` method of the `BatchProcessor` in `go.opentelemetry.io/otel/sdk/log` is removed. (#5692)
625
626 ## [1.28.0/0.50.0/0.4.0] 2024-07-02
627
628 ### Added
629
630 - The `IsEmpty` method is added to the `Instrument` type in `go.opentelemetry.io/otel/sdk/metric`.
631 This method is used to check if an `Instrument` instance is a zero-value. (#5431)
632 - Store and provide the emitted `context.Context` in `ScopeRecords` of `go.opentelemetry.io/otel/sdk/log/logtest`. (#5468)
633 - The `go.opentelemetry.io/otel/semconv/v1.26.0` package.
634 The package contains semantic conventions from the `v1.26.0` version of the OpenTelemetry Semantic Conventions. (#5476)
635 - The `AssertRecordEqual` method to `go.opentelemetry.io/otel/log/logtest` to allow comparison of two log records in tests. (#5499)
636 - The `WithHeaders` option to `go.opentelemetry.io/otel/exporters/zipkin` to allow configuring custom http headers while exporting spans. (#5530)
637
638 ### Changed
639
640 - `Tracer.Start` in `go.opentelemetry.io/otel/trace/noop` no longer allocates a span for empty span context. (#5457)
641 - Upgrade `go.opentelemetry.io/otel/semconv/v1.25.0` to `go.opentelemetry.io/otel/semconv/v1.26.0` in `go.opentelemetry.io/otel/example/otel-collector`. (#5490)
642 - Upgrade `go.opentelemetry.io/otel/semconv/v1.25.0` to `go.opentelemetry.io/otel/semconv/v1.26.0` in `go.opentelemetry.io/otel/example/zipkin`. (#5490)
643 - Upgrade `go.opentelemetry.io/otel/semconv/v1.25.0` to `go.opentelemetry.io/otel/semconv/v1.26.0` in `go.opentelemetry.io/otel/exporters/zipkin`. (#5490)
644 - The exporter no longer exports the deprecated "otel.library.name" or "otel.library.version" attributes.
645 - Upgrade `go.opentelemetry.io/otel/semconv/v1.25.0` to `go.opentelemetry.io/otel/semconv/v1.26.0` in `go.opentelemetry.io/otel/sdk/resource`. (#5490)
646 - Upgrade `go.opentelemetry.io/otel/semconv/v1.25.0` to `go.opentelemetry.io/otel/semconv/v1.26.0` in `go.opentelemetry.io/otel/sdk/trace`. (#5490)
647 - `SimpleProcessor.OnEmit` in `go.opentelemetry.io/otel/sdk/log` no longer allocates a slice which makes it possible to have a zero-allocation log processing using `SimpleProcessor`. (#5493)
648 - Use non-generic functions in the `Start` method of `"go.opentelemetry.io/otel/sdk/trace".Trace` to reduce memory allocation. (#5497)
649 - `service.instance.id` is populated for a `Resource` created with `"go.opentelemetry.io/otel/sdk/resource".Default` with a default value when `OTEL_GO_X_RESOURCE` is set. (#5520)
650 - Improve performance of metric instruments in `go.opentelemetry.io/otel/sdk/metric` by removing unnecessary calls to `time.Now`. (#5545)
651
652 ### Fixed
653
654 - Log a warning to the OpenTelemetry internal logger when a `Record` in `go.opentelemetry.io/otel/sdk/log` drops an attribute due to a limit being reached. (#5376)
655 - Identify the `Tracer` returned from the global `TracerProvider` in `go.opentelemetry.io/otel/global` with its schema URL. (#5426)
656 - Identify the `Meter` returned from the global `MeterProvider` in `go.opentelemetry.io/otel/global` with its schema URL. (#5426)
657 - Log a warning to the OpenTelemetry internal logger when a `Span` in `go.opentelemetry.io/otel/sdk/trace` drops an attribute, event, or link due to a limit being reached. (#5434)
658 - Document instrument name requirements in `go.opentelemetry.io/otel/metric`. (#5435)
659 - Prevent random number generation data-race for experimental rand exemplars in `go.opentelemetry.io/otel/sdk/metric`. (#5456)
660 - Fix counting number of dropped attributes of `Record` in `go.opentelemetry.io/otel/sdk/log`. (#5464)
661 - Fix panic in baggage creation when a member contains `0x80` char in key or value. (#5494)
662 - Correct comments for the priority of the `WithEndpoint` and `WithEndpointURL` options and their corresponding environment variables in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`. (#5508)
663 - Retry trace and span ID generation if it generated an invalid one in `go.opentelemetry.io/otel/sdk/trace`. (#5514)
664 - Fix stale timestamps reported by the last-value aggregation. (#5517)
665 - Indicate the `Exporter` in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp` must be created by the `New` method. (#5521)
666 - Improved performance in all `{Bool,Int64,Float64,String}SliceValue` functions of `go.opentelemetry.io/attributes` by reducing the number of allocations. (#5549)
667 - Replace invalid percent-encoded octet sequences with replacement char in `go.opentelemetry.io/otel/baggage`. (#5528)
668
669 ## [1.27.0/0.49.0/0.3.0] 2024-05-21
670
671 ### Added
672
673 - Add example for `go.opentelemetry.io/otel/exporters/stdout/stdoutlog`. (#5242)
674 - Add `RecordFactory` in `go.opentelemetry.io/otel/sdk/log/logtest` to facilitate testing exporter and processor implementations. (#5258)
675 - Add `RecordFactory` in `go.opentelemetry.io/otel/log/logtest` to facilitate testing bridge implementations. (#5263)
676 - The count of dropped records from the `BatchProcessor` in `go.opentelemetry.io/otel/sdk/log` is logged. (#5276)
677 - Add metrics in the `otel-collector` example. (#5283)
678 - Add the synchronous gauge instrument to `go.opentelemetry.io/otel/metric`. (#5304)
679 - An `int64` or `float64` synchronous gauge instrument can now be created from a `Meter`.
680 - All implementations of the API (`go.opentelemetry.io/otel/metric/noop`, `go.opentelemetry.io/otel/sdk/metric`) are updated to support this instrument.
681 - Add logs to `go.opentelemetry.io/otel/example/dice`. (#5349)
682
683 ### Changed
684
685 - The `Shutdown` method of `Exporter` in `go.opentelemetry.io/otel/exporters/stdout/stdouttrace` ignores the context cancellation and always returns `nil`. (#5189)
686 - The `ForceFlush` and `Shutdown` methods of the exporter returned by `New` in `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric` ignore the context cancellation and always return `nil`. (#5189)
687 - Apply the value length limits to `Record` attributes in `go.opentelemetry.io/otel/sdk/log`. (#5230)
688 - De-duplicate map attributes added to a `Record` in `go.opentelemetry.io/otel/sdk/log`. (#5230)
689 - `go.opentelemetry.io/otel/exporters/stdout/stdoutlog` won't print timestamps when `WithoutTimestamps` option is set. (#5241)
690 - The `go.opentelemetry.io/otel/exporters/stdout/stdoutlog` exporter won't print `AttributeValueLengthLimit` and `AttributeCountLimit` fields now, instead it prints the `DroppedAttributes` field. (#5272)
691 - Improved performance in the `Stringer` implementation of `go.opentelemetry.io/otel/baggage.Member` by reducing the number of allocations. (#5286)
692 - Set the start time for last-value aggregates in `go.opentelemetry.io/otel/sdk/metric`. (#5305)
693 - The `Span` in `go.opentelemetry.io/otel/sdk/trace` will record links without span context if either non-empty `TraceState` or attributes are provided. (#5315)
694 - Upgrade all dependencies of `go.opentelemetry.io/otel/semconv/v1.24.0` to `go.opentelemetry.io/otel/semconv/v1.25.0`. (#5374)
695
696 ### Fixed
697
698 - Comparison of unordered maps for `go.opentelemetry.io/otel/log.KeyValue` and `go.opentelemetry.io/otel/log.Value`. (#5306)
699 - Fix the empty output of `go.opentelemetry.io/otel/log.Value` in `go.opentelemetry.io/otel/exporters/stdout/stdoutlog`. (#5311)
700 - Split the behavior of `Recorder` in `go.opentelemetry.io/otel/log/logtest` so it behaves as a `LoggerProvider` only. (#5365)
701 - Fix wrong package name of the error message when parsing endpoint URL in `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`. (#5371)
702 - Identify the `Logger` returned from the global `LoggerProvider` in `go.opentelemetry.io/otel/log/global` with its schema URL. (#5375)
703
704 ## [1.26.0/0.48.0/0.2.0-alpha] 2024-04-24
705
706 ### Added
707
708 - Add `Recorder` in `go.opentelemetry.io/otel/log/logtest` to facilitate testing the log bridge implementations. (#5134)
709 - Add span flags to OTLP spans and links exported by `go.opentelemetry.io/otel/exporters/otlp/otlptrace`. (#5194)
710 - Make the initial alpha release of `go.opentelemetry.io/otel/sdk/log`.
711 This new module contains the Go implementation of the OpenTelemetry Logs SDK.
712 This module is unstable and breaking changes may be introduced.
713 See our [versioning policy](VERSIONING.md) for more information about these stability guarantees. (#5240)
714 - Make the initial alpha release of `go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp`.
715 This new module contains an OTLP exporter that transmits log telemetry using HTTP.
716 This module is unstable and breaking changes may be introduced.
717 See our [versioning policy](VERSIONING.md) for more information about these stability guarantees. (#5240)
718 - Make the initial alpha release of `go.opentelemetry.io/otel/exporters/stdout/stdoutlog`.
719 This new module contains an exporter prints log records to STDOUT.
720 This module is unstable and breaking changes may be introduced.
721 See our [versioning policy](VERSIONING.md) for more information about these stability guarantees. (#5240)
722 - The `go.opentelemetry.io/otel/semconv/v1.25.0` package.
723 The package contains semantic conventions from the `v1.25.0` version of the OpenTelemetry Semantic Conventions. (#5254)
724
725 ### Changed
726
727 - Update `go.opentelemetry.io/proto/otlp` from v1.1.0 to v1.2.0. (#5177)
728 - Improve performance of baggage member character validation in `go.opentelemetry.io/otel/baggage`. (#5214)
729 - The `otel-collector` example now uses docker compose to bring up services instead of kubernetes. (#5244)
730
731 ### Fixed
732
733 - Slice attribute values in `go.opentelemetry.io/otel/attribute` are now emitted as their JSON representation. (#5159)
734
735 ## [1.25.0/0.47.0/0.0.8/0.1.0-alpha] 2024-04-05
736
737 ### Added
738
739 - Add `WithProxy` option in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#4906)
740 - Add `WithProxy` option in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlptracehttp`. (#4906)
741 - Add `AddLink` method to the `Span` interface in `go.opentelemetry.io/otel/trace`. (#5032)
742 - The `Enabled` method is added to the `Logger` interface in `go.opentelemetry.io/otel/log`.
743 This method is used to notify users if a log record will be emitted or not. (#5071)
744 - Add `SeverityUndefined` `const` to `go.opentelemetry.io/otel/log`.
745 This value represents an unset severity level. (#5072)
746 - Add `Empty` function in `go.opentelemetry.io/otel/log` to return a `KeyValue` for an empty value. (#5076)
747 - Add `go.opentelemetry.io/otel/log/global` to manage the global `LoggerProvider`.
748 This package is provided with the anticipation that all functionality will be migrate to `go.opentelemetry.io/otel` when `go.opentelemetry.io/otel/log` stabilizes.
749 At which point, users will be required to migrage their code, and this package will be deprecated then removed. (#5085)
750 - Add support for `Summary` metrics in the `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp` and `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` exporters. (#5100)
751 - Add `otel.scope.name` and `otel.scope.version` tags to spans exported by `go.opentelemetry.io/otel/exporters/zipkin`. (#5108)
752 - Add support for `AddLink` to `go.opentelemetry.io/otel/bridge/opencensus`. (#5116)
753 - Add `String` method to `Value` and `KeyValue` in `go.opentelemetry.io/otel/log`. (#5117)
754 - Add Exemplar support to `go.opentelemetry.io/otel/exporters/prometheus`. (#5111)
755 - Add metric semantic conventions to `go.opentelemetry.io/otel/semconv/v1.24.0`. Future `semconv` packages will include metric semantic conventions as well. (#4528)
756
757 ### Changed
758
759 - `SpanFromContext` and `SpanContextFromContext` in `go.opentelemetry.io/otel/trace` no longer make a heap allocation when the passed context has no span. (#5049)
760 - `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc` and `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` now create a gRPC client in idle mode and with "dns" as the default resolver using [`grpc.NewClient`](https://pkg.go.dev/google.golang.org/grpc#NewClient). (#5151)
761 Because of that `WithDialOption` ignores [`grpc.WithBlock`](https://pkg.go.dev/google.golang.org/grpc#WithBlock), [`grpc.WithTimeout`](https://pkg.go.dev/google.golang.org/grpc#WithTimeout), and [`grpc.WithReturnConnectionError`](https://pkg.go.dev/google.golang.org/grpc#WithReturnConnectionError).
762 Notice that [`grpc.DialContext`](https://pkg.go.dev/google.golang.org/grpc#DialContext) which was used before is now deprecated.
763
764 ### Fixed
765
766 - Clarify the documentation about equivalence guarantees for the `Set` and `Distinct` types in `go.opentelemetry.io/otel/attribute`. (#5027)
767 - Prevent default `ErrorHandler` self-delegation. (#5137)
768 - Update all dependencies to address [GO-2024-2687]. (#5139)
769
770 ### Removed
771
772 - Drop support for [Go 1.20]. (#4967)
773
774 ### Deprecated
775
776 - Deprecate `go.opentelemetry.io/otel/attribute.Sortable` type. (#4734)
777 - Deprecate `go.opentelemetry.io/otel/attribute.NewSetWithSortable` function. (#4734)
778 - Deprecate `go.opentelemetry.io/otel/attribute.NewSetWithSortableFiltered` function. (#4734)
779
780 ## [1.24.0/0.46.0/0.0.1-alpha] 2024-02-23
781
782 This release is the last to support [Go 1.20].
783 The next release will require at least [Go 1.21].
784
785 ### Added
786
787 - Support [Go 1.22]. (#4890)
788 - Add exemplar support to `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#4900)
789 - Add exemplar support to `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#4900)
790 - The `go.opentelemetry.io/otel/log` module is added.
791 This module includes OpenTelemetry Go's implementation of the Logs Bridge API.
792 This module is in an alpha state, it is subject to breaking changes.
793 See our [versioning policy](./VERSIONING.md) for more info. (#4961)
794 - Add ARM64 platform to the compatibility testing suite. (#4994)
795
796 ### Fixed
797
798 - Fix registration of multiple callbacks when using the global meter provider from `go.opentelemetry.io/otel`. (#4945)
799 - Fix negative buckets in output of exponential histograms. (#4956)
800
801 ## [1.23.1] 2024-02-07
802
803 ### Fixed
804
805 - Register all callbacks passed during observable instrument creation instead of just the last one multiple times in `go.opentelemetry.io/otel/sdk/metric`. (#4888)
806
807 ## [1.23.0] 2024-02-06
808
809 This release contains the first stable, `v1`, release of the following modules:
810
811 - `go.opentelemetry.io/otel/bridge/opencensus`
812 - `go.opentelemetry.io/otel/bridge/opencensus/test`
813 - `go.opentelemetry.io/otel/example/opencensus`
814 - `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`
815 - `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`
816 - `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric`
817
818 See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
819
820 ### Added
821
822 - Add `WithEndpointURL` option to the `exporters/otlp/otlpmetric/otlpmetricgrpc`, `exporters/otlp/otlpmetric/otlpmetrichttp`, `exporters/otlp/otlptrace/otlptracegrpc` and `exporters/otlp/otlptrace/otlptracehttp` packages. (#4808)
823 - Experimental exemplar exporting is added to the metric SDK.
824 See [metric documentation](./sdk/metric/internal/x/README.md#exemplars) for more information about this feature and how to enable it. (#4871)
825 - `ErrSchemaURLConflict` is added to `go.opentelemetry.io/otel/sdk/resource`.
826 This error is returned when a merge of two `Resource`s with different (non-empty) schema URL is attempted. (#4876)
827
828 ### Changed
829
830 - The `Merge` and `New` functions in `go.opentelemetry.io/otel/sdk/resource` now returns a partial result if there is a schema URL merge conflict.
831 Instead of returning `nil` when two `Resource`s with different (non-empty) schema URLs are merged the merged `Resource`, along with the new `ErrSchemaURLConflict` error, is returned.
832 It is up to the user to decide if they want to use the returned `Resource` or not.
833 It may have desired attributes overwritten or include stale semantic conventions. (#4876)
834
835 ### Fixed
836
837 - Fix `ContainerID` resource detection on systemd when cgroup path has a colon. (#4449)
838 - Fix `go.opentelemetry.io/otel/sdk/metric` to cache instruments to avoid leaking memory when the same instrument is created multiple times. (#4820)
839 - Fix missing `Mix` and `Max` values for `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric` by introducing `MarshalText` and `MarshalJSON` for the `Extrema` type in `go.opentelemetry.io/sdk/metric/metricdata`. (#4827)
840
841 ## [1.23.0-rc.1] 2024-01-18
842
843 This is a release candidate for the v1.23.0 release.
844 That release is expected to include the `v1` release of the following modules:
845
846 - `go.opentelemetry.io/otel/bridge/opencensus`
847 - `go.opentelemetry.io/otel/bridge/opencensus/test`
848 - `go.opentelemetry.io/otel/example/opencensus`
849 - `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`
850 - `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`
851 - `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric`
852
853 See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
854
855 ## [1.22.0/0.45.0] 2024-01-17
856
857 ### Added
858
859 - The `go.opentelemetry.io/otel/semconv/v1.22.0` package.
860 The package contains semantic conventions from the `v1.22.0` version of the OpenTelemetry Semantic Conventions. (#4735)
861 - The `go.opentelemetry.io/otel/semconv/v1.23.0` package.
862 The package contains semantic conventions from the `v1.23.0` version of the OpenTelemetry Semantic Conventions. (#4746)
863 - The `go.opentelemetry.io/otel/semconv/v1.23.1` package.
864 The package contains semantic conventions from the `v1.23.1` version of the OpenTelemetry Semantic Conventions. (#4749)
865 - The `go.opentelemetry.io/otel/semconv/v1.24.0` package.
866 The package contains semantic conventions from the `v1.24.0` version of the OpenTelemetry Semantic Conventions. (#4770)
867 - Add `WithResourceAsConstantLabels` option to apply resource attributes for every metric emitted by the Prometheus exporter. (#4733)
868 - Experimental cardinality limiting is added to the metric SDK.
869 See [metric documentation](./sdk/metric/internal/x/README.md#cardinality-limit) for more information about this feature and how to enable it. (#4457)
870 - Add `NewMemberRaw` and `NewKeyValuePropertyRaw` in `go.opentelemetry.io/otel/baggage`. (#4804)
871
872 ### Changed
873
874 - Upgrade all use of `go.opentelemetry.io/otel/semconv` to use `v1.24.0`. (#4754)
875 - Update transformations in `go.opentelemetry.io/otel/exporters/zipkin` to follow `v1.24.0` version of the OpenTelemetry specification. (#4754)
876 - Record synchronous measurements when the passed context is canceled instead of dropping in `go.opentelemetry.io/otel/sdk/metric`.
877 If you do not want to make a measurement when the context is cancelled, you need to handle it yourself (e.g `if ctx.Err() != nil`). (#4671)
878 - Improve `go.opentelemetry.io/otel/trace.TraceState`'s performance. (#4722)
879 - Improve `go.opentelemetry.io/otel/propagation.TraceContext`'s performance. (#4721)
880 - Improve `go.opentelemetry.io/otel/baggage` performance. (#4743)
881 - Improve performance of the `(*Set).Filter` method in `go.opentelemetry.io/otel/attribute` when the passed filter does not filter out any attributes from the set. (#4774)
882 - `Member.String` in `go.opentelemetry.io/otel/baggage` percent-encodes only when necessary. (#4775)
883 - Improve `go.opentelemetry.io/otel/trace.Span`'s performance when adding multiple attributes. (#4818)
884 - `Property.Value` in `go.opentelemetry.io/otel/baggage` now returns a raw string instead of a percent-encoded value. (#4804)
885
886 ### Fixed
887
888 - Fix `Parse` in `go.opentelemetry.io/otel/baggage` to validate member value before percent-decoding. (#4755)
889 - Fix whitespace encoding of `Member.String` in `go.opentelemetry.io/otel/baggage`. (#4756)
890 - Fix observable not registered error when the asynchronous instrument has a drop aggregation in `go.opentelemetry.io/otel/sdk/metric`. (#4772)
891 - Fix baggage item key so that it is not canonicalized in `go.opentelemetry.io/otel/bridge/opentracing`. (#4776)
892 - Fix `go.opentelemetry.io/otel/bridge/opentracing` to properly handle baggage values that requires escaping during propagation. (#4804)
893 - Fix a bug where using multiple readers resulted in incorrect asynchronous counter values in `go.opentelemetry.io/otel/sdk/metric`. (#4742)
894
895 ## [1.21.0/0.44.0] 2023-11-16
896
897 ### Removed
898
899 - Remove the deprecated `go.opentelemetry.io/otel/bridge/opencensus.NewTracer`. (#4706)
900 - Remove the deprecated `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` module. (#4707)
901 - Remove the deprecated `go.opentelemetry.io/otel/example/view` module. (#4708)
902 - Remove the deprecated `go.opentelemetry.io/otel/example/fib` module. (#4723)
903
904 ### Fixed
905
906 - Do not parse non-protobuf responses in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#4719)
907 - Do not parse non-protobuf responses in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#4719)
908
909 ## [1.20.0/0.43.0] 2023-11-10
910
911 This 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. Implementers 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.
912
913 ### Added
914
915 - Add `go.opentelemetry.io/otel/bridge/opencensus.InstallTraceBridge`, which installs the OpenCensus trace bridge, and replaces `opencensus.NewTracer`. (#4567)
916 - Add scope version to trace and metric bridges in `go.opentelemetry.io/otel/bridge/opencensus`. (#4584)
917 - Add the `go.opentelemetry.io/otel/trace/embedded` package to be embedded in the exported trace API interfaces. (#4620)
918 - Add the `go.opentelemetry.io/otel/trace/noop` package as a default no-op implementation of the trace API. (#4620)
919 - Add context propagation in `go.opentelemetry.io/otel/example/dice`. (#4644)
920 - Add view configuration to `go.opentelemetry.io/otel/example/prometheus`. (#4649)
921 - Add `go.opentelemetry.io/otel/metric.WithExplicitBucketBoundaries`, which allows defining default explicit bucket boundaries when creating histogram instruments. (#4603)
922 - Add `Version` function in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#4660)
923 - Add `Version` function in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#4660)
924 - Add Summary, SummaryDataPoint, and QuantileValue to `go.opentelemetry.io/sdk/metric/metricdata`. (#4622)
925 - `go.opentelemetry.io/otel/bridge/opencensus.NewMetricProducer` now supports exemplars from OpenCensus. (#4585)
926 - Add support for `WithExplicitBucketBoundaries` in `go.opentelemetry.io/otel/sdk/metric`. (#4605)
927 - Add support for Summary metrics in `go.opentelemetry.io/otel/bridge/opencensus`. (#4668)
928
929 ### Deprecated
930
931 - Deprecate `go.opentelemetry.io/otel/bridge/opencensus.NewTracer` in favor of `opencensus.InstallTraceBridge`. (#4567)
932 - Deprecate `go.opentelemetry.io/otel/example/fib` package is in favor of `go.opentelemetry.io/otel/example/dice`. (#4618)
933 - Deprecate `go.opentelemetry.io/otel/trace.NewNoopTracerProvider`.
934 Use the added `NewTracerProvider` function in `go.opentelemetry.io/otel/trace/noop` instead. (#4620)
935 - Deprecate `go.opentelemetry.io/otel/example/view` package in favor of `go.opentelemetry.io/otel/example/prometheus`. (#4649)
936 - Deprecate `go.opentelemetry.io/otel/exporters/otlp/otlpmetric`. (#4693)
937
938 ### Changed
939
940 - `go.opentelemetry.io/otel/bridge/opencensus.NewMetricProducer` returns a `*MetricProducer` struct instead of the metric.Producer interface. (#4583)
941 - The `TracerProvider` in `go.opentelemetry.io/otel/trace` now embeds the `go.opentelemetry.io/otel/trace/embedded.TracerProvider` type.
942 This extends the `TracerProvider` interface and is is a breaking change for any existing implementation.
943 Implementers need to update their implementations based on what they want the default behavior of the interface to be.
944 See the "API Implementations" section of the `go.opentelemetry.io/otel/trace` package documentation for more information about how to accomplish this. (#4620)
945 - The `Tracer` in `go.opentelemetry.io/otel/trace` now embeds the `go.opentelemetry.io/otel/trace/embedded.Tracer` type.
946 This extends the `Tracer` interface and is is a breaking change for any existing implementation.
947 Implementers need to update their implementations based on what they want the default behavior of the interface to be.
948 See the "API Implementations" section of the `go.opentelemetry.io/otel/trace` package documentation for more information about how to accomplish this. (#4620)
949 - The `Span` in `go.opentelemetry.io/otel/trace` now embeds the `go.opentelemetry.io/otel/trace/embedded.Span` type.
950 This extends the `Span` interface and is is a breaking change for any existing implementation.
951 Implementers need to update their implementations based on what they want the default behavior of the interface to be.
952 See the "API Implementations" section of the `go.opentelemetry.io/otel/trace` package documentation for more information about how to accomplish this. (#4620)
953 - `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` does no longer depend on `go.opentelemetry.io/otel/exporters/otlp/otlpmetric`. (#4660)
954 - `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp` does no longer depend on `go.opentelemetry.io/otel/exporters/otlp/otlpmetric`. (#4660)
955 - Retry for `502 Bad Gateway` and `504 Gateway Timeout` HTTP statuses in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#4670)
956 - Retry for `502 Bad Gateway` and `504 Gateway Timeout` HTTP statuses in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#4670)
957 - Retry for `RESOURCE_EXHAUSTED` only if RetryInfo is returned in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#4669)
958 - Retry for `RESOURCE_EXHAUSTED` only if RetryInfo is returned in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`. (#4669)
959 - Retry temporary HTTP request failures in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#4679)
960 - Retry temporary HTTP request failures in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`. (#4679)
961
962 ### Fixed
963
964 - Fix improper parsing of characters such us `+`, `/` by `Parse` in `go.opentelemetry.io/otel/baggage` as they were rendered as a whitespace. (#4667)
965 - 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)
966 - 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)
967 - 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)
968 - 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)
969 - 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)
970 - In `go.opentelemetry.op/otel/exporters/prometheus`, the exporter no longer `Collect`s metrics after `Shutdown` is invoked. (#4648)
971 - Fix documentation for `WithCompressor` in `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc`. (#4695)
972 - Fix documentation for `WithCompressor` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#4695)
973
974 ## [1.19.0/0.42.0/0.0.7] 2023-09-28
975
976 This release contains the first stable release of the OpenTelemetry Go [metric SDK].
977 Our project stability guarantees now apply to the `go.opentelemetry.io/otel/sdk/metric` package.
978 See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
979
980 ### Added
981
982 - Add the "Roll the dice" getting started application example in `go.opentelemetry.io/otel/example/dice`. (#4539)
983 - 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)
984
985 ### Changed
986
987 - Allow '/' characters in metric instrument names. (#4501)
988 - The exporter in `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric` does not prettify its output by default anymore. (#4507)
989 - Upgrade `gopkg.io/yaml` from `v2` to `v3` in `go.opentelemetry.io/otel/schema`. (#4535)
990
991 ### Fixed
992
993 - 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)
994
995 ### Removed
996
997 - Remove `"go.opentelemetry.io/otel/bridge/opencensus".NewMetricExporter`, which is replaced by `NewMetricProducer`. (#4566)
998
999 ## [1.19.0-rc.1/0.42.0-rc.1] 2023-09-14
1000
1001 This is a release candidate for the v1.19.0/v0.42.0 release.
1002 That release is expected to include the `v1` release of the OpenTelemetry Go metric SDK and will provide stability guarantees of that SDK.
1003 See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
1004
1005 ### Changed
1006
1007 - Allow '/' characters in metric instrument names. (#4501)
1008
1009 ### Fixed
1010
1011 - 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)
1012
1013 ## [1.18.0/0.41.0/0.0.6] 2023-09-12
1014
1015 This release drops the compatibility guarantee of [Go 1.19].
1016
1017 ### Added
1018
1019 - 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)
1020 - Add `IgnoreValue` option in `go.opentelemetry.io/otel/sdk/metric/metricdata/metricdatatest` to allow ignoring values when comparing metrics. (#4447)
1021
1022 ### Changed
1023
1024 - Use a `TestingT` interface instead of `*testing.T` struct in `go.opentelemetry.io/otel/sdk/metric/metricdata/metricdatatest`. (#4483)
1025
1026 ### Deprecated
1027
1028 - The `NewMetricExporter` in `go.opentelemetry.io/otel/bridge/opencensus` was deprecated in `v0.35.0` (#3541).
1029 The deprecation notice format for the function has been corrected to trigger Go documentation and build tooling. (#4470)
1030
1031 ### Removed
1032
1033 - Removed the deprecated `go.opentelemetry.io/otel/exporters/jaeger` package. (#4467)
1034 - Removed the deprecated `go.opentelemetry.io/otel/example/jaeger` package. (#4467)
1035 - Removed the deprecated `go.opentelemetry.io/otel/sdk/metric/aggregation` package. (#4468)
1036 - Removed the deprecated internal packages in `go.opentelemetry.io/otel/exporters/otlp` and its sub-packages. (#4469)
1037 - Dropped guaranteed support for versions of Go less than 1.20. (#4481)
1038
1039 ## [1.17.0/0.40.0/0.0.5] 2023-08-28
1040
1041 ### Added
1042
1043 - Export the `ManualReader` struct in `go.opentelemetry.io/otel/sdk/metric`. (#4244)
1044 - Export the `PeriodicReader` struct in `go.opentelemetry.io/otel/sdk/metric`. (#4244)
1045 - Add support for exponential histogram aggregations.
1046 A histogram can be configured as an exponential histogram using a view with `"go.opentelemetry.io/otel/sdk/metric".ExponentialHistogram` as the aggregation. (#4245)
1047 - Export the `Exporter` struct in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc`. (#4272)
1048 - Export the `Exporter` struct in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp`. (#4272)
1049 - The exporters in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` now support the `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` environment variable. (#4287)
1050 - Add `WithoutCounterSuffixes` option in `go.opentelemetry.io/otel/exporters/prometheus` to disable addition of `_total` suffixes. (#4306)
1051 - Add info and debug logging to the metric SDK in `go.opentelemetry.io/otel/sdk/metric`. (#4315)
1052 - The `go.opentelemetry.io/otel/semconv/v1.21.0` package.
1053 The package contains semantic conventions from the `v1.21.0` version of the OpenTelemetry Semantic Conventions. (#4362)
1054 - 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)
1055 - Document the `Temporality` and `Aggregation` methods of the `"go.opentelemetry.io/otel/sdk/metric".Exporter"` need to be concurrent safe. (#4381)
1056 - 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)
1057 - Move the `Aggregation` interface and its implementations from `go.opentelemetry.io/otel/sdk/metric/aggregation` to `go.opentelemetry.io/otel/sdk/metric`. (#4435)
1058 - The exporters in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` now support the `OTEL_EXPORTER_OTLP_METRICS_DEFAULT_HISTOGRAM_AGGREGATION` environment variable. (#4437)
1059 - Add the `NewAllowKeysFilter` and `NewDenyKeysFilter` functions to `go.opentelemetry.io/otel/attribute` to allow convenient creation of allow-keys and deny-keys filters. (#4444)
1060 - Support Go 1.21. (#4463)
1061
1062 ### Changed
1063
1064 - 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)
1065 - Log duplicate instrument conflict at a warning level instead of info in `go.opentelemetry.io/otel/sdk/metric`. (#4202)
1066 - 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)
1067 - `NewManualReader` in `go.opentelemetry.io/otel/sdk/metric` returns `*ManualReader` instead of `Reader`. (#4244)
1068 - `NewPeriodicReader` in `go.opentelemetry.io/otel/sdk/metric` returns `*PeriodicReader` instead of `Reader`. (#4244)
1069 - Count the Collect time in the `PeriodicReader` timeout in `go.opentelemetry.io/otel/sdk/metric`. (#4221)
1070 - The function `New` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc` returns `*Exporter` instead of `"go.opentelemetry.io/otel/sdk/metric".Exporter`. (#4272)
1071 - The function `New` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp` returns `*Exporter` instead of `"go.opentelemetry.io/otel/sdk/metric".Exporter`. (#4272)
1072 - 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)
1073 - 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)
1074 - 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)
1075 - Restrict `Meter`s in `go.opentelemetry.io/otel/sdk/metric` to only register and collect instruments it created. (#4333)
1076 - `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)
1077 - Upgrade all use of `go.opentelemetry.io/otel/semconv` to use `v1.21.0`. (#4408)
1078 - Increase instrument name maximum length from 63 to 255 characters in `go.opentelemetry.io/otel/sdk/metric`. (#4434)
1079 - 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)
1080
1081 ### Removed
1082
1083 - Remove `Reader.RegisterProducer` in `go.opentelemetry.io/otel/metric`.
1084 Use the added `WithProducer` option instead. (#4346)
1085 - Remove `Reader.ForceFlush` in `go.opentelemetry.io/otel/metric`.
1086 Notice that `PeriodicReader.ForceFlush` is still available. (#4375)
1087
1088 ### Fixed
1089
1090 - Correctly format log messages from the `go.opentelemetry.io/otel/exporters/zipkin` exporter. (#4143)
1091 - Log an error for calls to `NewView` in `go.opentelemetry.io/otel/sdk/metric` that have empty criteria. (#4307)
1092 - Fix `"go.opentelemetry.io/otel/sdk/resource".WithHostID()` to not set an empty `host.id`. (#4317)
1093 - Use the instrument identifying fields to cache aggregators and determine duplicate instrument registrations in `go.opentelemetry.io/otel/sdk/metric`. (#4337)
1094 - Detect duplicate instruments for case-insensitive names in `go.opentelemetry.io/otel/sdk/metric`. (#4338)
1095 - The `ManualReader` will not panic if `AggregationSelector` returns `nil` in `go.opentelemetry.io/otel/sdk/metric`. (#4350)
1096 - If a `Reader`'s `AggregationSelector` returns `nil` or `DefaultAggregation` the pipeline will use the default aggregation. (#4350)
1097 - Log a suggested view that fixes instrument conflicts in `go.opentelemetry.io/otel/sdk/metric`. (#4349)
1098 - Fix possible panic, deadlock and race condition in batch span processor in `go.opentelemetry.io/otel/sdk/trace`. (#4353)
1099 - Improve context cancellation handling in batch span processor's `ForceFlush` in `go.opentelemetry.io/otel/sdk/trace`. (#4369)
1100 - Decouple `go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal` from `go.opentelemetry.io/otel/exporters/otlp/internal` using gotmpl. (#4397, #3846)
1101 - 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)
1102 - 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)
1103 - 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)
1104 - 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)
1105 - 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)
1106 - Do not append `_total` if the counter already has that suffix for the Prometheus exproter in `go.opentelemetry.io/otel/exporter/prometheus`. (#4373)
1107 - Fix resource detection data race in `go.opentelemetry.io/otel/sdk/resource`. (#4409)
1108 - Use the first-seen instrument name during instrument name conflicts in `go.opentelemetry.io/otel/sdk/metric`. (#4428)
1109
1110 ### Deprecated
1111
1112 - The `go.opentelemetry.io/otel/exporters/jaeger` package is deprecated.
1113 OpenTelemetry dropped support for Jaeger exporter in July 2023.
1114 Use `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp`
1115 or `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc` instead. (#4423)
1116 - The `go.opentelemetry.io/otel/example/jaeger` package is deprecated. (#4423)
1117 - The `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal` package is deprecated. (#4420)
1118 - The `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal/oconf` package is deprecated. (#4420)
1119 - The `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal/otest` package is deprecated. (#4420)
1120 - The `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal/transform` package is deprecated. (#4420)
1121 - The `go.opentelemetry.io/otel/exporters/otlp/internal` package is deprecated. (#4421)
1122 - The `go.opentelemetry.io/otel/exporters/otlp/internal/envconfig` package is deprecated. (#4421)
1123 - The `go.opentelemetry.io/otel/exporters/otlp/internal/retry` package is deprecated. (#4421)
1124 - The `go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal` package is deprecated. (#4425)
1125 - The `go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal/envconfig` package is deprecated. (#4425)
1126 - The `go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal/otlpconfig` package is deprecated. (#4425)
1127 - The `go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal/otlptracetest` package is deprecated. (#4425)
1128 - The `go.opentelemetry.io/otel/exporters/otlp/otlptrace/internal/retry` package is deprecated. (#4425)
1129 - The `go.opentelemetry.io/otel/sdk/metric/aggregation` package is deprecated.
1130 Use the aggregation types added to `go.opentelemetry.io/otel/sdk/metric` instead. (#4435)
1131
1132 ## [1.16.0/0.39.0] 2023-05-18
1133
1134 This release contains the first stable release of the OpenTelemetry Go [metric API].
1135 Our project stability guarantees now apply to the `go.opentelemetry.io/otel/metric` package.
1136 See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
1137
1138 ### Added
1139
1140 - The `go.opentelemetry.io/otel/semconv/v1.19.0` package.
1141 The package contains semantic conventions from the `v1.19.0` version of the OpenTelemetry specification. (#3848)
1142 - The `go.opentelemetry.io/otel/semconv/v1.20.0` package.
1143 The package contains semantic conventions from the `v1.20.0` version of the OpenTelemetry specification. (#4078)
1144 - The Exponential Histogram data types in `go.opentelemetry.io/otel/sdk/metric/metricdata`. (#4165)
1145 - OTLP metrics exporter now supports the Exponential Histogram Data Type. (#4222)
1146 - 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)
1147
1148 ### Changed
1149
1150 - Use `strings.Cut()` instead of `string.SplitN()` for better readability and memory use. (#4049)
1151 - `MeterProvider` returns noop meters once it has been shutdown. (#4154)
1152
1153 ### Removed
1154
1155 - The deprecated `go.opentelemetry.io/otel/metric/instrument` package is removed.
1156 Use `go.opentelemetry.io/otel/metric` instead. (#4055)
1157
1158 ### Fixed
1159
1160 - Fix build for BSD based systems in `go.opentelemetry.io/otel/sdk/resource`. (#4077)
1161
1162 ## [1.16.0-rc.1/0.39.0-rc.1] 2023-05-03
1163
1164 This is a release candidate for the v1.16.0/v0.39.0 release.
1165 That release is expected to include the `v1` release of the OpenTelemetry Go metric API and will provide stability guarantees of that API.
1166 See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
1167
1168 ### Added
1169
1170 - Support global `MeterProvider` in `go.opentelemetry.io/otel`. (#4039)
1171 - Use `Meter` for a `metric.Meter` from the global `metric.MeterProvider`.
1172 - Use `GetMeterProivder` for a global `metric.MeterProvider`.
1173 - Use `SetMeterProivder` to set the global `metric.MeterProvider`.
1174
1175 ### Changed
1176
1177 - Move the `go.opentelemetry.io/otel/metric` module to the `stable-v1` module set.
1178 This stages the metric API to be released as a stable module. (#4038)
1179
1180 ### Removed
1181
1182 - The `go.opentelemetry.io/otel/metric/global` package is removed.
1183 Use `go.opentelemetry.io/otel` instead. (#4039)
1184
1185 ## [1.15.1/0.38.1] 2023-05-02
1186
1187 ### Fixed
1188
1189 - Remove unused imports from `sdk/resource/host_id_bsd.go` which caused build failures. (#4040, #4041)
1190
1191 ## [1.15.0/0.38.0] 2023-04-27
1192
1193 ### Added
1194
1195 - The `go.opentelemetry.io/otel/metric/embedded` package. (#3916)
1196 - The `Version` function to `go.opentelemetry.io/otel/sdk` to return the SDK version. (#3949)
1197 - Add a `WithNamespace` option to `go.opentelemetry.io/otel/exporters/prometheus` to allow users to prefix metrics with a namespace. (#3970)
1198 - The following configuration types were added to `go.opentelemetry.io/otel/metric/instrument` to be used in the configuration of measurement methods. (#3971)
1199 - The `AddConfig` used to hold configuration for addition measurements
1200 - `NewAddConfig` used to create a new `AddConfig`
1201 - `AddOption` used to configure an `AddConfig`
1202 - The `RecordConfig` used to hold configuration for recorded measurements
1203 - `NewRecordConfig` used to create a new `RecordConfig`
1204 - `RecordOption` used to configure a `RecordConfig`
1205 - The `ObserveConfig` used to hold configuration for observed measurements
1206 - `NewObserveConfig` used to create a new `ObserveConfig`
1207 - `ObserveOption` used to configure an `ObserveConfig`
1208 - `WithAttributeSet` and `WithAttributes` are added to `go.opentelemetry.io/otel/metric/instrument`.
1209 They return an option used during a measurement that defines the attribute Set associated with the measurement. (#3971)
1210 - The `Version` function to `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` to return the OTLP metrics client version. (#3956)
1211 - The `Version` function to `go.opentelemetry.io/otel/exporters/otlp/otlptrace` to return the OTLP trace client version. (#3956)
1212
1213 ### Changed
1214
1215 - The `Extrema` in `go.opentelemetry.io/otel/sdk/metric/metricdata` is redefined with a generic argument of `[N int64 | float64]`. (#3870)
1216 - Update all exported interfaces from `go.opentelemetry.io/otel/metric` to embed their corresponding interface from `go.opentelemetry.io/otel/metric/embedded`.
1217 This adds an implementation requirement to set the interface default behavior for unimplemented methods. (#3916)
1218 - Move No-Op implementation from `go.opentelemetry.io/otel/metric` into its own package `go.opentelemetry.io/otel/metric/noop`. (#3941)
1219 - `metric.NewNoopMeterProvider` is replaced with `noop.NewMeterProvider`
1220 - Add all the methods from `"go.opentelemetry.io/otel/trace".SpanContext` to `bridgeSpanContext` by embedding `otel.SpanContext` in `bridgeSpanContext`. (#3966)
1221 - Wrap `UploadMetrics` error in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric/` to improve error message when encountering generic grpc errors. (#3974)
1222 - 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)
1223 - The `Int64Counter.Add` method now accepts `...AddOption`
1224 - The `Float64Counter.Add` method now accepts `...AddOption`
1225 - The `Int64UpDownCounter.Add` method now accepts `...AddOption`
1226 - The `Float64UpDownCounter.Add` method now accepts `...AddOption`
1227 - The `Int64Histogram.Record` method now accepts `...RecordOption`
1228 - The `Float64Histogram.Record` method now accepts `...RecordOption`
1229 - The `Int64Observer.Observe` method now accepts `...ObserveOption`
1230 - The `Float64Observer.Observe` method now accepts `...ObserveOption`
1231 - The `Observer` methods in `go.opentelemetry.io/otel/metric` accept an option instead of the variadic `"go.opentelemetry.io/otel/attribute".KeyValue`. (#3971)
1232 - The `Observer.ObserveInt64` method now accepts `...ObserveOption`
1233 - The `Observer.ObserveFloat64` method now accepts `...ObserveOption`
1234 - Move global metric back to `go.opentelemetry.io/otel/metric/global` from `go.opentelemetry.io/otel`. (#3986)
1235
1236 ### Fixed
1237
1238 - `TracerProvider` allows calling `Tracer()` while it's shutting down.
1239 It used to deadlock. (#3924)
1240 - Use the SDK version for the Telemetry SDK resource detector in `go.opentelemetry.io/otel/sdk/resource`. (#3949)
1241 - Fix a data race in `SpanProcessor` returned by `NewSimpleSpanProcessor` in `go.opentelemetry.io/otel/sdk/trace`. (#3951)
1242 - Automatically figure out the default aggregation with `aggregation.Default`. (#3967)
1243
1244 ### Deprecated
1245
1246 - The `go.opentelemetry.io/otel/metric/instrument` package is deprecated.
1247 Use the equivalent types added to `go.opentelemetry.io/otel/metric` instead. (#4018)
1248
1249 ## [1.15.0-rc.2/0.38.0-rc.2] 2023-03-23
1250
1251 This is a release candidate for the v1.15.0/v0.38.0 release.
1252 That release will include the `v1` release of the OpenTelemetry Go metric API and will provide stability guarantees of that API.
1253 See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
1254
1255 ### Added
1256
1257 - The `WithHostID` option to `go.opentelemetry.io/otel/sdk/resource`. (#3812)
1258 - The `WithoutTimestamps` option to `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric` to sets all timestamps to zero. (#3828)
1259 - The new `Exemplar` type is added to `go.opentelemetry.io/otel/sdk/metric/metricdata`.
1260 Both the `DataPoint` and `HistogramDataPoint` types from that package have a new field of `Exemplars` containing the sampled exemplars for their timeseries. (#3849)
1261 - Configuration for each metric instrument in `go.opentelemetry.io/otel/sdk/metric/instrument`. (#3895)
1262 - The internal logging introduces a warning level verbosity equal to `V(1)`. (#3900)
1263 - Added a log message warning about usage of `SimpleSpanProcessor` in production environments. (#3854)
1264
1265 ### Changed
1266
1267 - Optimize memory allocation when creation a new `Set` using `NewSet` or `NewSetWithFiltered` in `go.opentelemetry.io/otel/attribute`. (#3832)
1268 - Optimize memory allocation when creation new metric instruments in `go.opentelemetry.io/otel/sdk/metric`. (#3832)
1269 - Avoid creating new objects on all calls to `WithDeferredSetup` and `SkipContextSetup` in OpenTracing bridge. (#3833)
1270 - 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)
1271 - Both the `Histogram` and `HistogramDataPoint` are redefined with a generic argument of `[N int64 | float64]` in `go.opentelemetry.io/otel/sdk/metric/metricdata`. (#3849)
1272 - The metric `Export` interface from `go.opentelemetry.io/otel/sdk/metric` accepts a `*ResourceMetrics` instead of `ResourceMetrics`. (#3853)
1273 - Rename `Asynchronous` to `Observable` in `go.opentelemetry.io/otel/metric/instrument`. (#3892)
1274 - Rename `Int64ObserverOption` to `Int64ObservableOption` in `go.opentelemetry.io/otel/metric/instrument`. (#3895)
1275 - Rename `Float64ObserverOption` to `Float64ObservableOption` in `go.opentelemetry.io/otel/metric/instrument`. (#3895)
1276 - The internal logging changes the verbosity level of info to `V(4)`, the verbosity level of debug to `V(8)`. (#3900)
1277
1278 ### Fixed
1279
1280 - `TracerProvider` consistently doesn't allow to register a `SpanProcessor` after shutdown. (#3845)
1281
1282 ### Removed
1283
1284 - The deprecated `go.opentelemetry.io/otel/metric/global` package is removed. (#3829)
1285 - The unneeded `Synchronous` interface in `go.opentelemetry.io/otel/metric/instrument` was removed. (#3892)
1286 - The `Float64ObserverConfig` and `NewFloat64ObserverConfig` in `go.opentelemetry.io/otel/sdk/metric/instrument`.
1287 Use the added `float64` instrument configuration instead. (#3895)
1288 - The `Int64ObserverConfig` and `NewInt64ObserverConfig` in `go.opentelemetry.io/otel/sdk/metric/instrument`.
1289 Use the added `int64` instrument configuration instead. (#3895)
1290 - The `NewNoopMeter` function in `go.opentelemetry.io/otel/metric`, use `NewMeterProvider().Meter("")` instead. (#3893)
1291
1292 ## [1.15.0-rc.1/0.38.0-rc.1] 2023-03-01
1293
1294 This is a release candidate for the v1.15.0/v0.38.0 release.
1295 That release will include the `v1` release of the OpenTelemetry Go metric API and will provide stability guarantees of that API.
1296 See our [versioning policy](VERSIONING.md) for more information about these stability guarantees.
1297
1298 This release drops the compatibility guarantee of [Go 1.18].
1299
1300 ### Added
1301
1302 - Support global `MeterProvider` in `go.opentelemetry.io/otel`. (#3818)
1303 - Use `Meter` for a `metric.Meter` from the global `metric.MeterProvider`.
1304 - Use `GetMeterProivder` for a global `metric.MeterProvider`.
1305 - Use `SetMeterProivder` to set the global `metric.MeterProvider`.
1306
1307 ### Changed
1308
1309 - Dropped compatibility testing for [Go 1.18].
1310 The project no longer guarantees support for this version of Go. (#3813)
1311
1312 ### Fixed
1313
1314 - Handle empty environment variable as it they were not set. (#3764)
1315 - Clarify the `httpconv` and `netconv` packages in `go.opentelemetry.io/otel/semconv/*` provide tracing semantic conventions. (#3823)
1316 - Fix race conditions in `go.opentelemetry.io/otel/exporters/metric/prometheus` that could cause a panic. (#3899)
1317 - 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)
1318
1319 ### Deprecated
1320
1321 - The `go.opentelemetry.io/otel/metric/global` package is deprecated.
1322 Use `go.opentelemetry.io/otel` instead. (#3818)
1323
1324 ### Removed
1325
1326 - The deprecated `go.opentelemetry.io/otel/metric/unit` package is removed. (#3814)
1327
1328 ## [1.14.0/0.37.0/0.0.4] 2023-02-27
1329
1330 This release is the last to support [Go 1.18].
1331 The next release will require at least [Go 1.19].
1332
1333 ### Added
1334
1335 - The `event` type semantic conventions are added to `go.opentelemetry.io/otel/semconv/v1.17.0`. (#3697)
1336 - Support [Go 1.20]. (#3693)
1337 - The `go.opentelemetry.io/otel/semconv/v1.18.0` package.
1338 The package contains semantic conventions from the `v1.18.0` version of the OpenTelemetry specification. (#3719)
1339 - The following `const` renames from `go.opentelemetry.io/otel/semconv/v1.17.0` are included:
1340 - `OtelScopeNameKey` -> `OTelScopeNameKey`
1341 - `OtelScopeVersionKey` -> `OTelScopeVersionKey`
1342 - `OtelLibraryNameKey` -> `OTelLibraryNameKey`
1343 - `OtelLibraryVersionKey` -> `OTelLibraryVersionKey`
1344 - `OtelStatusCodeKey` -> `OTelStatusCodeKey`
1345 - `OtelStatusDescriptionKey` -> `OTelStatusDescriptionKey`
1346 - `OtelStatusCodeOk` -> `OTelStatusCodeOk`
1347 - `OtelStatusCodeError` -> `OTelStatusCodeError`
1348 - The following `func` renames from `go.opentelemetry.io/otel/semconv/v1.17.0` are included:
1349 - `OtelScopeName` -> `OTelScopeName`
1350 - `OtelScopeVersion` -> `OTelScopeVersion`
1351 - `OtelLibraryName` -> `OTelLibraryName`
1352 - `OtelLibraryVersion` -> `OTelLibraryVersion`
1353 - `OtelStatusDescription` -> `OTelStatusDescription`
1354 - A `IsSampled` method is added to the `SpanContext` implementation in `go.opentelemetry.io/otel/bridge/opentracing` to expose the span sampled state.
1355 See the [README](./bridge/opentracing/README.md) for more information. (#3570)
1356 - The `WithInstrumentationAttributes` option to `go.opentelemetry.io/otel/metric`. (#3738)
1357 - The `WithInstrumentationAttributes` option to `go.opentelemetry.io/otel/trace`. (#3739)
1358 - The following environment variables are supported by the periodic `Reader` in `go.opentelemetry.io/otel/sdk/metric`. (#3763)
1359 - `OTEL_METRIC_EXPORT_INTERVAL` sets the time between collections and exports.
1360 - `OTEL_METRIC_EXPORT_TIMEOUT` sets the timeout an export is attempted.
1361
1362 ### Changed
1363
1364 - Fall-back to `TextMapCarrier` when it's not `HttpHeader`s in `go.opentelemetry.io/otel/bridge/opentracing`. (#3679)
1365 - 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.
1366 This change is made to enable memory reuse by SDK users. (#3732)
1367 - The `WithUnit` option in `go.opentelemetry.io/otel/sdk/metric/instrument` is updated to accept a `string` for the unit value. (#3776)
1368
1369 ### Fixed
1370
1371 - Ensure `go.opentelemetry.io/otel` does not use generics. (#3723, #3725)
1372 - Multi-reader `MeterProvider`s now export metrics for all readers, instead of just the first reader. (#3720, #3724)
1373 - Remove use of deprecated `"math/rand".Seed` in `go.opentelemetry.io/otel/example/prometheus`. (#3733)
1374 - Do not silently drop unknown schema data with `Parse` in `go.opentelemetry.io/otel/schema/v1.1`. (#3743)
1375 - Data race issue in OTLP exporter retry mechanism. (#3755, #3756)
1376 - Wrapping empty errors when exporting in `go.opentelemetry.io/otel/sdk/metric`. (#3698, #3772)
1377 - Incorrect "all" and "resource" definition for schema files in `go.opentelemetry.io/otel/schema/v1.1`. (#3777)
1378
1379 ### Deprecated
1380
1381 - The `go.opentelemetry.io/otel/metric/unit` package is deprecated.
1382 Use the equivalent unit string instead. (#3776)
1383 - Use `"1"` instead of `unit.Dimensionless`
1384 - Use `"By"` instead of `unit.Bytes`
1385 - Use `"ms"` instead of `unit.Milliseconds`
1386
1387 ## [1.13.0/0.36.0] 2023-02-07
1388
1389 ### Added
1390
1391 - Attribute `KeyValue` creations functions to `go.opentelemetry.io/otel/semconv/v1.17.0` for all non-enum semantic conventions.
1392 These functions ensure semantic convention type correctness. (#3675)
1393
1394 ### Fixed
1395
1396 - Removed the `http.target` attribute from being added by `ServerRequest` in the following packages. (#3687)
1397 - `go.opentelemetry.io/otel/semconv/v1.13.0/httpconv`
1398 - `go.opentelemetry.io/otel/semconv/v1.14.0/httpconv`
1399 - `go.opentelemetry.io/otel/semconv/v1.15.0/httpconv`
1400 - `go.opentelemetry.io/otel/semconv/v1.16.0/httpconv`
1401 - `go.opentelemetry.io/otel/semconv/v1.17.0/httpconv`
1402
1403 ### Removed
1404
1405 - The deprecated `go.opentelemetry.io/otel/metric/instrument/asyncfloat64` package is removed. (#3631)
1406 - The deprecated `go.opentelemetry.io/otel/metric/instrument/asyncint64` package is removed. (#3631)
1407 - The deprecated `go.opentelemetry.io/otel/metric/instrument/syncfloat64` package is removed. (#3631)
1408 - The deprecated `go.opentelemetry.io/otel/metric/instrument/syncint64` package is removed. (#3631)
1409
1410 ## [1.12.0/0.35.0] 2023-01-28
1411
1412 ### Added
1413
1414 - The `WithInt64Callback` option to `go.opentelemetry.io/otel/metric/instrument`.
1415 This options is used to configure `int64` Observer callbacks during their creation. (#3507)
1416 - The `WithFloat64Callback` option to `go.opentelemetry.io/otel/metric/instrument`.
1417 This options is used to configure `float64` Observer callbacks during their creation. (#3507)
1418 - The `Producer` interface and `Reader.RegisterProducer(Producer)` to `go.opentelemetry.io/otel/sdk/metric`.
1419 These additions are used to enable external metric Producers. (#3524)
1420 - The `Callback` function type to `go.opentelemetry.io/otel/metric`.
1421 This new named function type is registered with a `Meter`. (#3564)
1422 - The `go.opentelemetry.io/otel/semconv/v1.13.0` package.
1423 The package contains semantic conventions from the `v1.13.0` version of the OpenTelemetry specification. (#3499)
1424 - 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`.
1425 - 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`.
1426 - 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`.
1427 - 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`.
1428 - 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`.
1429 - 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`.
1430 - 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`.
1431 - 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`.
1432 - The `Client` function is included in `go.opentelemetry.io/otel/semconv/v1.13.0/netconv` to generate attributes for a `net.Conn`.
1433 - The `Server` function is included in `go.opentelemetry.io/otel/semconv/v1.13.0/netconv` to generate attributes for a `net.Listener`.
1434 - The `go.opentelemetry.io/otel/semconv/v1.14.0` package.
1435 The package contains semantic conventions from the `v1.14.0` version of the OpenTelemetry specification. (#3566)
1436 - The `go.opentelemetry.io/otel/semconv/v1.15.0` package.
1437 The package contains semantic conventions from the `v1.15.0` version of the OpenTelemetry specification. (#3578)
1438 - The `go.opentelemetry.io/otel/semconv/v1.16.0` package.
1439 The package contains semantic conventions from the `v1.16.0` version of the OpenTelemetry specification. (#3579)
1440 - Metric instruments to `go.opentelemetry.io/otel/metric/instrument`.
1441 These instruments are use as replacements of the deprecated `go.opentelemetry.io/otel/metric/instrument/{asyncfloat64,asyncint64,syncfloat64,syncint64}` packages.(#3575, #3586)
1442 - `Float64ObservableCounter` replaces the `asyncfloat64.Counter`
1443 - `Float64ObservableUpDownCounter` replaces the `asyncfloat64.UpDownCounter`
1444 - `Float64ObservableGauge` replaces the `asyncfloat64.Gauge`
1445 - `Int64ObservableCounter` replaces the `asyncint64.Counter`
1446 - `Int64ObservableUpDownCounter` replaces the `asyncint64.UpDownCounter`
1447 - `Int64ObservableGauge` replaces the `asyncint64.Gauge`
1448 - `Float64Counter` replaces the `syncfloat64.Counter`
1449 - `Float64UpDownCounter` replaces the `syncfloat64.UpDownCounter`
1450 - `Float64Histogram` replaces the `syncfloat64.Histogram`
1451 - `Int64Counter` replaces the `syncint64.Counter`
1452 - `Int64UpDownCounter` replaces the `syncint64.UpDownCounter`
1453 - `Int64Histogram` replaces the `syncint64.Histogram`
1454 - `NewTracerProvider` to `go.opentelemetry.io/otel/bridge/opentracing`.
1455 This is used to create `WrapperTracer` instances from a `TracerProvider`. (#3116)
1456 - The `Extrema` type to `go.opentelemetry.io/otel/sdk/metric/metricdata`.
1457 This type is used to represent min/max values and still be able to distinguish unset and zero values. (#3487)
1458 - The `go.opentelemetry.io/otel/semconv/v1.17.0` package.
1459 The package contains semantic conventions from the `v1.17.0` version of the OpenTelemetry specification. (#3599)
1460
1461 ### Changed
1462
1463 - Jaeger and Zipkin exporter use `github.com/go-logr/logr` as the logging interface, and add the `WithLogr` option. (#3497, #3500)
1464 - Instrument configuration in `go.opentelemetry.io/otel/metric/instrument` is split into specific options and configuration based on the instrument type. (#3507)
1465 - Use the added `Int64Option` type to configure instruments from `go.opentelemetry.io/otel/metric/instrument/syncint64`.
1466 - Use the added `Float64Option` type to configure instruments from `go.opentelemetry.io/otel/metric/instrument/syncfloat64`.
1467 - Use the added `Int64ObserverOption` type to configure instruments from `go.opentelemetry.io/otel/metric/instrument/asyncint64`.
1468 - Use the added `Float64ObserverOption` type to configure instruments from `go.opentelemetry.io/otel/metric/instrument/asyncfloat64`.
1469 - Return a `Registration` from the `RegisterCallback` method of a `Meter` in the `go.opentelemetry.io/otel/metric` package.
1470 This `Registration` can be used to unregister callbacks. (#3522)
1471 - Global error handler uses an atomic value instead of a mutex. (#3543)
1472 - Add `NewMetricProducer` to `go.opentelemetry.io/otel/bridge/opencensus`, which can be used to pass OpenCensus metrics to an OpenTelemetry Reader. (#3541)
1473 - Global logger uses an atomic value instead of a mutex. (#3545)
1474 - The `Shutdown` method of the `"go.opentelemetry.io/otel/sdk/trace".TracerProvider` releases all computational resources when called the first time. (#3551)
1475 - The `Sampler` returned from `TraceIDRatioBased` `go.opentelemetry.io/otel/sdk/trace` now uses the rightmost bits for sampling decisions.
1476 This fixes random sampling when using ID generators like `xray.IDGenerator` and increasing parity with other language implementations. (#3557)
1477 - Errors from `go.opentelemetry.io/otel/exporters/otlp/otlptrace` exporters are wrapped in errors identifying their signal name.
1478 Existing users of the exporters attempting to identify specific errors will need to use `errors.Unwrap()` to get the underlying error. (#3516)
1479 - Exporters from `go.opentelemetry.io/otel/exporters/otlp` will print the final retryable error message when attempts to retry time out. (#3514)
1480 - The instrument kind names in `go.opentelemetry.io/otel/sdk/metric` are updated to match the API. (#3562)
1481 - `InstrumentKindSyncCounter` is renamed to `InstrumentKindCounter`
1482 - `InstrumentKindSyncUpDownCounter` is renamed to `InstrumentKindUpDownCounter`
1483 - `InstrumentKindSyncHistogram` is renamed to `InstrumentKindHistogram`
1484 - `InstrumentKindAsyncCounter` is renamed to `InstrumentKindObservableCounter`
1485 - `InstrumentKindAsyncUpDownCounter` is renamed to `InstrumentKindObservableUpDownCounter`
1486 - `InstrumentKindAsyncGauge` is renamed to `InstrumentKindObservableGauge`
1487 - The `RegisterCallback` method of the `Meter` in `go.opentelemetry.io/otel/metric` changed.
1488 - The named `Callback` replaces the inline function parameter. (#3564)
1489 - `Callback` is required to return an error. (#3576)
1490 - `Callback` accepts the added `Observer` parameter added.
1491 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)
1492 - The slice of `instrument.Asynchronous` is now passed as a variadic argument. (#3587)
1493 - The exporter from `go.opentelemetry.io/otel/exporters/zipkin` is updated to use the `v1.16.0` version of semantic conventions.
1494 This means it no longer uses the removed `net.peer.ip` or `http.host` attributes to determine the remote endpoint.
1495 Instead it uses the `net.sock.peer` attributes. (#3581)
1496 - 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)
1497
1498 ### Fixed
1499
1500 - Asynchronous instruments that use sum aggregators and attribute filters correctly add values from equivalent attribute sets that have been filtered. (#3439, #3549)
1501 - The `RegisterCallback` method of the `Meter` from `go.opentelemetry.io/otel/sdk/metric` only registers a callback for instruments created by that meter.
1502 Trying to register a callback with instruments from a different meter will result in an error being returned. (#3584)
1503
1504 ### Deprecated
1505
1506 - The `NewMetricExporter` in `go.opentelemetry.io/otel/bridge/opencensus` is deprecated.
1507 Use `NewMetricProducer` instead. (#3541)
1508 - The `go.opentelemetry.io/otel/metric/instrument/asyncfloat64` package is deprecated.
1509 Use the instruments from `go.opentelemetry.io/otel/metric/instrument` instead. (#3575)
1510 - The `go.opentelemetry.io/otel/metric/instrument/asyncint64` package is deprecated.
1511 Use the instruments from `go.opentelemetry.io/otel/metric/instrument` instead. (#3575)
1512 - The `go.opentelemetry.io/otel/metric/instrument/syncfloat64` package is deprecated.
1513 Use the instruments from `go.opentelemetry.io/otel/metric/instrument` instead. (#3575)
1514 - The `go.opentelemetry.io/otel/metric/instrument/syncint64` package is deprecated.
1515 Use the instruments from `go.opentelemetry.io/otel/metric/instrument` instead. (#3575)
1516 - The `NewWrappedTracerProvider` in `go.opentelemetry.io/otel/bridge/opentracing` is now deprecated.
1517 Use `NewTracerProvider` instead. (#3116)
1518
1519 ### Removed
1520
1521 - The deprecated `go.opentelemetry.io/otel/sdk/metric/view` package is removed. (#3520)
1522 - The `InstrumentProvider` from `go.opentelemetry.io/otel/sdk/metric/asyncint64` is removed.
1523 Use the new creation methods of the `Meter` in `go.opentelemetry.io/otel/sdk/metric` instead. (#3530)
1524 - The `Counter` method is replaced by `Meter.Int64ObservableCounter`
1525 - The `UpDownCounter` method is replaced by `Meter.Int64ObservableUpDownCounter`
1526 - The `Gauge` method is replaced by `Meter.Int64ObservableGauge`
1527 - The `InstrumentProvider` from `go.opentelemetry.io/otel/sdk/metric/asyncfloat64` is removed.
1528 Use the new creation methods of the `Meter` in `go.opentelemetry.io/otel/sdk/metric` instead. (#3530)
1529 - The `Counter` method is replaced by `Meter.Float64ObservableCounter`
1530 - The `UpDownCounter` method is replaced by `Meter.Float64ObservableUpDownCounter`
1531 - The `Gauge` method is replaced by `Meter.Float64ObservableGauge`
1532 - The `InstrumentProvider` from `go.opentelemetry.io/otel/sdk/metric/syncint64` is removed.
1533 Use the new creation methods of the `Meter` in `go.opentelemetry.io/otel/sdk/metric` instead. (#3530)
1534 - The `Counter` method is replaced by `Meter.Int64Counter`
1535 - The `UpDownCounter` method is replaced by `Meter.Int64UpDownCounter`
1536 - The `Histogram` method is replaced by `Meter.Int64Histogram`
1537 - The `InstrumentProvider` from `go.opentelemetry.io/otel/sdk/metric/syncfloat64` is removed.
1538 Use the new creation methods of the `Meter` in `go.opentelemetry.io/otel/sdk/metric` instead. (#3530)
1539 - The `Counter` method is replaced by `Meter.Float64Counter`
1540 - The `UpDownCounter` method is replaced by `Meter.Float64UpDownCounter`
1541 - The `Histogram` method is replaced by `Meter.Float64Histogram`
1542
1543 ## [1.11.2/0.34.0] 2022-12-05
1544
1545 ### Added
1546
1547 - The `WithView` `Option` is added to the `go.opentelemetry.io/otel/sdk/metric` package.
1548 This option is used to configure the view(s) a `MeterProvider` will use for all `Reader`s that are registered with it. (#3387)
1549 - Add Instrumentation Scope and Version as info metric and label in Prometheus exporter.
1550 This can be disabled using the `WithoutScopeInfo()` option added to that package.(#3273, #3357)
1551 - OTLP exporters now recognize: (#3363)
1552 - `OTEL_EXPORTER_OTLP_INSECURE`
1553 - `OTEL_EXPORTER_OTLP_TRACES_INSECURE`
1554 - `OTEL_EXPORTER_OTLP_METRICS_INSECURE`
1555 - `OTEL_EXPORTER_OTLP_CLIENT_KEY`
1556 - `OTEL_EXPORTER_OTLP_TRACES_CLIENT_KEY`
1557 - `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY`
1558 - `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`
1559 - `OTEL_EXPORTER_OTLP_TRACES_CLIENT_CERTIFICATE`
1560 - `OTEL_EXPORTER_OTLP_METRICS_CLIENT_CERTIFICATE`
1561 - 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`.
1562 These additions are replacements for the `View` type and `New` function from `go.opentelemetry.io/otel/sdk/metric/view`. (#3459)
1563 - The `Instrument` and `InstrumentKind` type are added to `go.opentelemetry.io/otel/sdk/metric`.
1564 These additions are replacements for the `Instrument` and `InstrumentKind` types from `go.opentelemetry.io/otel/sdk/metric/view`. (#3459)
1565 - The `Stream` type is added to `go.opentelemetry.io/otel/sdk/metric` to define a metric data stream a view will produce. (#3459)
1566 - The `AssertHasAttributes` allows instrument authors to test that datapoints returned have appropriate attributes. (#3487)
1567
1568 ### Changed
1569
1570 - The `"go.opentelemetry.io/otel/sdk/metric".WithReader` option no longer accepts views to associate with the `Reader`.
1571 Instead, views are now registered directly with the `MeterProvider` via the new `WithView` option.
1572 The views registered with the `MeterProvider` apply to all `Reader`s. (#3387)
1573 - 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)
1574 - 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)
1575 - The `WithTemporalitySelector` and `WithAggregationSelector` `ReaderOption`s have been changed to `ManualReaderOption`s in the `go.opentelemetry.io/otel/sdk/metric` package. (#3260)
1576 - 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)
1577
1578 ### Fixed
1579
1580 - The `go.opentelemetry.io/otel/exporters/prometheus` exporter fixes duplicated `_total` suffixes. (#3369)
1581 - Remove comparable requirement for `Reader`s. (#3387)
1582 - Cumulative metrics from the OpenCensus bridge (`go.opentelemetry.io/otel/bridge/opencensus`) are defined as monotonic sums, instead of non-monotonic. (#3389)
1583 - Asynchronous counters (`Counter` and `UpDownCounter`) from the metric SDK now produce delta sums when configured with delta temporality. (#3398)
1584 - Exported `Status` codes in the `go.opentelemetry.io/otel/exporters/zipkin` exporter are now exported as all upper case values. (#3340)
1585 - `Aggregation`s from `go.opentelemetry.io/otel/sdk/metric` with no data are not exported. (#3394, #3436)
1586 - Re-enabled Attribute Filters in the Metric SDK. (#3396)
1587 - Asynchronous callbacks are only called if they are registered with at least one instrument that does not use drop aggregation. (#3408)
1588 - Do not report empty partial-success responses in the `go.opentelemetry.io/otel/exporters/otlp` exporters. (#3438, #3432)
1589 - Handle partial success responses in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` exporters. (#3162, #3440)
1590 - Prevent duplicate Prometheus description, unit, and type. (#3469)
1591 - Prevents panic when using incorrect `attribute.Value.As[Type]Slice()`. (#3489)
1592
1593 ### Removed
1594
1595 - The `go.opentelemetry.io/otel/exporters/otlp/otlpmetric.Client` interface is removed. (#3486)
1596 - The `go.opentelemetry.io/otel/exporters/otlp/otlpmetric.New` function is removed. Use the `otlpmetric[http|grpc].New` directly. (#3486)
1597
1598 ### Deprecated
1599
1600 - The `go.opentelemetry.io/otel/sdk/metric/view` package is deprecated.
1601 Use `Instrument`, `InstrumentKind`, `View`, and `NewView` in `go.opentelemetry.io/otel/sdk/metric` instead. (#3476)
1602
1603 ## [1.11.1/0.33.0] 2022-10-19
1604
1605 ### Added
1606
1607 - The Prometheus exporter in `go.opentelemetry.io/otel/exporters/prometheus` registers with a Prometheus registerer on creation.
1608 By default, it will register with the default Prometheus registerer.
1609 A non-default registerer can be used by passing the `WithRegisterer` option. (#3239)
1610 - Added the `WithAggregationSelector` option to the `go.opentelemetry.io/otel/exporters/prometheus` package to change the default `AggregationSelector` used. (#3341)
1611 - The Prometheus exporter in `go.opentelemetry.io/otel/exporters/prometheus` converts the `Resource` associated with metric exports into a `target_info` metric. (#3285)
1612
1613 ### Changed
1614
1615 - The `"go.opentelemetry.io/otel/exporters/prometheus".New` function is updated to return an error.
1616 It will return an error if the exporter fails to register with Prometheus. (#3239)
1617
1618 ### Fixed
1619
1620 - The URL-encoded values from the `OTEL_RESOURCE_ATTRIBUTES` environment variable are decoded. (#2963)
1621 - The `baggage.NewMember` function decodes the `value` parameter instead of directly using it.
1622 This fixes the implementation to be compliant with the W3C specification. (#3226)
1623 - Slice attributes of the `attribute` package are now comparable based on their value, not instance. (#3108 #3252)
1624 - 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)
1625 - The Prometheus exporter in `go.opentelemetry.io/otel/exporters/prometheus` cumulatively sums histogram buckets. (#3281)
1626 - The sum of each histogram data point is now uniquely exported by the `go.opentelemetry.io/otel/exporters/otlpmetric` exporters. (#3284, #3293)
1627 - Recorded values for asynchronous counters (`Counter` and `UpDownCounter`) are interpreted as exact, not incremental, sum values by the metric SDK. (#3350, #3278)
1628 - `UpDownCounters` are now correctly output as Prometheus gauges in the `go.opentelemetry.io/otel/exporters/prometheus` exporter. (#3358)
1629 - The Prometheus exporter in `go.opentelemetry.io/otel/exporters/prometheus` no longer describes the metrics it will send to Prometheus on startup.
1630 Instead the exporter is defined as an "unchecked" collector for Prometheus.
1631 This fixes the `reader is not registered` warning currently emitted on startup. (#3291 #3342)
1632 - The `go.opentelemetry.io/otel/exporters/prometheus` exporter now correctly adds `_total` suffixes to counter metrics. (#3360)
1633 - The `go.opentelemetry.io/otel/exporters/prometheus` exporter now adds a unit suffix to metric names.
1634 This can be disabled using the `WithoutUnits()` option added to that package. (#3352)
1635
1636 ## [1.11.0/0.32.3] 2022-10-12
1637
1638 ### Added
1639
1640 - 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)
1641
1642 ### Changed
1643
1644 - `span.SetStatus` has been updated such that calls that lower the status are now no-ops. (#3214)
1645 - Upgrade `golang.org/x/sys/unix` from `v0.0.0-20210423185535-09eb48e85fd7` to `v0.0.0-20220919091848-fb04ddd9f9c8`.
1646 This addresses [GO-2022-0493](https://pkg.go.dev/vuln/GO-2022-0493). (#3235)
1647
1648 ## [0.32.2] Metric SDK (Alpha) - 2022-10-11
1649
1650 ### Added
1651
1652 - Added an example of using metric views to customize instruments. (#3177)
1653 - 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)
1654
1655 ### Changed
1656
1657 - Flush pending measurements with the `PeriodicReader` in the `go.opentelemetry.io/otel/sdk/metric` when `ForceFlush` or `Shutdown` are called. (#3220)
1658 - Update histogram default bounds to match the requirements of the latest specification. (#3222)
1659 - Encode the HTTP status code in the OpenTracing bridge (`go.opentelemetry.io/otel/bridge/opentracing`) as an integer. (#3265)
1660
1661 ### Fixed
1662
1663 - Use default view if instrument does not match any registered view of a reader. (#3224, #3237)
1664 - Return the same instrument every time a user makes the exact same instrument creation call. (#3229, #3251)
1665 - Return the existing instrument when a view transforms a creation call to match an existing instrument. (#3240, #3251)
1666 - Log a warning when a conflicting instrument (e.g. description, unit, data-type) is created instead of returning an error. (#3251)
1667 - The OpenCensus bridge no longer sends empty batches of metrics. (#3263)
1668
1669 ## [0.32.1] Metric SDK (Alpha) - 2022-09-22
1670
1671 ### Changed
1672
1673 - The Prometheus exporter sanitizes OpenTelemetry instrument names when exporting.
1674 Invalid characters are replaced with `_`. (#3212)
1675
1676 ### Added
1677
1678 - The metric portion of the OpenCensus bridge (`go.opentelemetry.io/otel/bridge/opencensus`) has been reintroduced. (#3192)
1679 - The OpenCensus bridge example (`go.opentelemetry.io/otel/example/opencensus`) has been reintroduced. (#3206)
1680
1681 ### Fixed
1682
1683 - Updated go.mods to point to valid versions of the sdk. (#3216)
1684 - Set the `MeterProvider` resource on all exported metric data. (#3218)
1685
1686 ## [0.32.0] Revised Metric SDK (Alpha) - 2022-09-18
1687
1688 ### Changed
1689
1690 - The metric SDK in `go.opentelemetry.io/otel/sdk/metric` is completely refactored to comply with the OpenTelemetry specification.
1691 Please see the package documentation for how the new SDK is initialized and configured. (#3175)
1692 - Update the minimum supported go version to go1.18. Removes support for go1.17 (#3179)
1693
1694 ### Removed
1695
1696 - The metric portion of the OpenCensus bridge (`go.opentelemetry.io/otel/bridge/opencensus`) has been removed.
1697 A new bridge compliant with the revised metric SDK will be added back in a future release. (#3175)
1698 - The `go.opentelemetry.io/otel/sdk/metric/aggregator/aggregatortest` package is removed, see the new metric SDK. (#3175)
1699 - The `go.opentelemetry.io/otel/sdk/metric/aggregator/histogram` package is removed, see the new metric SDK. (#3175)
1700 - The `go.opentelemetry.io/otel/sdk/metric/aggregator/lastvalue` package is removed, see the new metric SDK. (#3175)
1701 - The `go.opentelemetry.io/otel/sdk/metric/aggregator/sum` package is removed, see the new metric SDK. (#3175)
1702 - The `go.opentelemetry.io/otel/sdk/metric/aggregator` package is removed, see the new metric SDK. (#3175)
1703 - The `go.opentelemetry.io/otel/sdk/metric/controller/basic` package is removed, see the new metric SDK. (#3175)
1704 - The `go.opentelemetry.io/otel/sdk/metric/controller/controllertest` package is removed, see the new metric SDK. (#3175)
1705 - The `go.opentelemetry.io/otel/sdk/metric/controller/time` package is removed, see the new metric SDK. (#3175)
1706 - The `go.opentelemetry.io/otel/sdk/metric/export/aggregation` package is removed, see the new metric SDK. (#3175)
1707 - The `go.opentelemetry.io/otel/sdk/metric/export` package is removed, see the new metric SDK. (#3175)
1708 - The `go.opentelemetry.io/otel/sdk/metric/metrictest` package is removed.
1709 A replacement package that supports the new metric SDK will be added back in a future release. (#3175)
1710 - The `go.opentelemetry.io/otel/sdk/metric/number` package is removed, see the new metric SDK. (#3175)
1711 - The `go.opentelemetry.io/otel/sdk/metric/processor/basic` package is removed, see the new metric SDK. (#3175)
1712 - The `go.opentelemetry.io/otel/sdk/metric/processor/processortest` package is removed, see the new metric SDK. (#3175)
1713 - The `go.opentelemetry.io/otel/sdk/metric/processor/reducer` package is removed, see the new metric SDK. (#3175)
1714 - The `go.opentelemetry.io/otel/sdk/metric/registry` package is removed, see the new metric SDK. (#3175)
1715 - The `go.opentelemetry.io/otel/sdk/metric/sdkapi` package is removed, see the new metric SDK. (#3175)
1716 - The `go.opentelemetry.io/otel/sdk/metric/selector/simple` package is removed, see the new metric SDK. (#3175)
1717 - The `"go.opentelemetry.io/otel/sdk/metric".ErrUninitializedInstrument` variable was removed. (#3175)
1718 - The `"go.opentelemetry.io/otel/sdk/metric".ErrBadInstrument` variable was removed. (#3175)
1719 - The `"go.opentelemetry.io/otel/sdk/metric".Accumulator` type was removed, see the `MeterProvider`in the new metric SDK. (#3175)
1720 - The `"go.opentelemetry.io/otel/sdk/metric".NewAccumulator` function was removed, see `NewMeterProvider`in the new metric SDK. (#3175)
1721 - The deprecated `"go.opentelemetry.io/otel/sdk/metric".AtomicFieldOffsets` function was removed. (#3175)
1722
1723 ## [1.10.0] - 2022-09-09
1724
1725 ### Added
1726
1727 - Support Go 1.19. (#3077)
1728 Include compatibility testing and document support. (#3077)
1729 - Support the OTLP ExportTracePartialSuccess response; these are passed to the registered error handler. (#3106)
1730 - Upgrade go.opentelemetry.io/proto/otlp from v0.18.0 to v0.19.0 (#3107)
1731
1732 ### Changed
1733
1734 - Fix misidentification of OpenTelemetry `SpanKind` in OpenTracing bridge (`go.opentelemetry.io/otel/bridge/opentracing`). (#3096)
1735 - Attempting to start a span with a nil `context` will no longer cause a panic. (#3110)
1736 - All exporters will be shutdown even if one reports an error (#3091)
1737 - Ensure valid UTF-8 when truncating over-length attribute values. (#3156)
1738
1739 ## [1.9.0/0.0.3] - 2022-08-01
1740
1741 ### Added
1742
1743 - Add support for Schema Files format 1.1.x (metric "split" transform) with the new `go.opentelemetry.io/otel/schema/v1.1` package. (#2999)
1744 - Add the `go.opentelemetry.io/otel/semconv/v1.11.0` package.
1745 The package contains semantic conventions from the `v1.11.0` version of the OpenTelemetry specification. (#3009)
1746 - Add the `go.opentelemetry.io/otel/semconv/v1.12.0` package.
1747 The package contains semantic conventions from the `v1.12.0` version of the OpenTelemetry specification. (#3010)
1748 - Add the `http.method` attribute to HTTP server metric from all `go.opentelemetry.io/otel/semconv/*` packages. (#3018)
1749
1750 ### Fixed
1751
1752 - Invalid warning for context setup being deferred in `go.opentelemetry.io/otel/bridge/opentracing` package. (#3029)
1753
1754 ## [1.8.0/0.31.0] - 2022-07-08
1755
1756 ### Added
1757
1758 - Add support for `opentracing.TextMap` format in the `Inject` and `Extract` methods
1759 of the `"go.opentelemetry.io/otel/bridge/opentracing".BridgeTracer` type. (#2911)
1760
1761 ### Changed
1762
1763 - The `crosslink` make target has been updated to use the `go.opentelemetry.io/build-tools/crosslink` package. (#2886)
1764 - In the `go.opentelemetry.io/otel/sdk/instrumentation` package rename `Library` to `Scope` and alias `Library` as `Scope` (#2976)
1765 - Move metric no-op implementation form `nonrecording` to `metric` package. (#2866)
1766
1767 ### Removed
1768
1769 - Support for go1.16. Support is now only for go1.17 and go1.18 (#2917)
1770
1771 ### Deprecated
1772
1773 - The `Library` struct in the `go.opentelemetry.io/otel/sdk/instrumentation` package is deprecated.
1774 Use the equivalent `Scope` struct instead. (#2977)
1775 - The `ReadOnlySpan.InstrumentationLibrary` method from the `go.opentelemetry.io/otel/sdk/trace` package is deprecated.
1776 Use the equivalent `ReadOnlySpan.InstrumentationScope` method instead. (#2977)
1777
1778 ## [1.7.0/0.30.0] - 2022-04-28
1779
1780 ### Added
1781
1782 - Add the `go.opentelemetry.io/otel/semconv/v1.8.0` package.
1783 The package contains semantic conventions from the `v1.8.0` version of the OpenTelemetry specification. (#2763)
1784 - Add the `go.opentelemetry.io/otel/semconv/v1.9.0` package.
1785 The package contains semantic conventions from the `v1.9.0` version of the OpenTelemetry specification. (#2792)
1786 - Add the `go.opentelemetry.io/otel/semconv/v1.10.0` package.
1787 The package contains semantic conventions from the `v1.10.0` version of the OpenTelemetry specification. (#2842)
1788 - Added an in-memory exporter to metrictest to aid testing with a full SDK. (#2776)
1789
1790 ### Fixed
1791
1792 - Globally delegated instruments are unwrapped before delegating asynchronous callbacks. (#2784)
1793 - Remove import of `testing` package in non-tests builds of the `go.opentelemetry.io/otel` package. (#2786)
1794
1795 ### Changed
1796
1797 - The `WithLabelEncoder` option from the `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric` package is renamed to `WithAttributeEncoder`. (#2790)
1798 - The `LabelFilterSelector` interface from `go.opentelemetry.io/otel/sdk/metric/processor/reducer` is renamed to `AttributeFilterSelector`.
1799 The method included in the renamed interface also changed from `LabelFilterFor` to `AttributeFilterFor`. (#2790)
1800 - The `Metadata.Labels` method from the `go.opentelemetry.io/otel/sdk/metric/export` package is renamed to `Metadata.Attributes`.
1801 Consequentially, the `Record` type from the same package also has had the embedded method renamed. (#2790)
1802
1803 ### Deprecated
1804
1805 - The `Iterator.Label` method in the `go.opentelemetry.io/otel/attribute` package is deprecated.
1806 Use the equivalent `Iterator.Attribute` method instead. (#2790)
1807 - The `Iterator.IndexedLabel` method in the `go.opentelemetry.io/otel/attribute` package is deprecated.
1808 Use the equivalent `Iterator.IndexedAttribute` method instead. (#2790)
1809 - The `MergeIterator.Label` method in the `go.opentelemetry.io/otel/attribute` package is deprecated.
1810 Use the equivalent `MergeIterator.Attribute` method instead. (#2790)
1811
1812 ### Removed
1813
1814 - Removed the `Batch` type from the `go.opentelemetry.io/otel/sdk/metric/metrictest` package. (#2864)
1815 - Removed the `Measurement` type from the `go.opentelemetry.io/otel/sdk/metric/metrictest` package. (#2864)
1816
1817 ## [0.29.0] - 2022-04-11
1818
1819 ### Added
1820
1821 - The metrics global package was added back into several test files. (#2764)
1822 - The `Meter` function is added back to the `go.opentelemetry.io/otel/metric/global` package.
1823 This function is a convenience function equivalent to calling `global.MeterProvider().Meter(...)`. (#2750)
1824
1825 ### Removed
1826
1827 - Removed module the `go.opentelemetry.io/otel/sdk/export/metric`.
1828 Use the `go.opentelemetry.io/otel/sdk/metric` module instead. (#2720)
1829
1830 ### Changed
1831
1832 - Don't panic anymore when setting a global MeterProvider to itself. (#2749)
1833 - Upgrade `go.opentelemetry.io/proto/otlp` in `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` from `v0.12.1` to `v0.15.0`.
1834 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)
1835
1836 ## [1.6.3] - 2022-04-07
1837
1838 ### Fixed
1839
1840 - Allow non-comparable global `MeterProvider`, `TracerProvider`, and `TextMapPropagator` types to be set. (#2772, #2773)
1841
1842 ## [1.6.2] - 2022-04-06
1843
1844 ### Changed
1845
1846 - Don't panic anymore when setting a global TracerProvider or TextMapPropagator to itself. (#2749)
1847 - Upgrade `go.opentelemetry.io/proto/otlp` in `go.opentelemetry.io/otel/exporters/otlp/otlptrace` from `v0.12.1` to `v0.15.0`.
1848 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)
1849
1850 ## [1.6.1] - 2022-03-28
1851
1852 ### Fixed
1853
1854 - The `go.opentelemetry.io/otel/schema/*` packages now use the correct schema URL for their `SchemaURL` constant.
1855 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)
1856
1857 ### Security
1858
1859 - Upgrade `go.opentelemetry.io/proto/otlp` from `v0.12.0` to `v0.12.1`.
1860 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)
1861
1862 ## [1.6.0/0.28.0] - 2022-03-23
1863
1864 ### ⚠️ Notice ⚠️
1865
1866 This update is a breaking change of the unstable Metrics API.
1867 Code instrumented with the `go.opentelemetry.io/otel/metric` will need to be modified.
1868
1869 ### Added
1870
1871 - Add metrics exponential histogram support.
1872 New mapping functions have been made available in `sdk/metric/aggregator/exponential/mapping` for other OpenTelemetry projects to take dependencies on. (#2502)
1873 - Add Go 1.18 to our compatibility tests. (#2679)
1874 - Allow configuring the Sampler with the `OTEL_TRACES_SAMPLER` and `OTEL_TRACES_SAMPLER_ARG` environment variables. (#2305, #2517)
1875 - Add the `metric/global` for obtaining and setting the global `MeterProvider`. (#2660)
1876
1877 ### Changed
1878
1879 - The metrics API has been significantly changed to match the revised OpenTelemetry specification.
1880 High-level changes include:
1881
1882 - Synchronous and asynchronous instruments are now handled by independent `InstrumentProvider`s.
1883 These `InstrumentProvider`s are managed with a `Meter`.
1884 - Synchronous and asynchronous instruments are grouped into their own packages based on value types.
1885 - Asynchronous callbacks can now be registered with a `Meter`.
1886
1887 Be sure to check out the metric module documentation for more information on how to use the revised API. (#2587, #2660)
1888
1889 ### Fixed
1890
1891 - Fallback to general attribute limits when span specific ones are not set in the environment. (#2675, #2677)
1892
1893 ## [1.5.0] - 2022-03-16
1894
1895 ### Added
1896
1897 - Log the Exporters configuration in the TracerProviders message. (#2578)
1898 - Added support to configure the span limits with environment variables.
1899 The following environment variables are supported. (#2606, #2637)
1900 - `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`
1901 - `OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT`
1902 - `OTEL_SPAN_EVENT_COUNT_LIMIT`
1903 - `OTEL_EVENT_ATTRIBUTE_COUNT_LIMIT`
1904 - `OTEL_SPAN_LINK_COUNT_LIMIT`
1905 - `OTEL_LINK_ATTRIBUTE_COUNT_LIMIT`
1906
1907 If the provided environment variables are invalid (negative), the default values would be used.
1908 - Rename the `gc` runtime name to `go` (#2560)
1909 - Add resource container ID detection. (#2418)
1910 - Add span attribute value length limit.
1911 The new `AttributeValueLengthLimit` field is added to the `"go.opentelemetry.io/otel/sdk/trace".SpanLimits` type to configure this limit for a `TracerProvider`.
1912 The default limit for this resource is "unlimited". (#2637)
1913 - Add the `WithRawSpanLimits` option to `go.opentelemetry.io/otel/sdk/trace`.
1914 This option replaces the `WithSpanLimits` option.
1915 Zero or negative values will not be changed to the default value like `WithSpanLimits` does.
1916 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.
1917 Consequentially, limits should be constructed using `NewSpanLimits` and updated accordingly. (#2637)
1918
1919 ### Changed
1920
1921 - Drop oldest tracestate `Member` when capacity is reached. (#2592)
1922 - Add event and link drop counts to the exported data from the `oltptrace` exporter. (#2601)
1923 - Unify path cleaning functionally in the `otlpmetric` and `otlptrace` configuration. (#2639)
1924 - Change the debug message from the `sdk/trace.BatchSpanProcessor` to reflect the count is cumulative. (#2640)
1925 - Introduce new internal `envconfig` package for OTLP exporters. (#2608)
1926 - If `http.Request.Host` is empty, fall back to use `URL.Host` when populating `http.host` in the `semconv` packages. (#2661)
1927
1928 ### Fixed
1929
1930 - Remove the OTLP trace exporter limit of SpanEvents when exporting. (#2616)
1931 - Default to port `4318` instead of `4317` for the `otlpmetrichttp` and `otlptracehttp` client. (#2614, #2625)
1932 - Unlimited span limits are now supported (negative values). (#2636, #2637)
1933
1934 ### Deprecated
1935
1936 - Deprecated `"go.opentelemetry.io/otel/sdk/trace".WithSpanLimits`.
1937 Use `WithRawSpanLimits` instead.
1938 That option allows setting unlimited and zero limits, this option does not.
1939 This option will be kept until the next major version incremented release. (#2637)
1940
1941 ## [1.4.1] - 2022-02-16
1942
1943 ### Fixed
1944
1945 - Fix race condition in reading the dropped spans number for the `BatchSpanProcessor`. (#2615)
1946
1947 ## [1.4.0] - 2022-02-11
1948
1949 ### Added
1950
1951 - Use `OTEL_EXPORTER_ZIPKIN_ENDPOINT` environment variable to specify zipkin collector endpoint. (#2490)
1952 - Log the configuration of `TracerProvider`s, and `Tracer`s for debugging.
1953 To enable use a logger with Verbosity (V level) `>=1`. (#2500)
1954 - Added support to configure the batch span-processor with environment variables.
1955 The following environment variables are used. (#2515)
1956 - `OTEL_BSP_SCHEDULE_DELAY`
1957 - `OTEL_BSP_EXPORT_TIMEOUT`
1958 - `OTEL_BSP_MAX_QUEUE_SIZE`.
1959 - `OTEL_BSP_MAX_EXPORT_BATCH_SIZE`
1960
1961 ### Changed
1962
1963 - Zipkin exporter exports `Resource` attributes in the `Tags` field. (#2589)
1964
1965 ### Deprecated
1966
1967 - Deprecate module the `go.opentelemetry.io/otel/sdk/export/metric`.
1968 Use the `go.opentelemetry.io/otel/sdk/metric` module instead. (#2382)
1969 - Deprecate `"go.opentelemetry.io/otel/sdk/metric".AtomicFieldOffsets`. (#2445)
1970
1971 ### Fixed
1972
1973 - Fixed the instrument kind for noop async instruments to correctly report an implementation. (#2461)
1974 - Fix UDP packets overflowing with Jaeger payloads. (#2489, #2512)
1975 - Change the `otlpmetric.Client` interface's `UploadMetrics` method to accept a single `ResourceMetrics` instead of a slice of them. (#2491)
1976 - Specify explicit buckets in Prometheus example, fixing issue where example only has `+inf` bucket. (#2419, #2493)
1977 - W3C baggage will now decode urlescaped values. (#2529)
1978 - Baggage members are now only validated once, when calling `NewMember` and not also when adding it to the baggage itself. (#2522)
1979 - 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.
1980 Instead of dropping the least-recently-used attribute, the last added attribute is dropped.
1981 This drop order still only applies to attributes with unique keys not already contained in the span.
1982 If an attribute is added with a key already contained in the span, that attribute is updated to the new value being added. (#2576)
1983
1984 ### Removed
1985
1986 - Updated `go.opentelemetry.io/proto/otlp` from `v0.11.0` to `v0.12.0`. This version removes a number of deprecated methods. (#2546)
1987 - [`Metric.GetIntGauge()`](https://pkg.go.dev/go.opentelemetry.io/proto/[email protected]/metrics/v1#Metric.GetIntGauge)
1988 - [`Metric.GetIntHistogram()`](https://pkg.go.dev/go.opentelemetry.io/proto/[email protected]/metrics/v1#Metric.GetIntHistogram)
1989 - [`Metric.GetIntSum()`](https://pkg.go.dev/go.opentelemetry.io/proto/[email protected]/metrics/v1#Metric.GetIntSum)
1990
1991 ## [1.3.0] - 2021-12-10
1992
1993 ### ⚠️ Notice ⚠️
1994
1995 We have updated the project minimum supported Go version to 1.16
1996
1997 ### Added
1998
1999 - Added an internal Logger.
2000 This can be used by the SDK and API to provide users with feedback of the internal state.
2001 To enable verbose logs configure the logger which will print V(1) logs. For debugging information configure to print V(5) logs. (#2343)
2002 - 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)
2003 - 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)
2004
2005 ### Changed
2006
2007 - 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)
2008 - 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)
2009 - The `"go.opentelemetry.io/otel/exporter/otel/otlpmetric/otlpmetricgrpc".RetrySettings` type is renamed to `RetryConfig`. (#2425)
2010 - 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)
2011 - 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)
2012
2013 ### Fixed
2014
2015 - The `go.opentelemetry.io/otel/exporter/otel/*` exporters are updated to handle per-signal and universal endpoints according to the OpenTelemetry specification.
2016 Any per-signal endpoint set via an `OTEL_EXPORTER_OTLP_<signal>_ENDPOINT` environment variable is now used without modification of the path.
2017 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)
2018 - Basic metric controller updated to use sync.Map to avoid blocking calls (#2381)
2019 - 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)
2020
2021 ### Deprecated
2022
2023 - Deprecated the `"go.opentelemetry.io/otel/exporter/otel/otlpmetric/otlpmetrichttp".WithMaxAttempts` `Option`, use the new `WithRetry` `Option` instead. (#2425)
2024 - Deprecated the `"go.opentelemetry.io/otel/exporter/otel/otlpmetric/otlpmetrichttp".WithBackoff` `Option`, use the new `WithRetry` `Option` instead. (#2425)
2025
2026 ### Removed
2027
2028 - Remove the metric Processor's ability to convert cumulative to delta aggregation temporality. (#2350)
2029 - Remove the metric Bound Instruments interface and implementations. (#2399)
2030 - Remove the metric MinMaxSumCount kind aggregation and the corresponding OTLP export path. (#2423)
2031 - 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)
2032
2033 ## [1.2.0] - 2021-11-12
2034
2035 ### Changed
2036
2037 - 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)
2038 - The Metric `Exporter` interface now requires a `TemporalitySelector` method instead of an `ExportKindSelector`. (#2274)
2039 - Metrics API cleanup. The `metric/sdkapi` package has been created to relocate the API-to-SDK interface:
2040 - The following interface types simply moved from `metric` to `metric/sdkapi`: `Descriptor`, `MeterImpl`, `InstrumentImpl`, `SyncImpl`, `BoundSyncImpl`, `AsyncImpl`, `AsyncRunner`, `AsyncSingleRunner`, and `AsyncBatchRunner`
2041 - The following struct types moved and are replaced with type aliases, since they are exposed to the user: `Observation`, `Measurement`.
2042 - The No-op implementations of sync and async instruments are no longer exported, new functions `sdkapi.NewNoopAsyncInstrument()` and `sdkapi.NewNoopSyncInstrument()` are provided instead. (#2271)
2043 - Update the SDK `BatchSpanProcessor` to export all queued spans when `ForceFlush` is called. (#2080, #2335)
2044
2045 ### Added
2046
2047 - Add the `"go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc".WithGRPCConn` option so the exporter can reuse an existing gRPC connection. (#2002)
2048 - Added a new `schema` module to help parse Schema Files in OTEP 0152 format. (#2267)
2049 - 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)
2050
2051 ## [1.1.0] - 2021-10-27
2052
2053 ### Added
2054
2055 - Add the `"go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc".WithGRPCConn` option so the exporter can reuse an existing gRPC connection. (#2002)
2056 - Add the `go.opentelemetry.io/otel/semconv/v1.7.0` package.
2057 The package contains semantic conventions from the `v1.7.0` version of the OpenTelemetry specification. (#2320)
2058 - Add the `go.opentelemetry.io/otel/semconv/v1.6.1` package.
2059 The package contains semantic conventions from the `v1.6.1` version of the OpenTelemetry specification. (#2321)
2060 - Add the `go.opentelemetry.io/otel/semconv/v1.5.0` package.
2061 The package contains semantic conventions from the `v1.5.0` version of the OpenTelemetry specification. (#2322)
2062 - When upgrading from the `semconv/v1.4.0` package note the following name changes:
2063 - `K8SReplicasetUIDKey` -> `K8SReplicaSetUIDKey`
2064 - `K8SReplicasetNameKey` -> `K8SReplicaSetNameKey`
2065 - `K8SStatefulsetUIDKey` -> `K8SStatefulSetUIDKey`
2066 - `k8SStatefulsetNameKey` -> `K8SStatefulSetNameKey`
2067 - `K8SDaemonsetUIDKey` -> `K8SDaemonSetUIDKey`
2068 - `K8SDaemonsetNameKey` -> `K8SDaemonSetNameKey`
2069
2070 ### Changed
2071
2072 - Links added to a span will be dropped by the SDK if they contain an invalid span context (#2275).
2073
2074 ### Fixed
2075
2076 - 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)
2077 - 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)
2078 - The simple span processor shutdown method deterministically returns the exporter error status if it simultaneously finishes when the deadline is reached. (#2290, #2289)
2079
2080 ## [1.0.1] - 2021-10-01
2081
2082 ### Fixed
2083
2084 - json stdout exporter no longer crashes due to concurrency bug. (#2265)
2085
2086 ## [Metrics 0.24.0] - 2021-10-01
2087
2088 ### Changed
2089
2090 - NoopMeterProvider is now private and NewNoopMeterProvider must be used to obtain a noopMeterProvider. (#2237)
2091 - The Metric SDK `Export()` function takes a new two-level reader interface for iterating over results one instrumentation library at a time. (#2197)
2092 - The former `"go.opentelemetry.io/otel/sdk/export/metric".CheckpointSet` is renamed `Reader`.
2093 - The new interface is named `"go.opentelemetry.io/otel/sdk/export/metric".InstrumentationLibraryReader`.
2094
2095 ## [1.0.0] - 2021-09-20
2096
2097 This is the first stable release for the project.
2098 This 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).
2099
2100 ### Added
2101
2102 - OTLP trace exporter now sets the `SchemaURL` field in the exported telemetry if the Tracer has `WithSchemaURL` option. (#2242)
2103
2104 ### Fixed
2105
2106 - Slice-valued attributes can correctly be used as map keys. (#2223)
2107
2108 ### Removed
2109
2110 - Removed the `"go.opentelemetry.io/otel/exporters/zipkin".WithSDKOptions` function. (#2248)
2111 - Removed the deprecated package `go.opentelemetry.io/otel/oteltest`. (#2234)
2112 - Removed the deprecated package `go.opentelemetry.io/otel/bridge/opencensus/utils`. (#2233)
2113 - Removed deprecated functions, types, and methods from `go.opentelemetry.io/otel/attribute` package.
2114 Use the typed functions and methods added to the package instead. (#2235)
2115 - The `Key.Array` method is removed.
2116 - The `Array` function is removed.
2117 - The `Any` function is removed.
2118 - The `ArrayValue` function is removed.
2119 - The `AsArray` function is removed.
2120
2121 ## [1.0.0-RC3] - 2021-09-02
2122
2123 ### Added
2124
2125 - Added `ErrorHandlerFunc` to use a function as an `"go.opentelemetry.io/otel".ErrorHandler`. (#2149)
2126 - 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)
2127 - Added typed slice attribute types and functionality to the `go.opentelemetry.io/otel/attribute` package to replace the existing array type and functions. (#2162)
2128 - `BoolSlice`, `IntSlice`, `Int64Slice`, `Float64Slice`, and `StringSlice` replace the use of the `Array` function in the package.
2129 - Added the `go.opentelemetry.io/otel/example/fib` example package.
2130 Included is an example application that computes Fibonacci numbers. (#2203)
2131
2132 ### Changed
2133
2134 - Metric instruments have been renamed to match the (feature-frozen) metric API specification:
2135 - ValueRecorder becomes Histogram
2136 - ValueObserver becomes Gauge
2137 - SumObserver becomes CounterObserver
2138 - UpDownSumObserver becomes UpDownCounterObserver
2139 The API exported from this project is still considered experimental. (#2202)
2140 - Metric SDK/API implementation type `InstrumentKind` moves into `sdkapi` sub-package. (#2091)
2141 - 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)
2142 - 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)
2143 - 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)
2144
2145 ### Deprecated
2146
2147 - The `go.opentelemetry.io/otel/bridge/opencensus/utils` package is deprecated.
2148 All functionality from this package now exists in the `go.opentelemetry.io/otel/bridge/opencensus` package.
2149 The functions from that package should be used instead. (#2166)
2150 - The `"go.opentelemetry.io/otel/attribute".Array` function and the related `ARRAY` value type is deprecated.
2151 Use the typed `*Slice` functions and types added to the package instead. (#2162)
2152 - The `"go.opentelemetry.io/otel/attribute".Any` function is deprecated.
2153 Use the typed functions instead. (#2181)
2154 - The `go.opentelemetry.io/otel/oteltest` package is deprecated.
2155 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)
2156
2157 ### Removed
2158
2159 - Removed metrics test package `go.opentelemetry.io/otel/sdk/export/metric/metrictest`. (#2105)
2160
2161 ### Fixed
2162
2163 - The `fromEnv` detector no longer throws an error when `OTEL_RESOURCE_ATTRIBUTES` environment variable is not set or empty. (#2138)
2164 - Setting the global `ErrorHandler` with `"go.opentelemetry.io/otel".SetErrorHandler` multiple times is now supported. (#2160, #2140)
2165 - The `"go.opentelemetry.io/otel/attribute".Any` function now supports `int32` values. (#2169)
2166 - 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)
2167 - The `WithoutTimestamps` option for the `go.opentelemetry.io/otel/exporters/stdout/stdouttrace` exporter causes the exporter to correctly omit timestamps. (#2195)
2168 - Fixed typos in resources.go. (#2201)
2169
2170 ## [1.0.0-RC2] - 2021-07-26
2171
2172 ### Added
2173
2174 - Added `WithOSDescription` resource configuration option to set OS (Operating System) description resource attribute (`os.description`). (#1840)
2175 - Added `WithOS` resource configuration option to set all OS (Operating System) resource attributes at once. (#1840)
2176 - Added the `WithRetry` option to the `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp` package.
2177 This option is a replacement for the removed `WithMaxAttempts` and `WithBackoff` options. (#2095)
2178 - Added API `LinkFromContext` to return Link which encapsulates SpanContext from provided context and also encapsulates attributes. (#2115)
2179 - 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`.
2180 This new type replaces the equal-named API `Link` type found in the `otel/trace` package for most usages within the SDK.
2181 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)
2182 - Added the `SpanRecorder` type to the `go.opentelemetry.io/otel/skd/trace/tracetest` package.
2183 This type can be used with the default SDK as a `SpanProcessor` during testing. (#2132)
2184
2185 ### Changed
2186
2187 - The `SpanModels` function is now exported from the `go.opentelemetry.io/otel/exporters/zipkin` package to convert OpenTelemetry spans into Zipkin model spans. (#2027)
2188 - Rename the `"go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc".RetrySettings` to `RetryConfig`. (#2095)
2189
2190 ### Deprecated
2191
2192 - The `TextMapCarrier` and `TextMapPropagator` from the `go.opentelemetry.io/otel/oteltest` package and their associated creation functions (`TextMapCarrier`, `NewTextMapPropagator`) are deprecated. (#2114)
2193 - 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)
2194 - The `TraceStateFromKeyValues` function from the `go.opentelemetry.io/otel/oteltest` package is deprecated.
2195 Use the `trace.ParseTraceState` function instead. (#2122)
2196
2197 ### Removed
2198
2199 - Removed the deprecated package `go.opentelemetry.io/otel/exporters/trace/jaeger`. (#2020)
2200 - Removed the deprecated package `go.opentelemetry.io/otel/exporters/trace/zipkin`. (#2020)
2201 - Removed the `"go.opentelemetry.io/otel/sdk/resource".WithBuiltinDetectors` function.
2202 The explicit `With*` options for every built-in detector should be used instead. (#2026 #2097)
2203 - Removed the `WithMaxAttempts` and `WithBackoff` options from the `go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp` package.
2204 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)
2205 - Removed `DroppedAttributeCount` field from `otel/trace.Link` struct. (#2118)
2206
2207 ### Fixed
2208
2209 - When using WithNewRoot, don't use the parent context for making sampling decisions. (#2032)
2210 - `oteltest.Tracer` now creates a valid `SpanContext` when using `WithNewRoot`. (#2073)
2211 - OS type detector now sets the correct `dragonflybsd` value for DragonFly BSD. (#2092)
2212 - The OTel span status is correctly transformed into the OTLP status in the `go.opentelemetry.io/otel/exporters/otlp/otlptrace` package.
2213 This fix will by default set the status to `Unset` if it is not explicitly set to `Ok` or `Error`. (#2099 #2102)
2214 - The `Inject` method for the `"go.opentelemetry.io/otel/propagation".TraceContext` type no longer injects empty `tracestate` values. (#2108)
2215 - Use `6831` as default Jaeger agent port instead of `6832`. (#2131)
2216
2217 ## [Experimental Metrics v0.22.0] - 2021-07-19
2218
2219 ### Added
2220
2221 - Adds HTTP support for OTLP metrics exporter. (#2022)
2222
2223 ### Removed
2224
2225 - Removed the deprecated package `go.opentelemetry.io/otel/exporters/metric/prometheus`. (#2020)
2226
2227 ## [1.0.0-RC1] / 0.21.0 - 2021-06-18
2228
2229 With 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`
2230 while 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
2231 with major version 0.
2232
2233 ### Added
2234
2235 - Adds `otlpgrpc.WithRetry`option for configuring the retry policy for transient errors on the otlp/gRPC exporter. (#1832)
2236 - The following status codes are defined as transient errors:
2237 | gRPC Status Code | Description |
2238 | ---------------- | ----------- |
2239 | 1 | Cancelled |
2240 | 4 | Deadline Exceeded |
2241 | 8 | Resource Exhausted |
2242 | 10 | Aborted |
2243 | 10 | Out of Range |
2244 | 14 | Unavailable |
2245 | 15 | Data Loss |
2246 - Added `Status` type to the `go.opentelemetry.io/otel/sdk/trace` package to represent the status of a span. (#1874)
2247 - Added `SpanStub` type and its associated functions to the `go.opentelemetry.io/otel/sdk/trace/tracetest` package.
2248 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)
2249 - Adds support for scheme in `OTEL_EXPORTER_OTLP_ENDPOINT` according to the spec. (#1886)
2250 - Adds `trace.WithSchemaURL` option for configuring the tracer with a Schema URL. (#1889)
2251 - Added an example of using OpenTelemetry Go as a trace context forwarder. (#1912)
2252 - `ParseTraceState` is added to the `go.opentelemetry.io/otel/trace` package.
2253 It can be used to decode a `TraceState` from a `tracestate` header string value. (#1937)
2254 - Added `Len` method to the `TraceState` type in the `go.opentelemetry.io/otel/trace` package.
2255 This method returns the number of list-members the `TraceState` holds. (#1937)
2256 - Creates package `go.opentelemetry.io/otel/exporters/otlp/otlptrace` that defines a trace exporter that uses a `otlptrace.Client` to send data.
2257 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)
2258 - Added `Baggage`, `Member`, and `Property` types to the `go.opentelemetry.io/otel/baggage` package along with their related functions. (#1967)
2259 - Added `ContextWithBaggage`, `ContextWithoutBaggage`, and `FromContext` functions to the `go.opentelemetry.io/otel/baggage` package.
2260 These functions replace the `Set`, `Value`, `ContextWithValue`, `ContextWithoutValue`, and `ContextWithEmpty` functions from that package and directly work with the new `Baggage` type. (#1967)
2261 - 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)
2262 - 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)
2263 - 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)
2264 - Several builtin resource detectors now correctly populate the schema URL. (#1938)
2265 - Creates package `go.opentelemetry.io/otel/exporters/otlp/otlpmetric` that defines a metrics exporter that uses a `otlpmetric.Client` to send data.
2266 - 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)
2267 - Added `go.opentelemetry.io/otel/exporters/stdout/stdouttrace` exporter. (#2005)
2268 - Added `go.opentelemetry.io/otel/exporters/stdout/stdoutmetric` exporter. (#2005)
2269 - 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)
2270
2271 ### Changed
2272
2273 - Make `NewSplitDriver` from `go.opentelemetry.io/otel/exporters/otlp` take variadic arguments instead of a `SplitConfig` item.
2274 `NewSplitDriver` now automatically implements an internal `noopDriver` for `SplitConfig` fields that are not initialized. (#1798)
2275 - `resource.New()` now creates a Resource without builtin detectors. Previous behavior is now achieved by using `WithBuiltinDetectors` Option. (#1810)
2276 - Move the `Event` type from the `go.opentelemetry.io/otel` package to the `go.opentelemetry.io/otel/sdk/trace` package. (#1846)
2277 - CI builds validate against last two versions of Go, dropping 1.14 and adding 1.16. (#1865)
2278 - BatchSpanProcessor now report export failures when calling `ForceFlush()` method. (#1860)
2279 - `Set.Encoded(Encoder)` no longer caches the result of an encoding. (#1855)
2280 - Renamed `CloudZoneKey` to `CloudAvailabilityZoneKey` in Resource semantic conventions according to spec. (#1871)
2281 - 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.
2282 This method returns the status of a span using the new `Status` type. (#1874)
2283 - Updated `ExportSpans` method of the`SpanExporter` interface type to accept `ReadOnlySpan`s instead of the removed `SpanSnapshot`.
2284 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)
2285 - Unembed `SpanContext` in `Link`. (#1877)
2286 - Generate Semantic conventions from the specification YAML. (#1891)
2287 - 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)
2288 - The `"go.opentelemetry.io/otel".Tracer` function now accepts tracer options. (#1902)
2289 - Move the `go.opentelemetry.io/otel/unit` package to `go.opentelemetry.io/otel/metric/unit`. (#1903)
2290 - Changed `go.opentelemetry.io/otel/trace.TracerConfig` to conform to the [Contributing guidelines](CONTRIBUTING.md#config.) (#1921)
2291 - Changed `go.opentelemetry.io/otel/trace.SpanConfig` to conform to the [Contributing guidelines](CONTRIBUTING.md#config). (#1921)
2292 - Changed `span.End()` now only accepts Options that are allowed at `End()`. (#1921)
2293 - Changed `go.opentelemetry.io/otel/metric.InstrumentConfig` to conform to the [Contributing guidelines](CONTRIBUTING.md#config). (#1921)
2294 - Changed `go.opentelemetry.io/otel/metric.MeterConfig` to conform to the [Contributing guidelines](CONTRIBUTING.md#config). (#1921)
2295 - Refactored option types according to the contribution style guide. (#1882)
2296 - Move the `go.opentelemetry.io/otel/trace.TraceStateFromKeyValues` function to the `go.opentelemetry.io/otel/oteltest` package.
2297 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.
2298 The new `ParseTraceState` function should be used to create a `TraceState`. (#1931)
2299 - Updated `MarshalJSON` method of the `go.opentelemetry.io/otel/trace.TraceState` type to marshal the type into the string representation of the `TraceState`. (#1931)
2300 - The `TraceState.Delete` method from the `go.opentelemetry.io/otel/trace` package no longer returns an error in addition to a `TraceState`. (#1931)
2301 - 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)
2302 - 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)
2303 - 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)
2304 - Renamed `NewExporter` to `New` in the `go.opentelemetry.io/otel/exporters/stdout` package. (#1985)
2305 - Renamed `NewExporter` to `New` in the `go.opentelemetry.io/otel/exporters/metric/prometheus` package. (#1985)
2306 - Renamed `NewExporter` to `New` in the `go.opentelemetry.io/otel/exporters/trace/jaeger` package. (#1985)
2307 - Renamed `NewExporter` to `New` in the `go.opentelemetry.io/otel/exporters/trace/zipkin` package. (#1985)
2308 - Renamed `NewExporter` to `New` in the `go.opentelemetry.io/otel/exporters/otlp` package. (#1985)
2309 - Renamed `NewUnstartedExporter` to `NewUnstarted` in the `go.opentelemetry.io/otel/exporters/otlp` package. (#1985)
2310 - 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)
2311 - Metrics test helpers in `go.opentelemetry.io/otel/oteltest` have been moved to `go.opentelemetry.io/otel/metric/metrictest`. (#1988)
2312
2313 ### Deprecated
2314
2315 - The `go.opentelemetry.io/otel/exporters/metric/prometheus` is deprecated, use `go.opentelemetry.io/otel/exporters/prometheus` instead. (#1993)
2316 - The `go.opentelemetry.io/otel/exporters/trace/jaeger` is deprecated, use `go.opentelemetry.io/otel/exporters/jaeger` instead. (#1993)
2317 - The `go.opentelemetry.io/otel/exporters/trace/zipkin` is deprecated, use `go.opentelemetry.io/otel/exporters/zipkin` instead. (#1993)
2318
2319 ### Removed
2320
2321 - Removed `resource.WithoutBuiltin()`. Use `resource.New()`. (#1810)
2322 - Unexported types `resource.FromEnv`, `resource.Host`, and `resource.TelemetrySDK`, Use the corresponding `With*()` to use individually. (#1810)
2323 - Removed the `Tracer` and `IsRecording` method from the `ReadOnlySpan` in the `go.opentelemetry.io/otel/sdk/trace`.
2324 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.
2325 The `IsRecording` method returns if the span is recording or not.
2326 A read-only span value does not need to know if updates to it will be recorded or not.
2327 By definition, it cannot be updated so there is no point in communicating if an update is recorded. (#1873)
2328 - Removed the `SpanSnapshot` type from the `go.opentelemetry.io/otel/sdk/trace` package.
2329 The use of this type has been replaced with the use of the explicitly immutable `ReadOnlySpan` type.
2330 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)
2331 - Removed the `Tracer` method from the `Span` interface in the `go.opentelemetry.io/otel/trace` package.
2332 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.
2333 The `"go.opentelemetry.io/otel".Tracer` function or a `TracerProvider` should be used to acquire a library specific `Tracer` instead. (#1900)
2334 - The `TracerProvider()` method on the `Span` interface may also be used to obtain a `TracerProvider` using the same trace processing pipeline. (#2009)
2335 - The `http.url` attribute generated by `HTTPClientAttributesFromHTTPRequest` will no longer include username or password information. (#1919)
2336 - 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)
2337 - Removed `Set`, `Value`, `ContextWithValue`, `ContextWithoutValue`, and `ContextWithEmpty` functions in the `go.opentelemetry.io/otel/baggage` package.
2338 Handling of baggage is now done using the added `Baggage` type and related context functions (`ContextWithBaggage`, `ContextWithoutBaggage`, and `FromContext`) in that package. (#1967)
2339 - The `InstallNewPipeline` and `NewExportPipeline` creation functions in all the exporters (prometheus, otlp, stdout, jaeger, and zipkin) have been removed.
2340 These functions were deemed premature attempts to provide convenience that did not achieve this aim. (#1985)
2341 - The `go.opentelemetry.io/otel/exporters/otlp` exporter has been removed. Use `go.opentelemetry.io/otel/exporters/otlp/otlptrace` instead. (#1990)
2342 - 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)
2343
2344 ### Fixed
2345
2346 - Only report errors from the `"go.opentelemetry.io/otel/sdk/resource".Environment` function when they are not `nil`. (#1850, #1851)
2347 - 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)
2348 - BatchSpanProcessor now drops span batches that failed to be exported. (#1860)
2349 - Use `http://localhost:14268/api/traces` as default Jaeger collector endpoint instead of `http://localhost:14250`. (#1898)
2350 - Allow trailing and leading whitespace in the parsing of a `tracestate` header. (#1931)
2351 - Add logic to determine if the channel is closed to fix Jaeger exporter test panic with close closed channel. (#1870, #1973)
2352 - Avoid transport security when OTLP endpoint is a Unix socket. (#2001)
2353
2354 ### Security
2355
2356 ## [0.20.0] - 2021-04-23
2357
2358 ### Added
2359
2360 - The OTLP exporter now has two new convenience functions, `NewExportPipeline` and `InstallNewPipeline`, setup and install the exporter in tracing and metrics pipelines. (#1373)
2361 - Adds semantic conventions for exceptions. (#1492)
2362 - Added Jaeger Environment variables: `OTEL_EXPORTER_JAEGER_AGENT_HOST`, `OTEL_EXPORTER_JAEGER_AGENT_PORT`
2363 These environment variables can be used to override Jaeger agent hostname and port (#1752)
2364 - Option `ExportTimeout` was added to batch span processor. (#1755)
2365 - `trace.TraceFlags` is now a defined type over `byte` and `WithSampled(bool) TraceFlags` and `IsSampled() bool` methods have been added to it. (#1770)
2366 - 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)
2367 - The Jaeger exporter now reports dropped attributes for a Span event in the exported log. (#1771)
2368 - Adds test to check BatchSpanProcessor ignores `OnEnd` and `ForceFlush` post `Shutdown`. (#1772)
2369 - 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)
2370 - Added `WithOSType` resource configuration option to set OS (Operating System) type resource attribute (`os.type`). (#1788)
2371 - Added `WithProcess*` resource configuration options to set Process resource attributes. (#1788)
2372 - `process.pid`
2373 - `process.executable.name`
2374 - `process.executable.path`
2375 - `process.command_args`
2376 - `process.owner`
2377 - `process.runtime.name`
2378 - `process.runtime.version`
2379 - `process.runtime.description`
2380 - Adds `k8s.node.name` and `k8s.node.uid` attribute keys to the `semconv` package. (#1789)
2381 - Added support for configuring OTLP/HTTP and OTLP/gRPC Endpoints, TLS Certificates, Headers, Compression and Timeout via Environment Variables. (#1758, #1769 and #1811)
2382 - `OTEL_EXPORTER_OTLP_ENDPOINT`
2383 - `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`
2384 - `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`
2385 - `OTEL_EXPORTER_OTLP_HEADERS`
2386 - `OTEL_EXPORTER_OTLP_TRACES_HEADERS`
2387 - `OTEL_EXPORTER_OTLP_METRICS_HEADERS`
2388 - `OTEL_EXPORTER_OTLP_COMPRESSION`
2389 - `OTEL_EXPORTER_OTLP_TRACES_COMPRESSION`
2390 - `OTEL_EXPORTER_OTLP_METRICS_COMPRESSION`
2391 - `OTEL_EXPORTER_OTLP_TIMEOUT`
2392 - `OTEL_EXPORTER_OTLP_TRACES_TIMEOUT`
2393 - `OTEL_EXPORTER_OTLP_METRICS_TIMEOUT`
2394 - `OTEL_EXPORTER_OTLP_CERTIFICATE`
2395 - `OTEL_EXPORTER_OTLP_TRACES_CERTIFICATE`
2396 - `OTEL_EXPORTER_OTLP_METRICS_CERTIFICATE`
2397 - Adds `otlpgrpc.WithTimeout` option for configuring timeout to the otlp/gRPC exporter. (#1821)
2398 - Adds `jaeger.WithMaxPacketSize` option for configuring maximum UDP packet size used when connecting to the Jaeger agent. (#1853)
2399
2400 ### Fixed
2401
2402 - The `Span.IsRecording` implementation from `go.opentelemetry.io/otel/sdk/trace` always returns false when not being sampled. (#1750)
2403 - The Jaeger exporter now correctly sets tags for the Span status code and message.
2404 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)
2405 - The Jaeger exporter now correctly records Span event's names using the `"event"` key for a tag.
2406 Additionally, this tag is overridden, as specified in the OTel specification, if the event contains an attribute with that key. (#1768)
2407 - Zipkin Exporter: Ensure mapping between OTel and Zipkin span data complies with the specification. (#1688)
2408 - Fixed typo for default service name in Jaeger Exporter. (#1797)
2409 - Fix flaky OTLP for the reconnnection of the client connection. (#1527, #1814)
2410 - Fix Jaeger exporter dropping of span batches that exceed the UDP packet size limit.
2411 Instead, the exporter now splits the batch into smaller sendable batches. (#1828)
2412
2413 ### Changed
2414
2415 - Span `RecordError` now records an `exception` event to comply with the semantic convention specification. (#1492)
2416 - Jaeger exporter was updated to use thrift v0.14.1. (#1712)
2417 - Migrate from using internally built and maintained version of the OTLP to the one hosted at `go.opentelemetry.io/proto/otlp`. (#1713)
2418 - Migrate from using `github.com/gogo/protobuf` to `google.golang.org/protobuf` to match `go.opentelemetry.io/proto/otlp`. (#1713)
2419 - The storage of a local or remote Span in a `context.Context` using its SpanContext is unified to store just the current Span.
2420 The Span's SpanContext can now self-identify as being remote or not.
2421 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)
2422 - Improve OTLP/gRPC exporter connection errors. (#1737)
2423 - Information about a parent span context in a `"go.opentelemetry.io/otel/export/trace".SpanSnapshot` is unified in a new `Parent` field.
2424 The existing `ParentSpanID` and `HasRemoteParent` fields are removed in favor of this. (#1748)
2425 - The `ParentContext` field of the `"go.opentelemetry.io/otel/sdk/trace".SamplingParameters` is updated to hold a `context.Context` containing the parent span.
2426 This changes it to make `SamplingParameters` conform with the OpenTelemetry specification. (#1749)
2427 - Updated Jaeger Environment Variables: `JAEGER_ENDPOINT`, `JAEGER_USER`, `JAEGER_PASSWORD`
2428 to `OTEL_EXPORTER_JAEGER_ENDPOINT`, `OTEL_EXPORTER_JAEGER_USER`, `OTEL_EXPORTER_JAEGER_PASSWORD` in compliance with OTel specification. (#1752)
2429 - Modify `BatchSpanProcessor.ForceFlush` to abort after timeout/cancellation. (#1757)
2430 - 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.
2431 It no longer is a conglomerate of itself, events, and link attributes that have been dropped. (#1771)
2432 - Make `ExportSpans` in Jaeger Exporter honor context deadline. (#1773)
2433 - Modify Zipkin Exporter default service name, use default resource's serviceName instead of empty. (#1777)
2434 - The `go.opentelemetry.io/otel/sdk/export/trace` package is merged into the `go.opentelemetry.io/otel/sdk/trace` package. (#1778)
2435 - The prometheus.InstallNewPipeline example is moved from comment to example test (#1796)
2436 - The convenience functions for the stdout exporter have been updated to return the `TracerProvider` implementation and enable the shutdown of the exporter. (#1800)
2437 - Replace the flush function returned from the Jaeger exporter's convenience creation functions (`InstallNewPipeline` and `NewExportPipeline`) with the `TracerProvider` implementation they create.
2438 This enables the caller to shutdown and flush using the related `TracerProvider` methods. (#1822)
2439 - Updated the Jaeger exporter to have a default endpoint, `http://localhost:14250`, for the collector. (#1824)
2440 - Changed the function `WithCollectorEndpoint` in the Jaeger exporter to no longer accept an endpoint as an argument.
2441 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)
2442 - The Jaeger exporter no longer batches exported spans itself, instead it relies on the SDK's `BatchSpanProcessor` for this functionality. (#1830)
2443 - The Jaeger exporter creation functions (`NewRawExporter`, `NewExportPipeline`, and `InstallNewPipeline`) no longer accept the removed `Option` type as a variadic argument. (#1830)
2444
2445 ### Removed
2446
2447 - Removed Jaeger Environment variables: `JAEGER_SERVICE_NAME`, `JAEGER_DISABLED`, `JAEGER_TAGS`
2448 These environment variables will no longer be used to override values of the Jaeger exporter (#1752)
2449 - No longer set the links for a `Span` in `go.opentelemetry.io/otel/sdk/trace` that is configured to be a new root.
2450 This is unspecified behavior that the OpenTelemetry community plans to standardize in the future.
2451 To prevent backwards incompatible changes when it is specified, these links are removed. (#1726)
2452 - Setting error status while recording error with Span from oteltest package. (#1729)
2453 - The concept of a remote and local Span stored in a context is unified to just the current Span.
2454 Because of this `"go.opentelemetry.io/otel/trace".RemoteSpanContextFromContext` is removed as it is no longer needed.
2455 Instead, `"go.opentelemetry.io/otel/trace".SpanContextFromContext` can be used to return the current Span.
2456 If needed, that Span's `SpanContext.IsRemote()` can then be used to determine if it is remote or not. (#1731)
2457 - The `HasRemoteParent` field of the `"go.opentelemetry.io/otel/sdk/trace".SamplingParameters` is removed.
2458 This field is redundant to the information returned from the `Remote` method of the `SpanContext` held in the `ParentContext` field. (#1749)
2459 - The `trace.FlagsDebug` and `trace.FlagsDeferred` constants have been removed and will be localized to the B3 propagator. (#1770)
2460 - Remove `Process` configuration, `WithProcessFromEnv` and `ProcessFromEnv`, and type from the Jaeger exporter package.
2461 The information that could be configured in the `Process` struct should be configured in a `Resource` instead. (#1776, #1804)
2462 - Remove the `WithDisabled` option from the Jaeger exporter.
2463 To disable the exporter unregister it from the `TracerProvider` or use a no-operation `TracerProvider`. (#1806)
2464 - Removed the functions `CollectorEndpointFromEnv` and `WithCollectorEndpointOptionFromEnv` from the Jaeger exporter.
2465 These functions for retrieving specific environment variable values are redundant of other internal functions and
2466 are not intended for end user use. (#1824)
2467 - Removed the Jaeger exporter `WithSDKOptions` `Option`.
2468 This option was used to set SDK options for the exporter creation convenience functions.
2469 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.
2470 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)
2471 - The `WithBufferMaxCount` and `WithBatchMaxCount` `Option`s from the Jaeger exporter are removed.
2472 The exporter no longer batches exports, instead relying on the SDK's `BatchSpanProcessor` for this functionality. (#1830)
2473 - The Jaeger exporter `Option` type is removed.
2474 The type is no longer used by the exporter to configure anything.
2475 All the previous configurations these options provided were duplicates of SDK configuration.
2476 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)
2477
2478 ## [0.19.0] - 2021-03-18
2479
2480 ### Added
2481
2482 - Added `Marshaler` config option to `otlphttp` to enable otlp over json or protobufs. (#1586)
2483 - A `ForceFlush` method to the `"go.opentelemetry.io/otel/sdk/trace".TracerProvider` to flush all registered `SpanProcessor`s. (#1608)
2484 - Added `WithSampler` and `WithSpanLimits` to tracer provider. (#1633, #1702)
2485 - `"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)
2486 - A `Valid` method to the `"go.opentelemetry.io/otel/attribute".KeyValue` type. (#1703)
2487
2488 ### Changed
2489
2490 - `trace.SpanContext` is now immutable and has no exported fields. (#1573)
2491 - `trace.NewSpanContext()` can be used in conjunction with the `trace.SpanContextConfig` struct to initialize a new `SpanContext` where all values are known.
2492 - Update the `ForceFlush` method signature to the `"go.opentelemetry.io/otel/sdk/trace".SpanProcessor` to accept a `context.Context` and return an error. (#1608)
2493 - Update the `Shutdown` method to the `"go.opentelemetry.io/otel/sdk/trace".TracerProvider` return an error on shutdown failure. (#1608)
2494 - The SimpleSpanProcessor will now shut down the enclosed `SpanExporter` and gracefully ignore subsequent calls to `OnEnd` after `Shutdown` is called. (#1612)
2495 - `"go.opentelemetry.io/sdk/metric/controller.basic".WithPusher` is replaced with `WithExporter` to provide consistent naming across project. (#1656)
2496 - Added non-empty string check for trace `Attribute` keys. (#1659)
2497 - Add `description` to SpanStatus only when `StatusCode` is set to error. (#1662)
2498 - Jaeger exporter falls back to `resource.Default`'s `service.name` if the exported Span does not have one. (#1673)
2499 - Jaeger exporter populates Jaeger's Span Process from Resource. (#1673)
2500 - Renamed the `LabelSet` method of `"go.opentelemetry.io/otel/sdk/resource".Resource` to `Set`. (#1692)
2501 - Changed `WithSDK` to `WithSDKOptions` to accept variadic arguments of `TracerProviderOption` type in `go.opentelemetry.io/otel/exporters/trace/jaeger` package. (#1693)
2502 - Changed `WithSDK` to `WithSDKOptions` to accept variadic arguments of `TracerProviderOption` type in `go.opentelemetry.io/otel/exporters/trace/zipkin` package. (#1693)
2503
2504 ### Removed
2505
2506 - Removed `serviceName` parameter from Zipkin exporter and uses resource instead. (#1549)
2507 - Removed `WithConfig` from tracer provider to avoid overriding configuration. (#1633)
2508 - Removed the exported `SimpleSpanProcessor` and `BatchSpanProcessor` structs.
2509 These are now returned as a SpanProcessor interface from their respective constructors. (#1638)
2510 - Removed `WithRecord()` from `trace.SpanOption` when creating a span. (#1660)
2511 - Removed setting status to `Error` while recording an error as a span event in `RecordError`. (#1663)
2512 - Removed `jaeger.WithProcess` configuration option. (#1673)
2513 - Removed `ApplyConfig` method from `"go.opentelemetry.io/otel/sdk/trace".TracerProvider` and the now unneeded `Config` struct. (#1693)
2514
2515 ### Fixed
2516
2517 - Jaeger Exporter: Ensure mapping between OTEL and Jaeger span data complies with the specification. (#1626)
2518 - `SamplingResult.TraceState` is correctly propagated to a newly created span's `SpanContext`. (#1655)
2519 - The `otel-collector` example now correctly flushes metric events prior to shutting down the exporter. (#1678)
2520 - Do not set span status message in `SpanStatusFromHTTPStatusCode` if it can be inferred from `http.status_code`. (#1681)
2521 - Synchronization issues in global trace delegate implementation. (#1686)
2522 - Reduced excess memory usage by global `TracerProvider`. (#1687)
2523
2524 ## [0.18.0] - 2021-03-03
2525
2526 ### Added
2527
2528 - Added `resource.Default()` for use with meter and tracer providers. (#1507)
2529 - `AttributePerEventCountLimit` and `AttributePerLinkCountLimit` for `SpanLimits`. (#1535)
2530 - Added `Keys()` method to `propagation.TextMapCarrier` and `propagation.HeaderCarrier` to adapt `http.Header` to this interface. (#1544)
2531 - Added `code` attributes to `go.opentelemetry.io/otel/semconv` package. (#1558)
2532 - Compatibility testing suite in the CI system for the following systems. (#1567)
2533 | OS | Go Version | Architecture |
2534 | ------- | ---------- | ------------ |
2535 | Ubuntu | 1.15 | amd64 |
2536 | Ubuntu | 1.14 | amd64 |
2537 | Ubuntu | 1.15 | 386 |
2538 | Ubuntu | 1.14 | 386 |
2539 | MacOS | 1.15 | amd64 |
2540 | MacOS | 1.14 | amd64 |
2541 | Windows | 1.15 | amd64 |
2542 | Windows | 1.14 | amd64 |
2543 | Windows | 1.15 | 386 |
2544 | Windows | 1.14 | 386 |
2545
2546 ### Changed
2547
2548 - Replaced interface `oteltest.SpanRecorder` with its existing implementation
2549 `StandardSpanRecorder`. (#1542)
2550 - Default span limit values to 128. (#1535)
2551 - Rename `MaxEventsPerSpan`, `MaxAttributesPerSpan` and `MaxLinksPerSpan` to `EventCountLimit`, `AttributeCountLimit` and `LinkCountLimit`, and move these fields into `SpanLimits`. (#1535)
2552 - Renamed the `otel/label` package to `otel/attribute`. (#1541)
2553 - Vendor the Jaeger exporter's dependency on Apache Thrift. (#1551)
2554 - Parallelize the CI linting and testing. (#1567)
2555 - Stagger timestamps in exact aggregator tests. (#1569)
2556 - Changed all examples to use `WithBatchTimeout(5 * time.Second)` rather than `WithBatchTimeout(5)`. (#1621)
2557 - Prevent end-users from implementing some interfaces (#1575)
2558
2559 ```
2560 "otel/exporters/otlp/otlphttp".Option
2561 "otel/exporters/stdout".Option
2562 "otel/oteltest".Option
2563 "otel/trace".TracerOption
2564 "otel/trace".SpanOption
2565 "otel/trace".EventOption
2566 "otel/trace".LifeCycleOption
2567 "otel/trace".InstrumentationOption
2568 "otel/sdk/resource".Option
2569 "otel/sdk/trace".ParentBasedSamplerOption
2570 "otel/sdk/trace".ReadOnlySpan
2571 "otel/sdk/trace".ReadWriteSpan
2572 ```
2573
2574 ### Removed
2575
2576 - Removed attempt to resample spans upon changing the span name with `span.SetName()`. (#1545)
2577 - The `test-benchmark` is no longer a dependency of the `precommit` make target. (#1567)
2578 - Removed the `test-386` make target.
2579 This was replaced with a full compatibility testing suite (i.e. multi OS/arch) in the CI system. (#1567)
2580
2581 ### Fixed
2582
2583 - The sequential timing check of timestamps in the stdout exporter are now setup explicitly to be sequential (#1571). (#1572)
2584 - Windows build of Jaeger tests now compiles with OS specific functions (#1576). (#1577)
2585 - The sequential timing check of timestamps of go.opentelemetry.io/otel/sdk/metric/aggregator/lastvalue are now setup explicitly to be sequential (#1578). (#1579)
2586 - Validate tracestate header keys with vendors according to the W3C TraceContext specification (#1475). (#1581)
2587 - The OTLP exporter includes related labels for translations of a GaugeArray (#1563). (#1570)
2588
2589 ## [0.17.0] - 2021-02-12
2590
2591 ### Changed
2592
2593 - Rename project default branch from `master` to `main`. (#1505)
2594 - Reverse order in which `Resource` attributes are merged, per change in spec. (#1501)
2595 - Add tooling to maintain "replace" directives in go.mod files automatically. (#1528)
2596 - Create new modules: otel/metric, otel/trace, otel/oteltest, otel/sdk/export/metric, otel/sdk/metric (#1528)
2597 - Move metric-related public global APIs from otel to otel/metric/global. (#1528)
2598
2599 ## Fixed
2600
2601 - Fixed otlpgrpc reconnection issue.
2602 - 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)
2603 - The otel-collector example now uses the default OTLP receiver port of the collector.
2604
2605 ## [0.16.0] - 2021-01-13
2606
2607 ### Added
2608
2609 - Add the `ReadOnlySpan` and `ReadWriteSpan` interfaces to provide better control for accessing span data. (#1360)
2610 - `NewGRPCDriver` function returns a `ProtocolDriver` that maintains a single gRPC connection to the collector. (#1369)
2611 - Added documentation about the project's versioning policy. (#1388)
2612 - Added `NewSplitDriver` for OTLP exporter that allows sending traces and metrics to different endpoints. (#1418)
2613 - Added codeql workflow to GitHub Actions (#1428)
2614 - Added Gosec workflow to GitHub Actions (#1429)
2615 - Add new HTTP driver for OTLP exporter in `exporters/otlp/otlphttp`. Currently it only supports the binary protobuf payloads. (#1420)
2616 - Add an OpenCensus exporter bridge. (#1444)
2617
2618 ### Changed
2619
2620 - Rename `internal/testing` to `internal/internaltest`. (#1449)
2621 - Rename `export.SpanData` to `export.SpanSnapshot` and use it only for exporting spans. (#1360)
2622 - Store the parent's full `SpanContext` rather than just its span ID in the `span` struct. (#1360)
2623 - Improve span duration accuracy. (#1360)
2624 - Migrated CI/CD from CircleCI to GitHub Actions (#1382)
2625 - Remove duplicate checkout from GitHub Actions workflow (#1407)
2626 - Metric `array` aggregator renamed `exact` to match its `aggregation.Kind` (#1412)
2627 - Metric `exact` aggregator includes per-point timestamps (#1412)
2628 - Metric stdout exporter uses MinMaxSumCount aggregator for ValueRecorder instruments (#1412)
2629 - `NewExporter` from `exporters/otlp` now takes a `ProtocolDriver` as a parameter. (#1369)
2630 - Many OTLP Exporter options became gRPC ProtocolDriver options. (#1369)
2631 - Unify endpoint API that related to OTel exporter. (#1401)
2632 - Optimize metric histogram aggregator to reuse its slice of buckets. (#1435)
2633 - Metric aggregator Count() and histogram Bucket.Counts are consistently `uint64`. (1430)
2634 - Histogram aggregator accepts functional options, uses default boundaries if none given. (#1434)
2635 - `SamplingResult` now passed a `Tracestate` from the parent `SpanContext` (#1432)
2636 - Moved gRPC driver for OTLP exporter to `exporters/otlp/otlpgrpc`. (#1420)
2637 - The `TraceContext` propagator now correctly propagates `TraceState` through the `SpanContext`. (#1447)
2638 - Metric Push and Pull Controller components are combined into a single "basic" Controller:
2639 - `WithExporter()` and `Start()` to configure Push behavior
2640 - `Start()` is optional; use `Collect()` and `ForEach()` for Pull behavior
2641 - `Start()` and `Stop()` accept Context. (#1378)
2642 - The `Event` type is moved from the `otel/sdk/export/trace` package to the `otel/trace` API package. (#1452)
2643
2644 ### Removed
2645
2646 - Remove `errUninitializedSpan` as its only usage is now obsolete. (#1360)
2647 - Remove Metric export functionality related to quantiles and summary data points: this is not specified (#1412)
2648 - 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)
2649
2650 ### Fixed
2651
2652 - `BatchSpanProcessor.Shutdown()` will now shutdown underlying `export.SpanExporter`. (#1443)
2653
2654 ## [0.15.0] - 2020-12-10
2655
2656 ### Added
2657
2658 - The `WithIDGenerator` `TracerProviderOption` is added to the `go.opentelemetry.io/otel/trace` package to configure an `IDGenerator` for the `TracerProvider`. (#1363)
2659
2660 ### Changed
2661
2662 - The Zipkin exporter now uses the Span status code to determine. (#1328)
2663 - `NewExporter` and `Start` functions in `go.opentelemetry.io/otel/exporters/otlp` now receive `context.Context` as a first parameter. (#1357)
2664 - Move the OpenCensus example into `example` directory. (#1359)
2665 - Moved the SDK's `internal.IDGenerator` interface in to the `sdk/trace` package to enable support for externally-defined ID generators. (#1363)
2666 - Bump `github.com/google/go-cmp` from 0.5.3 to 0.5.4 (#1374)
2667 - Bump `github.com/golangci/golangci-lint` in `/internal/tools` (#1375)
2668
2669 ### Fixed
2670
2671 - Metric SDK `SumObserver` and `UpDownSumObserver` instruments correctness fixes. (#1381)
2672
2673 ## [0.14.0] - 2020-11-19
2674
2675 ### Added
2676
2677 - An `EventOption` and the related `NewEventConfig` function are added to the `go.opentelemetry.io/otel` package to configure Span events. (#1254)
2678 - A `TextMapPropagator` and associated `TextMapCarrier` are added to the `go.opentelemetry.io/otel/oteltest` package to test `TextMap` type propagators and their use. (#1259)
2679 - `SpanContextFromContext` returns `SpanContext` from context. (#1255)
2680 - `TraceState` has been added to `SpanContext`. (#1340)
2681 - `DeploymentEnvironmentKey` added to `go.opentelemetry.io/otel/semconv` package. (#1323)
2682 - Add an OpenCensus to OpenTelemetry tracing bridge. (#1305)
2683 - Add a parent context argument to `SpanProcessor.OnStart` to follow the specification. (#1333)
2684 - Add missing tests for `sdk/trace/attributes_map.go`. (#1337)
2685
2686 ### Changed
2687
2688 - Move the `go.opentelemetry.io/otel/api/trace` package into `go.opentelemetry.io/otel/trace` with the following changes. (#1229) (#1307)
2689 - `ID` has been renamed to `TraceID`.
2690 - `IDFromHex` has been renamed to `TraceIDFromHex`.
2691 - `EmptySpanContext` is removed.
2692 - Move the `go.opentelemetry.io/otel/api/trace/tracetest` package into `go.opentelemetry.io/otel/oteltest`. (#1229)
2693 - OTLP Exporter updates:
2694 - supports OTLP v0.6.0 (#1230, #1354)
2695 - supports configurable aggregation temporality (default: Cumulative, optional: Stateless). (#1296)
2696 - The Sampler is now called on local child spans. (#1233)
2697 - 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)
2698 - The `MetricKind` method of the `Descriptor` type in the `go.opentelemetry.io/otel/api/metric` package was renamed to `Descriptor.InstrumentKind`.
2699 This matches the returned type and fixes misuse of the term metric. (#1240)
2700 - Move test harness from the `go.opentelemetry.io/otel/api/apitest` package into `go.opentelemetry.io/otel/oteltest`. (#1241)
2701 - Move the `go.opentelemetry.io/otel/api/metric/metrictest` package into `go.opentelemetry.io/oteltest` as part of #964. (#1252)
2702 - Move the `go.opentelemetry.io/otel/api/metric` package into `go.opentelemetry.io/otel/metric` as part of #1303. (#1321)
2703 - Move the `go.opentelemetry.io/otel/api/metric/registry` package into `go.opentelemetry.io/otel/metric/registry` as a part of #1303. (#1316)
2704 - 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)
2705 - 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)
2706 - 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)
2707 - Move the `go.opentelemetry.io/otel/api/global` package to `go.opentelemetry.io/otel`. (#1262) (#1330)
2708 - Move the `Version` function from `go.opentelemetry.io/otel/sdk` to `go.opentelemetry.io/otel`. (#1330)
2709 - Rename correlation context header from `"otcorrelations"` to `"baggage"` to match the OpenTelemetry specification. (#1267)
2710 - Fix `Code.UnmarshalJSON` to work with valid JSON only. (#1276)
2711 - The `resource.New()` method changes signature to support builtin attributes and functional options, including `telemetry.sdk.*` and
2712 `host.name` semantic conventions; the former method is renamed `resource.NewWithAttributes`. (#1235)
2713 - The Prometheus exporter now exports non-monotonic counters (i.e. `UpDownCounter`s) as gauges. (#1210)
2714 - Correct the `Span.End` method documentation in the `otel` API to state updates are not allowed on a span after it has ended. (#1310)
2715 - Updated span collection limits for attribute, event and link counts to 1000 (#1318)
2716 - Renamed `semconv.HTTPUrlKey` to `semconv.HTTPURLKey`. (#1338)
2717
2718 ### Removed
2719
2720 - The `ErrInvalidHexID`, `ErrInvalidTraceIDLength`, `ErrInvalidSpanIDLength`, `ErrInvalidSpanIDLength`, or `ErrNilSpanID` from the `go.opentelemetry.io/otel` package are unexported now. (#1243)
2721 - The `AddEventWithTimestamp` method on the `Span` interface in `go.opentelemetry.io/otel` is removed due to its redundancy.
2722 It is replaced by using the `AddEvent` method with a `WithTimestamp` option. (#1254)
2723 - The `MockSpan` and `MockTracer` types are removed from `go.opentelemetry.io/otel/oteltest`.
2724 `Tracer` and `Span` from the same module should be used in their place instead. (#1306)
2725 - `WorkerCount` option is removed from `go.opentelemetry.io/otel/exporters/otlp`. (#1350)
2726 - Remove the following labels types: INT32, UINT32, UINT64 and FLOAT32. (#1314)
2727
2728 ### Fixed
2729
2730 - Rename `MergeItererator` to `MergeIterator` in the `go.opentelemetry.io/otel/label` package. (#1244)
2731 - The `go.opentelemetry.io/otel/api/global` packages global TextMapPropagator now delegates functionality to a globally set delegate for all previously returned propagators. (#1258)
2732 - Fix condition in `label.Any`. (#1299)
2733 - Fix global `TracerProvider` to pass options to its configured provider. (#1329)
2734 - Fix missing handler for `ExactKind` aggregator in OTLP metrics transformer (#1309)
2735
2736 ## [0.13.0] - 2020-10-08
2737
2738 ### Added
2739
2740 - OTLP Metric exporter supports Histogram aggregation. (#1209)
2741 - 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)
2742 - A Baggage API to implement the OpenTelemetry specification. (#1217)
2743 - Add Shutdown method to sdk/trace/provider, shutdown processors in the order they were registered. (#1227)
2744
2745 ### Changed
2746
2747 - Set default propagator to no-op propagator. (#1184)
2748 - 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)
2749 - The `New` function from the `go.opentelemetry.io/otel/api/propagation` package was replaced with `NewCompositeTextMapPropagator` in the `go.opentelemetry.io/otel` package. (#1212)
2750 - The status codes of the `go.opentelemetry.io/otel/codes` package have been updated to match the latest OpenTelemetry specification.
2751 They now are `Unset`, `Error`, and `Ok`.
2752 They no longer track the gRPC codes. (#1214)
2753 - 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)
2754 - Move the `go.opentelemetry.io/otel/api/baggage` package into `go.opentelemetry.io/otel/baggage`. (#1217) (#1325)
2755 - A `Shutdown` method of `SpanProcessor` and all its implementations receives a context and returns an error. (#1264)
2756
2757 ### Fixed
2758
2759 - 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)
2760
2761 ### Removed
2762
2763 - The `ExtractHTTP` and `InjectHTTP` functions from the `go.opentelemetry.io/otel/api/propagation` package were removed. (#1212)
2764 - The `Propagators` interface from the `go.opentelemetry.io/otel/api/propagation` package was removed to conform to the OpenTelemetry specification.
2765 The explicit `TextMapPropagator` type can be used in its place as this is the `Propagator` type the specification defines. (#1212)
2766 - 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)
2767 - The internal implementation of Baggage storage is removed in favor of using the new Baggage API functionality. (#1217)
2768 - Remove duplicate hostname key `HostHostNameKey` in Resource semantic conventions. (#1219)
2769 - Nested array/slice support has been removed. (#1226)
2770
2771 ## [0.12.0] - 2020-09-24
2772
2773 ### Added
2774
2775 - A `SpanConfigure` function in `go.opentelemetry.io/otel/api/trace` to create a new `SpanConfig` from `SpanOption`s. (#1108)
2776 - In the `go.opentelemetry.io/otel/api/trace` package, `NewTracerConfig` was added to construct new `TracerConfig`s.
2777 This addition was made to conform with our project option conventions. (#1155)
2778 - Instrumentation library information was added to the Zipkin exporter. (#1119)
2779 - The `SpanProcessor` interface now has a `ForceFlush()` method. (#1166)
2780 - More semantic conventions for k8s as resource attributes. (#1167)
2781
2782 ### Changed
2783
2784 - Add reconnecting udp connection type to Jaeger exporter.
2785 This change adds a new optional implementation of the udp conn interface used to detect changes to an agent's host dns record.
2786 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)
2787 - Replace `StartOption` and `EndOption` in `go.opentelemetry.io/otel/api/trace` with `SpanOption`.
2788 This change is matched by replacing the `StartConfig` and `EndConfig` with a unified `SpanConfig`. (#1108)
2789 - Replace the `LinkedTo` span option in `go.opentelemetry.io/otel/api/trace` with `WithLinks`.
2790 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)
2791 - The `go.opentelemetry.io/otel/api/trace` `TracerOption` was changed to an interface to conform to project option conventions. (#1109)
2792 - Move the `B3` and `TraceContext` from within the `go.opentelemetry.io/otel/api/trace` package to their own `go.opentelemetry.io/otel/propagators` package.
2793 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)
2794 - Rename Jaeger tags used for instrumentation library information to reflect changes in OpenTelemetry specification. (#1119)
2795 - Rename `ProbabilitySampler` to `TraceIDRatioBased` and change semantics to ignore parent span sampling status. (#1115)
2796 - Move `tools` package under `internal`. (#1141)
2797 - Move `go.opentelemetry.io/otel/api/correlation` package to `go.opentelemetry.io/otel/api/baggage`. (#1142)
2798 The `correlation.CorrelationContext` propagator has been renamed `baggage.Baggage`. Other exported functions and types are unchanged.
2799 - Rename `ParentOrElse` sampler to `ParentBased` and allow setting samplers depending on parent span. (#1153)
2800 - In the `go.opentelemetry.io/otel/api/trace` package, `SpanConfigure` was renamed to `NewSpanConfig`. (#1155)
2801 - Change `dependabot.yml` to add a `Skip Changelog` label to dependabot-sourced PRs. (#1161)
2802 - The [configuration style guide](https://github.com/open-telemetry/opentelemetry-go/blob/master/CONTRIBUTING.md#config) has been updated to
2803 recommend the use of `newConfig()` instead of `configure()`. (#1163)
2804 - The `otlp.Config` type has been unexported and changed to `otlp.config`, along with its initializer. (#1163)
2805 - Ensure exported interface types include parameter names and update the
2806 Style Guide to reflect this styling rule. (#1172)
2807 - Don't consider unset environment variable for resource detection to be an error. (#1170)
2808 - Rename `go.opentelemetry.io/otel/api/metric.ConfigureInstrument` to `NewInstrumentConfig` and
2809 `go.opentelemetry.io/otel/api/metric.ConfigureMeter` to `NewMeterConfig`.
2810 - ValueObserver instruments use LastValue aggregator by default. (#1165)
2811 - OTLP Metric exporter supports LastValue aggregation. (#1165)
2812 - Move the `go.opentelemetry.io/otel/api/unit` package to `go.opentelemetry.io/otel/unit`. (#1185)
2813 - Rename `Provider` to `MeterProvider` in the `go.opentelemetry.io/otel/api/metric` package. (#1190)
2814 - Rename `NoopProvider` to `NoopMeterProvider` in the `go.opentelemetry.io/otel/api/metric` package. (#1190)
2815 - Rename `NewProvider` to `NewMeterProvider` in the `go.opentelemetry.io/otel/api/metric/metrictest` package. (#1190)
2816 - Rename `Provider` to `MeterProvider` in the `go.opentelemetry.io/otel/api/metric/registry` package. (#1190)
2817 - Rename `NewProvider` to `NewMeterProvider` in the `go.opentelemetry.io/otel/api/metri/registryc` package. (#1190)
2818 - Rename `Provider` to `TracerProvider` in the `go.opentelemetry.io/otel/api/trace` package. (#1190)
2819 - Rename `NoopProvider` to `NoopTracerProvider` in the `go.opentelemetry.io/otel/api/trace` package. (#1190)
2820 - Rename `Provider` to `TracerProvider` in the `go.opentelemetry.io/otel/api/trace/tracetest` package. (#1190)
2821 - Rename `NewProvider` to `NewTracerProvider` in the `go.opentelemetry.io/otel/api/trace/tracetest` package. (#1190)
2822 - Rename `WrapperProvider` to `WrapperTracerProvider` in the `go.opentelemetry.io/otel/bridge/opentracing` package. (#1190)
2823 - Rename `NewWrapperProvider` to `NewWrapperTracerProvider` in the `go.opentelemetry.io/otel/bridge/opentracing` package. (#1190)
2824 - Rename `Provider` method of the pull controller to `MeterProvider` in the `go.opentelemetry.io/otel/sdk/metric/controller/pull` package. (#1190)
2825 - Rename `Provider` method of the push controller to `MeterProvider` in the `go.opentelemetry.io/otel/sdk/metric/controller/push` package. (#1190)
2826 - Rename `ProviderOptions` to `TracerProviderConfig` in the `go.opentelemetry.io/otel/sdk/trace` package. (#1190)
2827 - Rename `ProviderOption` to `TracerProviderOption` in the `go.opentelemetry.io/otel/sdk/trace` package. (#1190)
2828 - Rename `Provider` to `TracerProvider` in the `go.opentelemetry.io/otel/sdk/trace` package. (#1190)
2829 - Rename `NewProvider` to `NewTracerProvider` in the `go.opentelemetry.io/otel/sdk/trace` package. (#1190)
2830 - Renamed `SamplingDecision` values to comply with OpenTelemetry specification change. (#1192)
2831 - Renamed Zipkin attribute names from `ot.status_code & ot.status_description` to `otel.status_code & otel.status_description`. (#1201)
2832 - The default SDK now invokes registered `SpanProcessor`s in the order they were registered with the `TracerProvider`. (#1195)
2833 - Add test of spans being processed by the `SpanProcessor`s in the order they were registered. (#1203)
2834
2835 ### Removed
2836
2837 - Remove the B3 propagator from `go.opentelemetry.io/otel/propagators`. It is now located in the
2838 `go.opentelemetry.io/contrib/propagators/` module. (#1191)
2839 - Remove the semantic convention for HTTP status text, `HTTPStatusTextKey` from package `go.opentelemetry.io/otel/semconv`. (#1194)
2840
2841 ### Fixed
2842
2843 - Zipkin example no longer mentions `ParentSampler`, corrected to `ParentBased`. (#1171)
2844 - Fix missing shutdown processor in otel-collector example. (#1186)
2845 - Fix missing shutdown processor in basic and namedtracer examples. (#1197)
2846
2847 ## [0.11.0] - 2020-08-24
2848
2849 ### Added
2850
2851 - Support for exporting array-valued attributes via OTLP. (#992)
2852 - `Noop` and `InMemory` `SpanBatcher` implementations to help with testing integrations. (#994)
2853 - Support for filtering metric label sets. (#1047)
2854 - A dimensionality-reducing metric Processor. (#1057)
2855 - Integration tests for more OTel Collector Attribute types. (#1062)
2856 - 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)
2857
2858 ### Changed
2859
2860 - Rename `sdk/metric/processor/test` to `sdk/metric/processor/processortest`. (#1049)
2861 - Rename `sdk/metric/controller/test` to `sdk/metric/controller/controllertest`. (#1049)
2862 - Rename `api/testharness` to `api/apitest`. (#1049)
2863 - Rename `api/trace/testtrace` to `api/trace/tracetest`. (#1049)
2864 - Change Metric Processor to merge multiple observations. (#1024)
2865 - The `go.opentelemetry.io/otel/bridge/opentracing` bridge package has been made into its own module.
2866 This removes the package dependencies of this bridge from the rest of the OpenTelemetry based project. (#1038)
2867 - 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)
2868 - The environment variable used for resource detection has been changed from `OTEL_RESOURCE_LABELS` to `OTEL_RESOURCE_ATTRIBUTES` (#1042)
2869 - Replace `WithSyncer` with `WithBatcher` in examples. (#1044)
2870 - Replace the `google.golang.org/grpc/codes` dependency in the API with an equivalent `go.opentelemetry.io/otel/codes` package. (#1046)
2871 - 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)
2872 - Unify Callback Function Naming.
2873 Rename `*Callback` with `*Func`. (#1061)
2874 - CI builds validate against last two versions of Go, dropping 1.13 and adding 1.15. (#1064)
2875 - The `go.opentelemetry.io/otel/sdk/export/trace` interfaces `SpanSyncer` and `SpanBatcher` have been replaced with a specification compliant `Exporter` interface.
2876 This interface still supports the export of `SpanData`, but only as a slice.
2877 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)
2878 - The `go.opentelemetry.io/otel/sdk/trace` `NewBatchSpanProcessor` function no longer returns an error.
2879 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)
2880 - The `go.opentelemetry.io/otel/sdk/trace` `NewProvider` function to create a `Provider` no longer returns an error, instead only a `*Provider`.
2881 This change is related to `NewBatchSpanProcessor` not returning an error which was the only error this function would return. (#1078)
2882
2883 ### Removed
2884
2885 - Duplicate, unused API sampler interface. (#999)
2886 Use the [`Sampler` interface](https://github.com/open-telemetry/opentelemetry-go/blob/v0.11.0/sdk/trace/sampling.go) provided by the SDK instead.
2887 - The `grpctrace` instrumentation was moved to the `go.opentelemetry.io/contrib` repository and out of this repository.
2888 This move includes moving the `grpc` example to the `go.opentelemetry.io/contrib` as well. (#1027)
2889 - The `WithSpan` method of the `Tracer` interface.
2890 The functionality this method provided was limited compared to what a user can provide themselves.
2891 It was removed with the understanding that if there is sufficient user need it can be added back based on actual user usage. (#1043)
2892 - The `RegisterSpanProcessor` and `UnregisterSpanProcessor` functions.
2893 These were holdovers from an approach prior to the TracerProvider design. They were not used anymore. (#1077)
2894 - The `oterror` package. (#1026)
2895 - The `othttp` and `httptrace` instrumentations were moved to `go.opentelemetry.io/contrib`. (#1032)
2896
2897 ### Fixed
2898
2899 - The `semconv.HTTPServerMetricAttributesFromHTTPRequest()` function no longer generates the high-cardinality `http.request.content.length` label. (#1031)
2900 - Correct instrumentation version tag in Jaeger exporter. (#1037)
2901 - The SDK span will now set an error event if the `End` method is called during a panic (i.e. it was deferred). (#1043)
2902 - Move internally generated protobuf code from the `go.opentelemetry.io/otel` to the OTLP exporter to reduce dependency overhead. (#1050)
2903 - The `otel-collector` example referenced outdated collector processors. (#1006)
2904
2905 ## [0.10.0] - 2020-07-29
2906
2907 This release migrates the default OpenTelemetry SDK into its own Go module, decoupling the SDK from the API and reducing dependencies for instrumentation packages.
2908
2909 ### Added
2910
2911 - The Zipkin exporter now has `NewExportPipeline` and `InstallNewPipeline` constructor functions to match the common pattern.
2912 These function build a new exporter with default SDK options and register the exporter with the `global` package respectively. (#944)
2913 - Add propagator option for gRPC instrumentation. (#986)
2914 - The `testtrace` package now tracks the `trace.SpanKind` for each span. (#987)
2915
2916 ### Changed
2917
2918 - Replace the `RegisterGlobal` `Option` in the Jaeger exporter with an `InstallNewPipeline` constructor function.
2919 This matches the other exporter constructor patterns and will register a new exporter after building it with default configuration. (#944)
2920 - 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`.
2921 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)
2922 - Move the `go.opentelemetry.io/otel/exporters/test` test package to `go.opentelemetry.io/otel/sdk/export/metric/metrictest`. (#962)
2923 - The `go.opentelemetry.io/otel/api/kv/value` package was merged into the parent `go.opentelemetry.io/otel/api/kv` package. (#968)
2924 - `value.Bool` was replaced with `kv.BoolValue`.
2925 - `value.Int64` was replaced with `kv.Int64Value`.
2926 - `value.Uint64` was replaced with `kv.Uint64Value`.
2927 - `value.Float64` was replaced with `kv.Float64Value`.
2928 - `value.Int32` was replaced with `kv.Int32Value`.
2929 - `value.Uint32` was replaced with `kv.Uint32Value`.
2930 - `value.Float32` was replaced with `kv.Float32Value`.
2931 - `value.String` was replaced with `kv.StringValue`.
2932 - `value.Int` was replaced with `kv.IntValue`.
2933 - `value.Uint` was replaced with `kv.UintValue`.
2934 - `value.Array` was replaced with `kv.ArrayValue`.
2935 - Rename `Infer` to `Any` in the `go.opentelemetry.io/otel/api/kv` package. (#972)
2936 - 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)
2937 - Rename `go.opentelemetry.io/otel/sdk/metric/aggregator/test` package to `go.opentelemetry.io/otel/sdk/metric/aggregator/aggregatortest`. (#980)
2938 - Make the SDK into its own Go module called `go.opentelemetry.io/otel/sdk`. (#985)
2939 - Changed the default trace `Sampler` from `AlwaysOn` to `ParentOrElse(AlwaysOn)`. (#989)
2940
2941 ### Removed
2942
2943 - The `IndexedAttribute` function from the `go.opentelemetry.io/otel/api/label` package was removed in favor of `IndexedLabel` which it was synonymous with. (#970)
2944
2945 ### Fixed
2946
2947 - Bump github.com/golangci/golangci-lint from 1.28.3 to 1.29.0 in /tools. (#953)
2948 - Bump github.com/google/go-cmp from 0.5.0 to 0.5.1. (#957)
2949 - Use `global.Handle` for span export errors in the OTLP exporter. (#946)
2950 - Correct Go language formatting in the README documentation. (#961)
2951 - Remove default SDK dependencies from the `go.opentelemetry.io/otel/api` package. (#977)
2952 - Remove default SDK dependencies from the `go.opentelemetry.io/otel/instrumentation` package. (#983)
2953 - Move documented examples for `go.opentelemetry.io/otel/instrumentation/grpctrace` interceptors into Go example tests. (#984)
2954
2955 ## [0.9.0] - 2020-07-20
2956
2957 ### Added
2958
2959 - A new Resource Detector interface is included to allow resources to be automatically detected and included. (#939)
2960 - A Detector to automatically detect resources from an environment variable. (#939)
2961 - Github action to generate protobuf Go bindings locally in `internal/opentelemetry-proto-gen`. (#938)
2962 - OTLP .proto files from `open-telemetry/opentelemetry-proto` imported as a git submodule under `internal/opentelemetry-proto`.
2963 References to `github.com/open-telemetry/opentelemetry-proto` changed to `go.opentelemetry.io/otel/internal/opentelemetry-proto-gen`. (#942)
2964
2965 ### Changed
2966
2967 - Non-nil value `struct`s for key-value pairs will be marshalled using JSON rather than `Sprintf`. (#948)
2968
2969 ### Removed
2970
2971 - Removed dependency on `github.com/open-telemetry/opentelemetry-collector`. (#943)
2972
2973 ## [0.8.0] - 2020-07-09
2974
2975 ### Added
2976
2977 - The `B3Encoding` type to represent the B3 encoding(s) the B3 propagator can inject.
2978 A value for HTTP supported encodings (Multiple Header: `MultipleHeader`, Single Header: `SingleHeader`) are included. (#882)
2979 - The `FlagsDeferred` trace flag to indicate if the trace sampling decision has been deferred. (#882)
2980 - The `FlagsDebug` trace flag to indicate if the trace is a debug trace. (#882)
2981 - Add `peer.service` semantic attribute. (#898)
2982 - Add database-specific semantic attributes. (#899)
2983 - Add semantic convention for `faas.coldstart` and `container.id`. (#909)
2984 - Add http content size semantic conventions. (#905)
2985 - Include `http.request_content_length` in HTTP request basic attributes. (#905)
2986 - Add semantic conventions for operating system process resource attribute keys. (#919)
2987 - The Jaeger exporter now has a `WithBatchMaxCount` option to specify the maximum number of spans sent in a batch. (#931)
2988
2989 ### Changed
2990
2991 - Update `CONTRIBUTING.md` to ask for updates to `CHANGELOG.md` with each pull request. (#879)
2992 - Use lowercase header names for B3 Multiple Headers. (#881)
2993 - The B3 propagator `SingleHeader` field has been replaced with `InjectEncoding`.
2994 This new field can be set to combinations of the `B3Encoding` bitmasks and will inject trace information in these encodings.
2995 If no encoding is set, the propagator will default to `MultipleHeader` encoding. (#882)
2996 - The B3 propagator now extracts from either HTTP encoding of B3 (Single Header or Multiple Header) based on what is contained in the header.
2997 Preference is given to Single Header encoding with Multiple Header being the fallback if Single Header is not found or is invalid.
2998 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)
2999 - Extend semantic conventions for RPC. (#900)
3000 - To match constant naming conventions in the `api/standard` package, the `FaaS*` key names are appended with a suffix of `Key`. (#920)
3001 - `"api/standard".FaaSName` -> `FaaSNameKey`
3002 - `"api/standard".FaaSID` -> `FaaSIDKey`
3003 - `"api/standard".FaaSVersion` -> `FaaSVersionKey`
3004 - `"api/standard".FaaSInstance` -> `FaaSInstanceKey`
3005
3006 ### Removed
3007
3008 - The `FlagsUnused` trace flag is removed.
3009 The purpose of this flag was to act as the inverse of `FlagsSampled`, the inverse of `FlagsSampled` is used instead. (#882)
3010 - The B3 header constants (`B3SingleHeader`, `B3DebugFlagHeader`, `B3TraceIDHeader`, `B3SpanIDHeader`, `B3SampledHeader`, `B3ParentSpanIDHeader`) are removed.
3011 If B3 header keys are needed [the authoritative OpenZipkin package constants](https://pkg.go.dev/github.com/openzipkin/[email protected]/propagation/b3?tab=doc#pkg-constants) should be used instead. (#882)
3012
3013 ### Fixed
3014
3015 - The B3 Single Header name is now correctly `b3` instead of the previous `X-B3`. (#881)
3016 - The B3 propagator now correctly supports sampling only values (`b3: 0`, `b3: 1`, or `b3: d`) for a Single B3 Header. (#882)
3017 - The B3 propagator now propagates the debug flag.
3018 This removes the behavior of changing the debug flag into a set sampling bit.
3019 Instead, this now follow the B3 specification and omits the `X-B3-Sampling` header. (#882)
3020 - The B3 propagator now tracks "unset" sampling state (meaning "defer the decision") and does not set the `X-B3-Sampling` header when injecting. (#882)
3021 - Bump github.com/itchyny/gojq from 0.10.3 to 0.10.4 in /tools. (#883)
3022 - Bump github.com/opentracing/opentracing-go from v1.1.1-0.20190913142402-a7454ce5950e to v1.2.0. (#885)
3023 - The tracing time conversion for OTLP spans is now correctly set to `UnixNano`. (#896)
3024 - Ensure span status is not set to `Unknown` when no HTTP status code is provided as it is assumed to be `200 OK`. (#908)
3025 - Ensure `httptrace.clientTracer` closes `http.headers` span. (#912)
3026 - Prometheus exporter will not apply stale updates or forget inactive metrics. (#903)
3027 - Add test for api.standard `HTTPClientAttributesFromHTTPRequest`. (#905)
3028 - Bump github.com/golangci/golangci-lint from 1.27.0 to 1.28.1 in /tools. (#901, #913)
3029 - Update otel-collector example to use the v0.5.0 collector. (#915)
3030 - The `grpctrace` instrumentation uses a span name conforming to the OpenTelemetry semantic conventions (does not contain a leading slash (`/`)). (#922)
3031 - The `grpctrace` instrumentation includes an `rpc.method` attribute now set to the gRPC method name. (#900, #922)
3032 - The `grpctrace` instrumentation `rpc.service` attribute now contains the package name if one exists.
3033 This is in accordance with OpenTelemetry semantic conventions. (#922)
3034 - Correlation Context extractor will no longer insert an empty map into the returned context when no valid values are extracted. (#923)
3035 - Bump google.golang.org/api from 0.28.0 to 0.29.0 in /exporters/trace/jaeger. (#925)
3036 - Bump github.com/itchyny/gojq from 0.10.4 to 0.11.0 in /tools. (#926)
3037 - Bump github.com/golangci/golangci-lint from 1.28.1 to 1.28.2 in /tools. (#930)
3038
3039 ## [0.7.0] - 2020-06-26
3040
3041 This release implements the v0.5.0 version of the OpenTelemetry specification.
3042
3043 ### Added
3044
3045 - The othttp instrumentation now includes default metrics. (#861)
3046 - This CHANGELOG file to track all changes in the project going forward.
3047 - Support for array type attributes. (#798)
3048 - Apply transitive dependabot go.mod dependency updates as part of a new automatic Github workflow. (#844)
3049 - Timestamps are now passed to exporters for each export. (#835)
3050 - Add new `Accumulation` type to metric SDK to transport telemetry from `Accumulator`s to `Processor`s.
3051 This replaces the prior `Record` `struct` use for this purpose. (#835)
3052 - New dependabot integration to automate package upgrades. (#814)
3053 - `Meter` and `Tracer` implementations accept instrumentation version version as an optional argument.
3054 This instrumentation version is passed on to exporters. (#811) (#805) (#802)
3055 - The OTLP exporter includes the instrumentation version in telemetry it exports. (#811)
3056 - Environment variables for Jaeger exporter are supported. (#796)
3057 - New `aggregation.Kind` in the export metric API. (#808)
3058 - New example that uses OTLP and the collector. (#790)
3059 - Handle errors in the span `SetName` during span initialization. (#791)
3060 - Default service config to enable retries for retry-able failed requests in the OTLP exporter and an option to override this default. (#777)
3061 - New `go.opentelemetry.io/otel/api/oterror` package to uniformly support error handling and definitions for the project. (#778)
3062 - 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`.
3063 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)
3064 - Options to specify propagators for httptrace and grpctrace instrumentation. (#784)
3065 - The required `application/json` header for the Zipkin exporter is included in all exports. (#774)
3066 - Integrate HTTP semantics helpers from the contrib repository into the `api/standard` package. #769
3067
3068 ### Changed
3069
3070 - Rename `Integrator` to `Processor` in the metric SDK. (#863)
3071 - Rename `AggregationSelector` to `AggregatorSelector`. (#859)
3072 - Rename `SynchronizedCopy` to `SynchronizedMove`. (#858)
3073 - Rename `simple` integrator to `basic` integrator. (#857)
3074 - Merge otlp collector examples. (#841)
3075 - Change the metric SDK to support cumulative, delta, and pass-through exporters directly.
3076 With these changes, cumulative and delta specific exporters are able to request the correct kind of aggregation from the SDK. (#840)
3077 - The `Aggregator.Checkpoint` API is renamed to `SynchronizedCopy` and adds an argument, a different `Aggregator` into which the copy is stored. (#812)
3078 - The `export.Aggregator` contract is that `Update()` and `SynchronizedCopy()` are synchronized with each other.
3079 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`.
3080 Some of the `Aggregators` used unnecessary locking and that has been cleaned up. (#812)
3081 - Use of `metric.Number` was replaced by `int64` now that we use `sync.Mutex` in the `MinMaxSumCount` and `Histogram` `Aggregators`. (#812)
3082 - Replace `AlwaysParentSample` with `ParentSample(fallback)` to match the OpenTelemetry v0.5.0 specification. (#810)
3083 - Rename `sdk/export/metric/aggregator` to `sdk/export/metric/aggregation`. #808
3084 - Send configured headers with every request in the OTLP exporter, instead of just on connection creation. (#806)
3085 - Update error handling for any one off error handlers, replacing, instead, with the `global.Handle` function. (#791)
3086 - Rename `plugin` directory to `instrumentation` to match the OpenTelemetry specification. (#779)
3087 - Makes the argument order to Histogram and DDSketch `New()` consistent. (#781)
3088
3089 ### Removed
3090
3091 - `Uint64NumberKind` and related functions from the API. (#864)
3092 - Context arguments from `Aggregator.Checkpoint` and `Integrator.Process` as they were unused. (#803)
3093 - `SpanID` is no longer included in parameters for sampling decision to match the OpenTelemetry specification. (#775)
3094
3095 ### Fixed
3096
3097 - Upgrade OTLP exporter to opentelemetry-proto matching the opentelemetry-collector v0.4.0 release. (#866)
3098 - Allow changes to `go.sum` and `go.mod` when running dependabot tidy-up. (#871)
3099 - Bump github.com/stretchr/testify from 1.4.0 to 1.6.1. (#824)
3100 - Bump github.com/prometheus/client_golang from 1.7.0 to 1.7.1 in /exporters/metric/prometheus. (#867)
3101 - Bump google.golang.org/grpc from 1.29.1 to 1.30.0 in /exporters/trace/jaeger. (#853)
3102 - Bump google.golang.org/grpc from 1.29.1 to 1.30.0 in /exporters/trace/zipkin. (#854)
3103 - Bumps github.com/golang/protobuf from 1.3.2 to 1.4.2 (#848)
3104 - Bump github.com/stretchr/testify from 1.4.0 to 1.6.1 in /exporters/otlp (#817)
3105 - Bump github.com/golangci/golangci-lint from 1.25.1 to 1.27.0 in /tools (#828)
3106 - Bump github.com/prometheus/client_golang from 1.5.0 to 1.7.0 in /exporters/metric/prometheus (#838)
3107 - Bump github.com/stretchr/testify from 1.4.0 to 1.6.1 in /exporters/trace/jaeger (#829)
3108 - Bump github.com/benbjohnson/clock from 1.0.0 to 1.0.3 (#815)
3109 - Bump github.com/stretchr/testify from 1.4.0 to 1.6.1 in /exporters/trace/zipkin (#823)
3110 - Bump github.com/itchyny/gojq from 0.10.1 to 0.10.3 in /tools (#830)
3111 - Bump github.com/stretchr/testify from 1.4.0 to 1.6.1 in /exporters/metric/prometheus (#822)
3112 - Bump google.golang.org/grpc from 1.27.1 to 1.29.1 in /exporters/trace/zipkin (#820)
3113 - Bump google.golang.org/grpc from 1.27.1 to 1.29.1 in /exporters/trace/jaeger (#831)
3114 - Bump github.com/google/go-cmp from 0.4.0 to 0.5.0 (#836)
3115 - Bump github.com/google/go-cmp from 0.4.0 to 0.5.0 in /exporters/trace/jaeger (#837)
3116 - Bump github.com/google/go-cmp from 0.4.0 to 0.5.0 in /exporters/otlp (#839)
3117 - Bump google.golang.org/api from 0.20.0 to 0.28.0 in /exporters/trace/jaeger (#843)
3118 - Set span status from HTTP status code in the othttp instrumentation. (#832)
3119 - Fixed typo in push controller comment. (#834)
3120 - The `Aggregator` testing has been updated and cleaned. (#812)
3121 - `metric.Number(0)` expressions are replaced by `0` where possible. (#812)
3122 - Fixed `global` `handler_test.go` test failure. #804
3123 - Fixed `BatchSpanProcessor.Shutdown` to wait until all spans are processed. (#766)
3124 - Fixed OTLP example's accidental early close of exporter. (#807)
3125 - Ensure zipkin exporter reads and closes response body. (#788)
3126 - Update instrumentation to use `api/standard` keys instead of custom keys. (#782)
3127 - Clean up tools and RELEASING documentation. (#762)
3128
3129 ## [0.6.0] - 2020-05-21
3130
3131 ### Added
3132
3133 - Support for `Resource`s in the prometheus exporter. (#757)
3134 - New pull controller. (#751)
3135 - New `UpDownSumObserver` instrument. (#750)
3136 - OpenTelemetry collector demo. (#711)
3137 - New `SumObserver` instrument. (#747)
3138 - New `UpDownCounter` instrument. (#745)
3139 - New timeout `Option` and configuration function `WithTimeout` to the push controller. (#742)
3140 - New `api/standards` package to implement semantic conventions and standard key-value generation. (#731)
3141
3142 ### Changed
3143
3144 - Rename `Register*` functions in the metric API to `New*` for all `Observer` instruments. (#761)
3145 - Use `[]float64` for histogram boundaries, not `[]metric.Number`. (#758)
3146 - Change OTLP example to use exporter as a trace `Syncer` instead of as an unneeded `Batcher`. (#756)
3147 - Replace `WithResourceAttributes()` with `WithResource()` in the trace SDK. (#754)
3148 - The prometheus exporter now uses the new pull controller. (#751)
3149 - Rename `ScheduleDelayMillis` to `BatchTimeout` in the trace `BatchSpanProcessor`.(#752)
3150 - Support use of synchronous instruments in asynchronous callbacks (#725)
3151 - Move `Resource` from the `Export` method parameter into the metric export `Record`. (#739)
3152 - Rename `Observer` instrument to `ValueObserver`. (#734)
3153 - 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)
3154 - Replace `Measure` instrument by `ValueRecorder` instrument. (#732)
3155 - Rename correlation context header from `"Correlation-Context"` to `"otcorrelations"` to match the OpenTelemetry specification. (#727)
3156
3157 ### Fixed
3158
3159 - Ensure gRPC `ClientStream` override methods do not panic in grpctrace package. (#755)
3160 - Disable parts of `BatchSpanProcessor` test until a fix is found. (#743)
3161 - Fix `string` case in `kv` `Infer` function. (#746)
3162 - Fix panic in grpctrace client interceptors. (#740)
3163 - Refactor the `api/metrics` push controller and add `CheckpointSet` synchronization. (#737)
3164 - Rewrite span batch process queue batching logic. (#719)
3165 - Remove the push controller named Meter map. (#738)
3166 - Fix Histogram aggregator initial state (fix #735). (#736)
3167 - Ensure golang alpine image is running `golang-1.14` for examples. (#733)
3168 - Added test for grpctrace `UnaryInterceptorClient`. (#695)
3169 - Rearrange `api/metric` code layout. (#724)
3170
3171 ## [0.5.0] - 2020-05-13
3172
3173 ### Added
3174
3175 - Batch `Observer` callback support. (#717)
3176 - Alias `api` types to root package of project. (#696)
3177 - Create basic `othttp.Transport` for simple client instrumentation. (#678)
3178 - `SetAttribute(string, interface{})` to the trace API. (#674)
3179 - Jaeger exporter option that allows user to specify custom http client. (#671)
3180 - `Stringer` and `Infer` methods to `key`s. (#662)
3181
3182 ### Changed
3183
3184 - Rename `NewKey` in the `kv` package to just `Key`. (#721)
3185 - Move `core` and `key` to `kv` package. (#720)
3186 - Make the metric API `Meter` a `struct` so the abstract `MeterImpl` can be passed and simplify implementation. (#709)
3187 - Rename SDK `Batcher` to `Integrator` to match draft OpenTelemetry SDK specification. (#710)
3188 - Rename SDK `Ungrouped` integrator to `simple.Integrator` to match draft OpenTelemetry SDK specification. (#710)
3189 - Rename SDK `SDK` `struct` to `Accumulator` to match draft OpenTelemetry SDK specification. (#710)
3190 - Move `Number` from `core` to `api/metric` package. (#706)
3191 - Move `SpanContext` from `core` to `trace` package. (#692)
3192 - Change traceparent header from `Traceparent` to `traceparent` to implement the W3C specification. (#681)
3193
3194 ### Fixed
3195
3196 - Update tooling to run generators in all submodules. (#705)
3197 - gRPC interceptor regexp to match methods without a service name. (#683)
3198 - Use a `const` for padding 64-bit B3 trace IDs. (#701)
3199 - Update `mockZipkin` listen address from `:0` to `127.0.0.1:0`. (#700)
3200 - Left-pad 64-bit B3 trace IDs with zero. (#698)
3201 - Propagate at least the first W3C tracestate header. (#694)
3202 - Remove internal `StateLocker` implementation. (#688)
3203 - Increase instance size CI system uses. (#690)
3204 - Add a `key` benchmark and use reflection in `key.Infer()`. (#679)
3205 - Fix internal `global` test by using `global.Meter` with `RecordBatch()`. (#680)
3206 - Reimplement histogram using mutex instead of `StateLocker`. (#669)
3207 - Switch `MinMaxSumCount` to a mutex lock implementation instead of `StateLocker`. (#667)
3208 - Update documentation to not include any references to `WithKeys`. (#672)
3209 - Correct misspelling. (#668)
3210 - Fix clobbering of the span context if extraction fails. (#656)
3211 - Bump `golangci-lint` and work around the corrupting bug. (#666) (#670)
3212
3213 ## [0.4.3] - 2020-04-24
3214
3215 ### Added
3216
3217 - `Dockerfile` and `docker-compose.yml` to run example code. (#635)
3218 - New `grpctrace` package that provides gRPC client and server interceptors for both unary and stream connections. (#621)
3219 - New `api/label` package, providing common label set implementation. (#651)
3220 - Support for JSON marshaling of `Resources`. (#654)
3221 - `TraceID` and `SpanID` implementations for `Stringer` interface. (#642)
3222 - `RemoteAddrKey` in the othttp plugin to include the HTTP client address in top-level spans. (#627)
3223 - `WithSpanFormatter` option to the othttp plugin. (#617)
3224 - Updated README to include section for compatible libraries and include reference to the contrib repository. (#612)
3225 - The prometheus exporter now supports exporting histograms. (#601)
3226 - A `String` method to the `Resource` to return a hashable identifier for a now unique resource. (#613)
3227 - An `Iter` method to the `Resource` to return an array `AttributeIterator`. (#613)
3228 - An `Equal` method to the `Resource` test the equivalence of resources. (#613)
3229 - An iterable structure (`AttributeIterator`) for `Resource` attributes.
3230
3231 ### Changed
3232
3233 - zipkin export's `NewExporter` now requires a `serviceName` argument to ensure this needed values is provided. (#644)
3234 - Pass `Resources` through the metrics export pipeline. (#659)
3235
3236 ### Removed
3237
3238 - `WithKeys` option from the metric API. (#639)
3239
3240 ### Fixed
3241
3242 - Use the `label.Set.Equivalent` value instead of an encoding in the batcher. (#658)
3243 - Correct typo `trace.Exporter` to `trace.SpanSyncer` in comments. (#653)
3244 - Use type names for return values in jaeger exporter. (#648)
3245 - Increase the visibility of the `api/key` package by updating comments and fixing usages locally. (#650)
3246 - `Checkpoint` only after `Update`; Keep records in the `sync.Map` longer. (#647)
3247 - Do not cache `reflect.ValueOf()` in metric Labels. (#649)
3248 - Batch metrics exported from the OTLP exporter based on `Resource` and labels. (#626)
3249 - Add error wrapping to the prometheus exporter. (#631)
3250 - Update the OTLP exporter batching of traces to use a unique `string` representation of an associated `Resource` as the batching key. (#623)
3251 - Update OTLP `SpanData` transform to only include the `ParentSpanID` if one exists. (#614)
3252 - Update `Resource` internal representation to uniquely and reliably identify resources. (#613)
3253 - Check return value from `CheckpointSet.ForEach` in prometheus exporter. (#622)
3254 - Ensure spans created by httptrace client tracer reflect operation structure. (#618)
3255 - Create a new recorder rather than reuse when multiple observations in same epoch for asynchronous instruments. #610
3256 - 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)
3257
3258 ## [0.4.2] - 2020-03-31
3259
3260 ### Fixed
3261
3262 - Fix `pre_release.sh` to update version in `sdk/opentelemetry.go`. (#607)
3263 - Fix time conversion from internal to OTLP in OTLP exporter. (#606)
3264
3265 ## [0.4.1] - 2020-03-31
3266
3267 ### Fixed
3268
3269 - Update `tag.sh` to create signed tags. (#604)
3270
3271 ## [0.4.0] - 2020-03-30
3272
3273 ### Added
3274
3275 - New API package `api/metric/registry` that exposes a `MeterImpl` wrapper for use by SDKs to generate unique instruments. (#580)
3276 - Script to verify examples after a new release. (#579)
3277
3278 ### Removed
3279
3280 - The dogstatsd exporter due to lack of support.
3281 This additionally removes support for statsd. (#591)
3282 - `LabelSet` from the metric API.
3283 This is replaced by a `[]core.KeyValue` slice. (#595)
3284 - `Labels` from the metric API's `Meter` interface. (#595)
3285
3286 ### Changed
3287
3288 - 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)
3289 - Renamed `internal/metric.Meter` to `MeterImpl`. (#580)
3290 - Renamed `api/global/internal.obsImpl` to `asyncImpl`. (#580)
3291
3292 ### Fixed
3293
3294 - Corrected missing return in mock span. (#582)
3295 - Update License header for all source files to match CNCF guidelines and include a test to ensure it is present. (#586) (#596)
3296 - Update to v0.3.0 of the OTLP in the OTLP exporter. (#588)
3297 - Update pre-release script to be compatible between GNU and BSD based systems. (#592)
3298 - Add a `RecordBatch` benchmark. (#594)
3299 - Moved span transforms of the OTLP exporter to the internal package. (#593)
3300 - Build both go-1.13 and go-1.14 in circleci to test for all supported versions of Go. (#569)
3301 - Removed unneeded allocation on empty labels in OLTP exporter. (#597)
3302 - Update `BatchedSpanProcessor` to process the queue until no data but respect max batch size. (#599)
3303 - Update project documentation godoc.org links to pkg.go.dev. (#602)
3304
3305 ## [0.3.0] - 2020-03-21
3306
3307 This is a first official beta release, which provides almost fully complete metrics, tracing, and context propagation functionality.
3308 There is still a possibility of breaking changes.
3309
3310 ### Added
3311
3312 - Add `Observer` metric instrument. (#474)
3313 - Add global `Propagators` functionality to enable deferred initialization for propagators registered before the first Meter SDK is installed. (#494)
3314 - Simplified export setup pipeline for the jaeger exporter to match other exporters. (#459)
3315 - The zipkin trace exporter. (#495)
3316 - The OTLP exporter to export metric and trace telemetry to the OpenTelemetry collector. (#497) (#544) (#545)
3317 - Add `StatusMessage` field to the trace `Span`. (#524)
3318 - Context propagation in OpenTracing bridge in terms of OpenTelemetry context propagation. (#525)
3319 - The `Resource` type was added to the SDK. (#528)
3320 - The global API now supports a `Tracer` and `Meter` function as shortcuts to getting a global `*Provider` and calling these methods directly. (#538)
3321 - The metric API now defines a generic `MeterImpl` interface to support general purpose `Meter` construction.
3322 Additionally, `SyncImpl` and `AsyncImpl` are added to support general purpose instrument construction. (#560)
3323 - A metric `Kind` is added to represent the `MeasureKind`, `ObserverKind`, and `CounterKind`. (#560)
3324 - Scripts to better automate the release process. (#576)
3325
3326 ### Changed
3327
3328 - Default to to use `AlwaysSampler` instead of `ProbabilitySampler` to match OpenTelemetry specification. (#506)
3329 - Renamed `AlwaysSampleSampler` to `AlwaysOnSampler` in the trace API. (#511)
3330 - Renamed `NeverSampleSampler` to `AlwaysOffSampler` in the trace API. (#511)
3331 - The `Status` field of the `Span` was changed to `StatusCode` to disambiguate with the added `StatusMessage`. (#524)
3332 - Updated the trace `Sampler` interface conform to the OpenTelemetry specification. (#531)
3333 - Rename metric API `Options` to `Config`. (#541)
3334 - Rename metric `Counter` aggregator to be `Sum`. (#541)
3335 - Unify metric options into `Option` from instrument specific options. (#541)
3336 - The trace API's `TraceProvider` now support `Resource`s. (#545)
3337 - Correct error in zipkin module name. (#548)
3338 - The jaeger trace exporter now supports `Resource`s. (#551)
3339 - Metric SDK now supports `Resource`s.
3340 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)
3341 - Replace `ErrNoLastValue` and `ErrEmptyDataSet` by `ErrNoData` in the metric SDK. (#557)
3342 - The stdout trace exporter now supports `Resource`s. (#558)
3343 - The metric `Descriptor` is now included at the API instead of the SDK. (#560)
3344 - Replace `Ordered` with an iterator in `export.Labels`. (#567)
3345
3346 ### Removed
3347
3348 - The vendor specific Stackdriver. It is now hosted on 3rd party vendor infrastructure. (#452)
3349 - The `Unregister` method for metric observers as it is not in the OpenTelemetry specification. (#560)
3350 - `GetDescriptor` from the metric SDK. (#575)
3351 - The `Gauge` instrument from the metric API. (#537)
3352
3353 ### Fixed
3354
3355 - Make histogram aggregator checkpoint consistent. (#438)
3356 - Update README with import instructions and how to build and test. (#505)
3357 - The default label encoding was updated to be unique. (#508)
3358 - Use `NewRoot` in the othttp plugin for public endpoints. (#513)
3359 - Fix data race in `BatchedSpanProcessor`. (#518)
3360 - Skip test-386 for Mac OS 10.15.x (Catalina and upwards). #521
3361 - Use a variable-size array to represent ordered labels in maps. (#523)
3362 - Update the OTLP protobuf and update changed import path. (#532)
3363 - Use `StateLocker` implementation in `MinMaxSumCount`. (#546)
3364 - Eliminate goroutine leak in histogram stress test. (#547)
3365 - Update OTLP exporter with latest protobuf. (#550)
3366 - Add filters to the othttp plugin. (#556)
3367 - Provide an implementation of the `Header*` filters that do not depend on Go 1.14. (#565)
3368 - Encode labels once during checkpoint.
3369 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.
3370 This is a cheap and quick way to avoid encoding the labels on every collection interval. (#572)
3371 - Run coverage over all packages in `COVERAGE_MOD_DIR`. (#573)
3372
3373 ## [0.2.3] - 2020-03-04
3374
3375 ### Added
3376
3377 - `RecordError` method on `Span`s in the trace API to Simplify adding error events to spans. (#473)
3378 - Configurable push frequency for exporters setup pipeline. (#504)
3379
3380 ### Changed
3381
3382 - Rename the `exporter` directory to `exporters`.
3383 The `go.opentelemetry.io/otel/exporter/trace/jaeger` package was mistakenly released with a `v1.0.0` tag instead of `v0.1.0`.
3384 This resulted in all subsequent releases not becoming the default latest.
3385 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.
3386 Renaming the `exporter` directory to `exporters` fixes this issue by renaming the package and therefore clearing any existing dependency tags.
3387 Consequentially, this action also renames *all* exporter packages. (#502)
3388
3389 ### Removed
3390
3391 - The `CorrelationContextHeader` constant in the `correlation` package is no longer exported. (#503)
3392
3393 ## [0.2.2] - 2020-02-27
3394
3395 ### Added
3396
3397 - `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)
3398 - `HTTPExtractor` interface in the propagation API to extract information from an `HTTPSupplier` into a context. (#467)
3399 - `HTTPInjector` interface in the propagation API to inject information into an `HTTPSupplier.` (#467)
3400 - `Config` and configuring `Option` to the propagator API. (#467)
3401 - `Propagators` interface in the propagation API to contain the set of injectors and extractors for all supported carrier formats. (#467)
3402 - `HTTPPropagator` interface in the propagation API to inject and extract from an `HTTPSupplier.` (#467)
3403 - `WithInjectors` and `WithExtractors` functions to the propagator API to configure injectors and extractors to use. (#467)
3404 - `ExtractHTTP` and `InjectHTTP` functions to apply configured HTTP extractors and injectors to a passed context. (#467)
3405 - Histogram aggregator. (#433)
3406 - `DefaultPropagator` function and have it return `trace.TraceContext` as the default context propagator. (#456)
3407 - `AlwaysParentSample` sampler to the trace API. (#455)
3408 - `WithNewRoot` option function to the trace API to specify the created span should be considered a root span. (#451)
3409
3410 ### Changed
3411
3412 - Renamed `WithMap` to `ContextWithMap` in the correlation package. (#481)
3413 - Renamed `FromContext` to `MapFromContext` in the correlation package. (#481)
3414 - Move correlation context propagation to correlation package. (#479)
3415 - Do not default to putting remote span context into links. (#480)
3416 - `Tracer.WithSpan` updated to accept `StartOptions`. (#472)
3417 - Renamed `MetricKind` to `Kind` to not stutter in the type usage. (#432)
3418 - Renamed the `export` package to `metric` to match directory structure. (#432)
3419 - Rename the `api/distributedcontext` package to `api/correlation`. (#444)
3420 - Rename the `api/propagators` package to `api/propagation`. (#444)
3421 - Move the propagators from the `propagators` package into the `trace` API package. (#444)
3422 - Update `Float64Gauge`, `Int64Gauge`, `Float64Counter`, `Int64Counter`, `Float64Measure`, and `Int64Measure` metric methods to use value receivers instead of pointers. (#462)
3423 - Moved all dependencies of tools package to a tools directory. (#466)
3424
3425 ### Removed
3426
3427 - Binary propagators. (#467)
3428 - NOOP propagator. (#467)
3429
3430 ### Fixed
3431
3432 - Upgraded `github.com/golangci/golangci-lint` from `v1.21.0` to `v1.23.6` in `tools/`. (#492)
3433 - Fix a possible nil-dereference crash (#478)
3434 - Correct comments for `InstallNewPipeline` in the stdout exporter. (#483)
3435 - Correct comments for `InstallNewPipeline` in the dogstatsd exporter. (#484)
3436 - Correct comments for `InstallNewPipeline` in the prometheus exporter. (#482)
3437 - Initialize `onError` based on `Config` in prometheus exporter. (#486)
3438 - Correct module name in prometheus exporter README. (#475)
3439 - Removed tracer name prefix from span names. (#430)
3440 - Fix `aggregator_test.go` import package comment. (#431)
3441 - Improved detail in stdout exporter. (#436)
3442 - Fix a dependency issue (generate target should depend on stringer, not lint target) in Makefile. (#442)
3443 - 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)
3444 - Reword function documentation in gRPC plugin. (#446)
3445 - Send the `span.kind` tag to Jaeger from the jaeger exporter. (#441)
3446 - Fix `metadataSupplier` in the jaeger exporter to overwrite the header if existing instead of appending to it. (#441)
3447 - Upgraded to Go 1.13 in CI. (#465)
3448 - Correct opentelemetry.io URL in trace SDK documentation. (#464)
3449 - Refactored reference counting logic in SDK determination of stale records. (#468)
3450 - Add call to `runtime.Gosched` in instrument `acquireHandle` logic to not block the collector. (#469)
3451
3452 ## [0.2.1.1] - 2020-01-13
3453
3454 ### Fixed
3455
3456 - Use stateful batcher on Prometheus exporter fixing regression introduced in #395. (#428)
3457
3458 ## [0.2.1] - 2020-01-08
3459
3460 ### Added
3461
3462 - Global meter forwarding implementation.
3463 This enables deferred initialization for metric instruments registered before the first Meter SDK is installed. (#392)
3464 - Global trace forwarding implementation.
3465 This enables deferred initialization for tracers registered before the first Trace SDK is installed. (#406)
3466 - Standardize export pipeline creation in all exporters. (#395)
3467 - A testing, organization, and comments for 64-bit field alignment. (#418)
3468 - Script to tag all modules in the project. (#414)
3469
3470 ### Changed
3471
3472 - Renamed `propagation` package to `propagators`. (#362)
3473 - Renamed `B3Propagator` propagator to `B3`. (#362)
3474 - Renamed `TextFormatPropagator` propagator to `TextFormat`. (#362)
3475 - Renamed `BinaryPropagator` propagator to `Binary`. (#362)
3476 - Renamed `BinaryFormatPropagator` propagator to `BinaryFormat`. (#362)
3477 - Renamed `NoopTextFormatPropagator` propagator to `NoopTextFormat`. (#362)
3478 - Renamed `TraceContextPropagator` propagator to `TraceContext`. (#362)
3479 - Renamed `SpanOption` to `StartOption` in the trace API. (#369)
3480 - Renamed `StartOptions` to `StartConfig` in the trace API. (#369)
3481 - Renamed `EndOptions` to `EndConfig` in the trace API. (#369)
3482 - `Number` now has a pointer receiver for its methods. (#375)
3483 - Renamed `CurrentSpan` to `SpanFromContext` in the trace API. (#379)
3484 - Renamed `SetCurrentSpan` to `ContextWithSpan` in the trace API. (#379)
3485 - Renamed `Message` in Event to `Name` in the trace API. (#389)
3486 - Prometheus exporter no longer aggregates metrics, instead it only exports them. (#385)
3487 - Renamed `HandleImpl` to `BoundInstrumentImpl` in the metric API. (#400)
3488 - Renamed `Float64CounterHandle` to `Float64CounterBoundInstrument` in the metric API. (#400)
3489 - Renamed `Int64CounterHandle` to `Int64CounterBoundInstrument` in the metric API. (#400)
3490 - Renamed `Float64GaugeHandle` to `Float64GaugeBoundInstrument` in the metric API. (#400)
3491 - Renamed `Int64GaugeHandle` to `Int64GaugeBoundInstrument` in the metric API. (#400)
3492 - Renamed `Float64MeasureHandle` to `Float64MeasureBoundInstrument` in the metric API. (#400)
3493 - Renamed `Int64MeasureHandle` to `Int64MeasureBoundInstrument` in the metric API. (#400)
3494 - Renamed `Release` method for bound instruments in the metric API to `Unbind`. (#400)
3495 - Renamed `AcquireHandle` method for bound instruments in the metric API to `Bind`. (#400)
3496 - Renamed the `File` option in the stdout exporter to `Writer`. (#404)
3497 - Renamed all `Options` to `Config` for all metric exports where this wasn't already the case.
3498
3499 ### Fixed
3500
3501 - Aggregator import path corrected. (#421)
3502 - Correct links in README. (#368)
3503 - The README was updated to match latest code changes in its examples. (#374)
3504 - Don't capitalize error statements. (#375)
3505 - Fix ignored errors. (#375)
3506 - Fix ambiguous variable naming. (#375)
3507 - Removed unnecessary type casting. (#375)
3508 - Use named parameters. (#375)
3509 - Updated release schedule. (#378)
3510 - Correct http-stackdriver example module name. (#394)
3511 - Removed the `http.request` span in `httptrace` package. (#397)
3512 - Add comments in the metrics SDK (#399)
3513 - Initialize checkpoint when creating ddsketch aggregator to prevent panic when merging into a empty one. (#402) (#403)
3514 - Add documentation of compatible exporters in the README. (#405)
3515 - Typo fix. (#408)
3516 - Simplify span check logic in SDK tracer implementation. (#419)
3517
3518 ## [0.2.0] - 2019-12-03
3519
3520 ### Added
3521
3522 - Unary gRPC tracing example. (#351)
3523 - Prometheus exporter. (#334)
3524 - Dogstatsd metrics exporter. (#326)
3525
3526 ### Changed
3527
3528 - Rename `MaxSumCount` aggregation to `MinMaxSumCount` and add the `Min` interface for this aggregation. (#352)
3529 - Rename `GetMeter` to `Meter`. (#357)
3530 - Rename `HTTPTraceContextPropagator` to `TraceContextPropagator`. (#355)
3531 - Rename `HTTPB3Propagator` to `B3Propagator`. (#355)
3532 - Rename `HTTPTraceContextPropagator` to `TraceContextPropagator`. (#355)
3533 - Move `/global` package to `/api/global`. (#356)
3534 - Rename `GetTracer` to `Tracer`. (#347)
3535
3536 ### Removed
3537
3538 - `SetAttribute` from the `Span` interface in the trace API. (#361)
3539 - `AddLink` from the `Span` interface in the trace API. (#349)
3540 - `Link` from the `Span` interface in the trace API. (#349)
3541
3542 ### Fixed
3543
3544 - Exclude example directories from coverage report. (#365)
3545 - Lint make target now implements automatic fixes with `golangci-lint` before a second run to report the remaining issues. (#360)
3546 - 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)
3547 - Run the race checker for all test. (#354)
3548 - Redundant commands in the Makefile are removed. (#354)
3549 - Split the `generate` and `lint` targets of the Makefile. (#354)
3550 - Renames `circle-ci` target to more generic `ci` in Makefile. (#354)
3551 - Add example Prometheus binary to gitignore. (#358)
3552 - Support negative numbers with the `MaxSumCount`. (#335)
3553 - Resolve race conditions in `push_test.go` identified in #339. (#340)
3554 - Use `/usr/bin/env bash` as a shebang in scripts rather than `/bin/bash`. (#336)
3555 - Trace benchmark now tests both `AlwaysSample` and `NeverSample`.
3556 Previously it was testing `AlwaysSample` twice. (#325)
3557 - Trace benchmark now uses a `[]byte` for `TraceID` to fix failing test. (#325)
3558 - Added a trace benchmark to test variadic functions in `setAttribute` vs `setAttributes` (#325)
3559 - The `defaultkeys` batcher was only using the encoded label set as its map key while building a checkpoint.
3560 This allowed distinct label sets through, but any metrics sharing a label set could be overwritten or merged incorrectly.
3561 This was corrected. (#333)
3562
3563 ## [0.1.2] - 2019-11-18
3564
3565 ### Fixed
3566
3567 - Optimized the `simplelru` map for attributes to reduce the number of allocations. (#328)
3568 - Removed unnecessary unslicing of parameters that are already a slice. (#324)
3569
3570 ## [0.1.1] - 2019-11-18
3571
3572 This release contains a Metrics SDK with stdout exporter and supports basic aggregations such as counter, gauges, array, maxsumcount, and ddsketch.
3573
3574 ### Added
3575
3576 - Metrics stdout export pipeline. (#265)
3577 - Array aggregation for raw measure metrics. (#282)
3578 - The core.Value now have a `MarshalJSON` method. (#281)
3579
3580 ### Removed
3581
3582 - `WithService`, `WithResources`, and `WithComponent` methods of tracers. (#314)
3583 - Prefix slash in `Tracer.Start()` for the Jaeger example. (#292)
3584
3585 ### Changed
3586
3587 - Allocation in LabelSet construction to reduce GC overhead. (#318)
3588 - `trace.WithAttributes` to append values instead of replacing (#315)
3589 - Use a formula for tolerance in sampling tests. (#298)
3590 - Move export types into trace and metric-specific sub-directories. (#289)
3591 - `SpanKind` back to being based on an `int` type. (#288)
3592
3593 ### Fixed
3594
3595 - URL to OpenTelemetry website in README. (#323)
3596 - Name of othttp default tracer. (#321)
3597 - `ExportSpans` for the stackdriver exporter now handles `nil` context. (#294)
3598 - CI modules cache to correctly restore/save from/to the cache. (#316)
3599 - Fix metric SDK race condition between `LoadOrStore` and the assignment `rec.recorder = i.meter.exporter.AggregatorFor(rec)`. (#293)
3600 - README now reflects the new code structure introduced with these changes. (#291)
3601 - Make the basic example work. (#279)
3602
3603 ## [0.1.0] - 2019-11-04
3604
3605 This is the first release of open-telemetry go library.
3606 It contains api and sdk for trace and meter.
3607
3608 ### Added
3609
3610 - Initial OpenTelemetry trace and metric API prototypes.
3611 - Initial OpenTelemetry trace, metric, and export SDK packages.
3612 - A wireframe bridge to support compatibility with OpenTracing.
3613 - Example code for a basic, http-stackdriver, http, jaeger, and named tracer setup.
3614 - Exporters for Jaeger, Stackdriver, and stdout.
3615 - Propagators for binary, B3, and trace-context protocols.
3616 - Project information and guidelines in the form of a README and CONTRIBUTING.
3617 - Tools to build the project and a Makefile to automate the process.
3618 - Apache-2.0 license.
3619 - CircleCI build CI manifest files.
3620 - CODEOWNERS file to track owners of this project.
3621
3622 [Unreleased]: https://github.com/open-telemetry/opentelemetry-go/compare/v1.43.0...HEAD
3623 [1.43.0/0.65.0/0.19.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.43.0
3624 [1.42.0/0.64.0/0.18.0/0.0.16]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.42.0
3625 [1.41.0/0.63.0/0.17.0/0.0.15]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.41.0
3626 [1.40.0/0.62.0/0.16.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.40.0
3627 [1.39.0/0.61.0/0.15.0/0.0.14]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.39.0
3628 [1.38.0/0.60.0/0.14.0/0.0.13]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.38.0
3629 [0.59.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/exporters/prometheus/v0.59.1
3630 [1.37.0/0.59.0/0.13.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.37.0
3631 [0.12.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/log/v0.12.2
3632 [0.12.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/log/v0.12.1
3633 [1.36.0/0.58.0/0.12.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.36.0
3634 [1.35.0/0.57.0/0.11.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.35.0
3635 [1.34.0/0.56.0/0.10.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.34.0
3636 [1.33.0/0.55.0/0.9.0/0.0.12]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.33.0
3637 [1.32.0/0.54.0/0.8.0/0.0.11]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.32.0
3638 [1.31.0/0.53.0/0.7.0/0.0.10]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.31.0
3639 [1.30.0/0.52.0/0.6.0/0.0.9]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.30.0
3640 [1.29.0/0.51.0/0.5.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.29.0
3641 [1.28.0/0.50.0/0.4.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.28.0
3642 [1.27.0/0.49.0/0.3.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.27.0
3643 [1.26.0/0.48.0/0.2.0-alpha]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.26.0
3644 [1.25.0/0.47.0/0.0.8/0.1.0-alpha]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.25.0
3645 [1.24.0/0.46.0/0.0.1-alpha]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.24.0
3646 [1.23.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.23.1
3647 [1.23.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.23.0
3648 [1.23.0-rc.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.23.0-rc.1
3649 [1.22.0/0.45.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.22.0
3650 [1.21.0/0.44.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.21.0
3651 [1.20.0/0.43.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.20.0
3652 [1.19.0/0.42.0/0.0.7]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.19.0
3653 [1.19.0-rc.1/0.42.0-rc.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.19.0-rc.1
3654 [1.18.0/0.41.0/0.0.6]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.18.0
3655 [1.17.0/0.40.0/0.0.5]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.17.0
3656 [1.16.0/0.39.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.16.0
3657 [1.16.0-rc.1/0.39.0-rc.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.16.0-rc.1
3658 [1.15.1/0.38.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.15.1
3659 [1.15.0/0.38.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.15.0
3660 [1.15.0-rc.2/0.38.0-rc.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.15.0-rc.2
3661 [1.15.0-rc.1/0.38.0-rc.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.15.0-rc.1
3662 [1.14.0/0.37.0/0.0.4]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.14.0
3663 [1.13.0/0.36.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.13.0
3664 [1.12.0/0.35.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.12.0
3665 [1.11.2/0.34.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.11.2
3666 [1.11.1/0.33.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.11.1
3667 [1.11.0/0.32.3]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.11.0
3668 [0.32.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/sdk/metric/v0.32.2
3669 [0.32.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/sdk/metric/v0.32.1
3670 [0.32.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/sdk/metric/v0.32.0
3671 [1.10.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.10.0
3672 [1.9.0/0.0.3]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.9.0
3673 [1.8.0/0.31.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.8.0
3674 [1.7.0/0.30.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.7.0
3675 [0.29.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/metric/v0.29.0
3676 [1.6.3]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.6.3
3677 [1.6.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.6.2
3678 [1.6.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.6.1
3679 [1.6.0/0.28.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.6.0
3680 [1.5.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.5.0
3681 [1.4.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.4.1
3682 [1.4.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.4.0
3683 [1.3.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.3.0
3684 [1.2.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.2.0
3685 [1.1.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.1.0
3686 [1.0.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.0.1
3687 [Metrics 0.24.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/metric/v0.24.0
3688 [1.0.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.0.0
3689 [1.0.0-RC3]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.0.0-RC3
3690 [1.0.0-RC2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.0.0-RC2
3691 [Experimental Metrics v0.22.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/metric/v0.22.0
3692 [1.0.0-RC1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.0.0-RC1
3693 [0.20.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.20.0
3694 [0.19.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.19.0
3695 [0.18.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.18.0
3696 [0.17.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.17.0
3697 [0.16.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.16.0
3698 [0.15.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.15.0
3699 [0.14.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.14.0
3700 [0.13.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.13.0
3701 [0.12.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.12.0
3702 [0.11.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.11.0
3703 [0.10.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.10.0
3704 [0.9.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.9.0
3705 [0.8.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.8.0
3706 [0.7.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.7.0
3707 [0.6.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.6.0
3708 [0.5.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.5.0
3709 [0.4.3]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.4.3
3710 [0.4.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.4.2
3711 [0.4.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.4.1
3712 [0.4.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.4.0
3713 [0.3.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.3.0
3714 [0.2.3]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.2.3
3715 [0.2.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.2.2
3716 [0.2.1.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.2.1.1
3717 [0.2.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.2.1
3718 [0.2.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.2.0
3719 [0.1.2]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.1.2
3720 [0.1.1]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.1.1
3721 [0.1.0]: https://github.com/open-telemetry/opentelemetry-go/releases/tag/v0.1.0
3722
3723 <!-- Released section ended -->
3724
3725 [Go 1.26]: https://go.dev/doc/go1.26
3726 [Go 1.25]: https://go.dev/doc/go1.25
3727 [Go 1.24]: https://go.dev/doc/go1.24
3728 [Go 1.23]: https://go.dev/doc/go1.23
3729 [Go 1.22]: https://go.dev/doc/go1.22
3730 [Go 1.21]: https://go.dev/doc/go1.21
3731 [Go 1.20]: https://go.dev/doc/go1.20
3732 [Go 1.19]: https://go.dev/doc/go1.19
3733 [Go 1.18]: https://go.dev/doc/go1.18
3734
3735 [metric API]:https://pkg.go.dev/go.opentelemetry.io/otel/metric
3736 [metric SDK]:https://pkg.go.dev/go.opentelemetry.io/otel/sdk/metric
3737 [trace API]:https://pkg.go.dev/go.opentelemetry.io/otel/trace
3738
3739 [GO-2024-2687]: https://pkg.go.dev/vuln/GO-2024-2687