go.opentelemetry.io/otel

This release is the last to support [Go 1.21]. The next release will require at least [Go 1.22].

Added

• Add MacOS ARM64 platform to the compatibility testing suite. (#5577)
• Add InstrumentationScope field to SpanStub in go.opentelemetry.io/otel/sdk/trace/tracetest, as a replacement for the deprecated InstrumentationLibrary. (#5627)
• Make the initial release of go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc. This new module contains an OTLP exporter that transmits log telemetry using gRPC. This module is unstable and breaking changes may be introduced. See our versioning policy for more information about these stability guarantees. (#5629)
• Add Walk function to TraceState in go.opentelemetry.io/otel/trace to iterate all the key-value pairs. (#5651)
• Bridge the trace state in go.opentelemetry.io/otel/bridge/opencensus. (#5651)
• Zero value of SimpleProcessor in go.opentelemetry.io/otel/sdk/log no longer panics. (#5665)
• The FilterProcessor interface type is added in go.opentelemetry.io/otel/sdk/log/internal/x. This is an optional and experimental interface that log Processors can implement to instruct the Logger if a Record will be processed or not. It replaces the existing Enabled method that is removed from the Processor interface itself. It does not fall within the scope of the OpenTelemetry Go versioning and stability policy and it may be changed in backwards incompatible ways or removed in feature releases. (#5692)
• Support [Go 1.23]. (#5720)

Changed

• NewMemberRaw, NewKeyProperty and NewKeyValuePropertyRaw in go.opentelemetry.io/otel/baggage allow UTF-8 string in key. (#5132)
• 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)
• SimpleProcessor.Enabled in go.opentelemetry.io/otel/sdk/log now returns false if the exporter is nil. (#5665)
• Update the concurrency requirements of Exporter in go.opentelemetry.io/otel/sdk/log. (#5666)
• SimpleProcessor in go.opentelemetry.io/otel/sdk/log synchronizes OnEmit calls. (#5666)
• The Processor interface in go.opentelemetry.io/otel/sdk/log no longer includes the Enabled method. See the FilterProcessor interface type added in go.opentelemetry.io/otel/sdk/log/internal/x to continue providing this functionality. (#5692)
• The SimpleProcessor type in go.opentelemetry.io/otel/sdk/log is no longer comparable. (#5693)
• The BatchProcessor type in go.opentelemetry.io/otel/sdk/log is no longer comparable. (#5693)

Fixed

• 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)
• 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)
• Correct the Tracer, Meter, and Logger names used in go.opentelemetry.io/otel/example/dice. (#5612)
• Correct the Tracer names used in go.opentelemetry.io/otel/example/namedtracer. (#5612)
• Correct the Tracer name used in go.opentelemetry.io/otel/example/opencensus. (#5612)
• Correct the Tracer and Meter names used in go.opentelemetry.io/otel/example/otel-collector. (#5612)
• Correct the Tracer names used in go.opentelemetry.io/otel/example/passthrough. (#5612)
• Correct the Meter name used in go.opentelemetry.io/otel/example/prometheus. (#5612)
• Correct the Tracer names used in go.opentelemetry.io/otel/example/zipkin. (#5612)
• 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)
• 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)
• 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)
• 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)

Removed

• The Enabled method of the SimpleProcessor in go.opentelemetry.io/otel/sdk/log is removed. (#5692)
• The Enabled method of the BatchProcessor in go.opentelemetry.io/otel/sdk/log is removed. (#5692)

Added

• Dockerfile and docker-compose.yml to run example code. (#635)
• New grpctrace package that provides gRPC client and server interceptors for both unary and stream connections. (#621)
• New api/label package, providing common label set implementation. (#651)
• Support for JSON marshaling of Resources. (#654)
• TraceID and SpanID implementations for Stringer interface. (#642)
• RemoteAddrKey in the othttp plugin to include the HTTP client address in top-level spans. (#627)
• WithSpanFormatter option to the othttp plugin. (#617)
• Updated README to include section for compatible libraries and include reference to the contrib repository. (#612)
• The prometheus exporter now supports exporting histograms. (#601)
• A String method to the Resource to return a hashable identifier for a now unique resource. (#613)
• An Iter method to the Resource to return an array AttributeIterator. (#613)
• An Equal method to the Resource test the equivalence of resources. (#613)
• An iterable structure (AttributeIterator) for Resource attributes.

Changed

• zipkin export's NewExporter now requires a serviceName argument to ensure this needed values is provided. (#644)
• Pass Resources through the metrics export pipeline. (#659)

Removed

• WithKeys option from the metric API. (#639)

Fixed

• Use the label.Set.Equivalent value instead of an encoding in the batcher. (#658)
• Correct typo trace.Exporter to trace.SpanSyncer in comments. (#653)
• Use type names for return values in jaeger exporter. (#648)
• Increase the visibility of the api/key package by updating comments and fixing usages locally. (#650)
• Checkpoint only after Update; Keep records in the sync.Map longer. (#647)
• Do not cache reflect.ValueOf() in metric Labels. (#649)
• Batch metrics exported from the OTLP exporter based on Resource and labels. (#626)
• Add error wrapping to the prometheus exporter. (#631)
• Update the OTLP exporter batching of traces to use a unique string representation of an associated Resource as the batching key. (#623)
• Update OTLP SpanData transform to only include the ParentSpanID if one exists. (#614)
• Update Resource internal representation to uniquely and reliably identify resources. (#613)
• Check return value from CheckpointSet.ForEach in prometheus exporter. (#622)
• Ensure spans created by httptrace client tracer reflect operation structure. (#618)
• Create a new recorder rather than reuse when multiple observations in same epoch for asynchronous instruments. #610
• 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)

Fixed

• Fix pre_release.sh to update version in sdk/opentelemetry.go. (#607)
• Fix time conversion from internal to OTLP in OTLP exporter. (#606)

Fixed

• Update tag.sh to create signed tags. (#604)