Last release today
02 Sep 2026
Ships on a steady schedule
a new release about every 8 days
Some releases are documented
notes for 23 of 58 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
3522 releases · first in 2021
One column per quarter.
Export() function takes a new two-level reader interface for iterating over results one instrumentation library at a time. (#2197)
"go.opentelemetry.io/otel/sdk/export/metric".CheckpointSet is renamed Reader."go.opentelemetry.io/otel/sdk/export/metric".InstrumentationLibraryReader.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
go.opentelemetry.io/otel/exporters/metric/prometheus. (#2020)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
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
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
with major version 0.
otlpgrpc.WithRetryoption for configuring the retry policy for transient errors on the otlp/gRPC exporter. (#1832)
| gRPC Status Code | Description |
|---|---|
| 1 | Cancelled |
| 4 | Deadline Exceeded |
| 8 | Resource Exhausted |
| 10 | Aborted |
| 10 | Out of Range |
| 14 | Unavailable |
| 15 | Data Loss |
Status type to the go.opentelemetry.io/otel/sdk/trace package to represent the status of a span. (#1874)SpanStub type and its associated functions to the go.opentelemetry.io/otel/sdk/trace/tracetest package.
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)OTEL_EXPORTER_OTLP_ENDPOINT according to the spec. (#1886)trace.WithSchemaURL option for configuring the tracer with a Schema URL. (#1889)ParseTraceState is added to the go.opentelemetry.io/otel/trace package.
It can be used to decode a TraceState from a tracestate header string value. (#1937)Len method to the TraceState type in the go.opentelemetry.io/otel/trace package.
This method returns the number of list-members the TraceState holds. (#1937)go.opentelemetry.io/otel/exporters/otlp/otlptrace that defines a trace exporter that uses a otlptrace.Client to send data.
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)Baggage, Member, and Property types to the go.opentelemetry.io/otel/baggage package along with their related functions. (#1967)ContextWithBaggage, ContextWithoutBaggage, and FromContext functions to the go.opentelemetry.io/otel/baggage package.
These functions replace the Set, Value, ContextWithValue, ContextWithoutValue, and ContextWithEmpty functions from that package and directly work with the new Baggage type. (#1967)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)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)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)go.opentelemetry.io/otel/exporters/otlp/otlpmetric that defines a metrics exporter that uses a otlpmetric.Client to send data.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)go.opentelemetry.io/otel/exporters/stdout/stdouttrace exporter. (#2005)go.opentelemetry.io/otel/exporters/stdout/stdoutmetric exporter. (#2005)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)NewSplitDriver from go.opentelemetry.io/otel/exporters/otlp take variadic arguments instead of a SplitConfig item.
NewSplitDriver now automatically implements an internal noopDriver for SplitConfig fields that are not initialized. (#1798)resource.New() now creates a Resource without builtin detectors. Previous behavior is now achieved by using WithBuiltinDetectors Option. (#1810)Event type from the go.opentelemetry.io/otel package to the go.opentelemetry.io/otel/sdk/trace package. (#1846)ForceFlush() method. (#1860)Set.Encoded(Encoder) no longer caches the result of an encoding. (#1855)CloudZoneKey to CloudAvailabilityZoneKey in Resource semantic conventions according to spec. (#1871)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.
This method returns the status of a span using the new Status type. (#1874)ExportSpans method of theSpanExporter interface type to accept ReadOnlySpans instead of the removed SpanSnapshot.
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)SpanContext in Link. (#1877)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)"go.opentelemetry.io/otel".Tracer function now accepts tracer options. (#1902)go.opentelemetry.io/otel/unit package to go.opentelemetry.io/otel/metric/unit. (#1903)go.opentelemetry.io/otel/trace.TracerConfig to conform to the Contributing guidelines (#1921)go.opentelemetry.io/otel/trace.SpanConfig to conform to the Contributing guidelines. (#1921)span.End() now only accepts Options that are allowed at End(). (#1921)go.opentelemetry.io/otel/metric.InstrumentConfig to conform to the Contributing guidelines. (#1921)go.opentelemetry.io/otel/metric.MeterConfig to conform to the Contributing guidelines. (#1921)go.opentelemetry.io/otel/trace.TraceStateFromKeyValues function to the go.opentelemetry.io/otel/oteltest package.
This function is preserved for testing purposes where it may be useful to create a TraceState from attribute.KeyValues, but it is not intended for production use.
The new ParseTraceState function should be used to create a TraceState. (#1931)MarshalJSON method of the go.opentelemetry.io/otel/trace.TraceState type to marshal the type into the string representation of the TraceState. (#1931)TraceState.Delete method from the go.opentelemetry.io/otel/trace package no longer returns an error in addition to a TraceState. (#1931)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)Insert method of the TraceState type from the go.opentelemetry.io/otel/trace package to accept a pair of strings instead of an attribute.KeyValue type. (#1931)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)NewExporter to New in the go.opentelemetry.io/otel/exporters/stdout package. (#1985)NewExporter to New in the go.opentelemetry.io/otel/exporters/metric/prometheus package. (#1985)NewExporter to New in the go.opentelemetry.io/otel/exporters/trace/jaeger package. (#1985)NewExporter to New in the go.opentelemetry.io/otel/exporters/trace/zipkin package. (#1985)NewExporter to New in the go.opentelemetry.io/otel/exporters/otlp package. (#1985)NewUnstartedExporter to NewUnstarted in the go.opentelemetry.io/otel/exporters/otlp package. (#1985)go.opentelemetry.io/otel/semconv package has been moved to go.opentelemetry.io/otel/semconv/v1.4.0 to allow for multiple telemetry schema versions to be used concurrently. (#1987)go.opentelemetry.io/otel/oteltest have been moved to go.opentelemetry.io/otel/metric/metrictest. (#1988)go.opentelemetry.io/otel/exporters/metric/prometheus is deprecated, use go.opentelemetry.io/otel/exporters/prometheus instead. (#1993)go.opentelemetry.io/otel/exporters/trace/jaeger is deprecated, use go.opentelemetry.io/otel/exporters/jaeger instead. (#1993)go.opentelemetry.io/otel/exporters/trace/zipkin is deprecated, use go.opentelemetry.io/otel/exporters/zipkin instead. (#1993)resource.WithoutBuiltin(). Use resource.New(). (#1810)resource.FromEnv, resource.Host, and resource.TelemetrySDK, Use the corresponding With*() to use individually. (#1810)Tracer and IsRecording method from the ReadOnlySpan in the go.opentelemetry.io/otel/sdk/trace.
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.
The IsRecording method returns if the span is recording or not.
A read-only span value does not need to know if updates to it will be recorded or not.
By definition, it cannot be updated so there is no point in communicating if an update is recorded. (#1873)SpanSnapshot type from the go.opentelemetry.io/otel/sdk/trace package.
The use of this type has been replaced with the use of the explicitly immutable ReadOnlySpan type.
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)Tracer method from the Span interface in the go.opentelemetry.io/otel/trace package.
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.
The "go.opentelemetry.io/otel".Tracer function or a TracerProvider should be used to acquire a library specific Tracer instead. (#1900)
TracerProvider() method on the Span interface may also be used to obtain a TracerProvider using the same trace processing pipeline. (#2009)http.url attribute generated by HTTPClientAttributesFromHTTPRequest will no longer include username or password information. (#1919)IsEmpty method of the TraceState type in the go.opentelemetry.io/otel/trace package in favor of using the added TraceState.Len method. (#1931)Set, Value, ContextWithValue, ContextWithoutValue, and ContextWithEmpty functions in the go.opentelemetry.io/otel/baggage package.
Handling of baggage is now done using the added Baggage type and related context functions (ContextWithBaggage, ContextWithoutBaggage, and FromContext) in that package. (#1967)InstallNewPipeline and NewExportPipeline creation functions in all the exporters (prometheus, otlp, stdout, jaeger, and zipkin) have been removed.
These functions were deemed premature attempts to provide convenience that did not achieve this aim. (#1985)go.opentelemetry.io/otel/exporters/otlp exporter has been removed. Use go.opentelemetry.io/otel/exporters/otlp/otlptrace instead. (#1990)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)"go.opentelemetry.io/otel/sdk/resource".Environment function when they are not nil. (#1850, #1851)Shutdown method of the simple SpanProcessor in the go.opentelemetry.io/otel/sdk/trace package now honors the context deadline or cancellation. (#1616, #1856)http://localhost:14268/api/traces as default Jaeger collector endpoint instead of http://localhost:14250. (#1898)tracestate header. (#1931)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version