Version 1.37.0

NOTICE: This release contains a significant restructuring of the experimental event API and the API incubator artifact. Please read the notes in the API -> Incubator section carefully.

API

• Promote Span#addLink to stable API (#6317)

Incubator

• BREAKING: Rename opentelemetry-extension-incubator to opentelemetry-api-incubator, merge opentelemetry-api-events into opentelemetry-api-incubator. (#6289)
• BREAKING: Remove domain from event api. EventEmitterProvider#setEventDomain has been removed. The event.name field should now be namespaced to avoid collisions. See Semantic Conventions for Event Attributes for more details. (#6253)
• BREAKING: Rename EventEmitter and related classes to EventLogger. (#6316)
• BREAKING: Refactor Event API to reflect spec changes. Restructure API to put fields in the AnyValue log record body. Add setters for timestamp, context, and severity. Set default severity to INFO=9. (#6318)

SDK

• Add get{Signal}Exporter methods to Simple{Signal}Processor, Batch{Signal}Processor. (#6078)

Metrics

• Use synchronized instead of reentrant lock in explicit bucket histogram (#6309)

Exporters

• Fix typo in OTLP javadoc (#6311)
• Add PrometheusHttpServer#toBuilder() (#6333)
• Bugfix: Use getPrometheusName for Otel2PrometheusConverter map keys to avoid metric name conflicts (#6308)

Extensions

• Add Metric exporter REUSABLE_DATA memory mode configuration options, including autoconfigure support via env var OTEL_JAVA_EXPERIMENTAL_EXPORTER_MEMORY_MODE=REUSABLE_DATA. (#6304)
• Add autoconfigure console alias for logging exporter (#6027)
• Update jaeger autoconfigure docs to point to OTLP (#6307)
• Add ServiceInstanceIdResourceProvider implementation for generating service.instance.id UUID if not already provided by user. Included in opentelemetry-sdk-extension-incubator. (#6226)
• Add GCP resource detector to list of resource providers in autoconfigure docs (#6336)

Tooling

• Check for Java 17 toolchain and fail if not found (#6303)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@asafm
@bogdandrutu
@breedx-splk
@brunobat
@helpermethod
@jack-berg
@jkwatson
@jonatan-ivanov
@jpkrohling
@MSNev
@nluk
@psx95
@robberphex
@scheler
@trask
@zeitlinger

Version 1.36.0

SDK

Traces

• Lazily initialize the container for events in the SDK Span implementation (#6244)

Exporters

• Add basic proxy configuration to OtlpHttp{Signal}Exporters (#6270)
• Add connectTimeout configuration option OtlpGrpc{Signal}Exporters (#6079)

Extensions

• Add ComponentLoader to autoconfigure support more scenarios (#6217)
• Added MetricReader customizer for AutoConfiguredOpenTelemetrySdkBuilder (#6231)
• Return AutoConfiguredOpenTelemetrySdkBuilder instead of the base type (#6248)

Tooling

• Add note about draft PRs to CONTRIBUTING.md (#6247)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@alexandru-roman-db
@asafm
@breedx-splk
@jack-berg
@jeanbisutti
@jkwatson
@johnbley
@lmolkova
@marcschumacher
@trask
@tydhot
@zeitlinger

Version 1.35.0

NOTE: The opentelemetry-exporter-jaeger and opentelemetry-exporter-jaeger-thift artifacts have stopped being published. Jaeger has native support for OTLP, and users should export to jaeger using OTLP instead.

API

Incubator

• Add Span#addLink, for adding a link after span start (#6084)

SDK

Traces

• Bugfix: Ensure span status cannot be updated after set to StatusCode.OK (#6209

Metrics

• Reusable memory Mode: Adding support for exponential histogram aggregation (#6058, #6136)
• Reusable memory mode: Adding support for explicit histogram aggregation (#6153)
• Reusable memory mode: Adding support for sum aggregation (#6182)
• Reusable memory mode: Adding support for last value aggregation (#6196)

Exporters

• Recreate / fix graal issue detecting RetryPolicy class (#6139, #6134)
• Restore prometheus metric name mapper tests, fix regressions (#6138)
• WARNING: Remove jaeger exporters (#6119)
• Update dependency io.zipkin.reporter2:zipkin-reporter-bom to 3.2.1. Note: ZipkinSpanExporterBuilder#setEncoder(zipkin2.codec.BytesEncoder) has been deprecated in favor of ZipkinSpanExporterBuilder#setEncoder(zipkin2.reporter.BytesEncoder). ZipkinSpanExporterBuilder#setSender(zipkin2.reporter.Sender) has been deprecated in favor of ZipkinSpanExporterBuilder#setSender(zipkin2.reporter.BytesMessageSender). (#6129, #6151)
• Include trace flags in otlp marshaller (#6167)
• Add Compressor SPI support to OtlpGrpc{Signal}Exporters (#6103)
• Allow Prometheus exporter to add resource attributes to metric attributes (#6179)

Extension

• Autoconfigure accepts encoded header values for OTLP exporters (#6164)

Incubator

• Align file configuration with latest changes to spec (#6088)

Tooling

• Stop including old artifacts in bom (#6157)
• Define CODECOV token (#6186)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@apederson94
@asafm
@breedx-splk
@brunobat
@codefromthecrypt
@fstab
@jack-berg
@jkwatson
@NicklasWallgren
@patrick-me
@psx95
@trask
@zeitlinger

Version 1.34.1

This is a patch release on the previous 1.34.0 release, fixing the issue(s) below.

• Fix prometheus exporter regressions (#6138)
• Fix native image regression (#6134)

Version 1.34.0

NOTE: This is the LAST release for opentelemetry-exporter-jaeger and opentelemetry-exporter-jaeger-thift. Jaeger has native support for OTLP, and users should export to jaeger using OTLP instead.

API

• Ability to access version.properties API file with GraalVM native (#6095)

SDK

Traces

• Only call SpanProcessor onStart / onEnd if required (#6112)
• Add option to export unsampled spans from span processors (#6057)

Metrics

• Memory Mode: Adding first part support for synchronous instruments - storage (#5998)
• Base2ExponentialHistogramAggregation maxBuckets must be >= 2 (#6093)
• Convert histogram measurements to double before passing recording exemplar reservoir (#6024)

Exporters

• Add compressor SPI to support additional compression algos (#5990)
• Test OTLP exporters with different OkHttp versions (#6045)
• Refactor prometheus exporter to use io.prometheus:prometheus-metrics-exporter-httpserver, add exponential Histogram support (#6015)
• UpstreamGrpcSenderProvider uses minimal fallback managed channel when none is specified (#6110)
• OTLP exporters propagate serialization IOException instead of rethrowing as runtime (#6082)

Extensions

• Autoconfigure reads normalized otel.config.file property (#6105)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@asafm
@axw
@fax4ever
@fstab
@HaloFour
@jack-berg
@jeanbisutti
@jkwatson
@lchdev
@nluk
@NthPortal
@patrick-me
@ricardo-mestre
@TomasChladekSL
@trask

Version 1.33.0

API

• Fix issue where wrapping "invalid" SpanContexts in Span does not preserve SpanContext (#6044)

Incubator

• Refactor and add to ExtendedTracer, add ExtendedContextPropagators (#6017)
• Base64 encode AnyValue bytes in string representation (#6003)

SDK

Exporters

• Add connectTimeout configuration option OtlpHttp{Signal}Exporters (#5941)
• Add ability for Otlp{Protocol}LogRecordExporter to serialize log body any value (#5938)
• Android environments can now handle base64 encoded PEM keys, remove exception handling in TlsUtil#decodePem (#6034)
• Add header supplier configuration option to OTLP exporters (#6004)

Extensions

• Add autoconfigure option for customizing SpanProcessor, LogRecordProcessor (#5986)
• Incubator allows for simpler creation of start-only and end-only SpanProcessors. (#5923)

Testing

• Add hasAttributesSatisfying overload to AbstractPointAssert (#6048)

Project Tooling

• Building animal sniffer signatures directly from android corelib (#5973)
• Target kotlin 1.6 in kotlin extension (#5910)
• Define language version compatibility requirements (#5983)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@anuraaga
@asafm
@breedx-splk
@chungngoops
@felixscheinost
@jack-berg
@jackshirazi
@jkwatson
@JonasKunz
@laurit
@LikeTheSalad
@mateuszrzeszutek
@mikelaspina
@PeterF778
@scheler
@SenNeonoveNoci
@shadow0wolf
@trask
@zeitlinger

Version 1.32.0

API

• Stabilize explicit bucket boundaries advice API (#5897)
• Allow events to be emitted with timestamp (#5928)

Context

• Add null check to StrictContextStorage (#5954)

Incubator

• Experimental support for Log AnyValue body (#5880)

SDK

Metrics

• Dismantle AbstractInstrumentBuilder inheritance hierarchy (#5820)
• Fix delta metric storage concurrency bug that allows for lost writes when record operations occur during collection. The fix introduces additional work on record threads to ensure correctness. The additional overhead is non-blocking and should be small according to performance testing. Still, there may be an opportunity for further optimization. (#5932, #5976)

Exporters

• Prometheus exporter: omit empty otel_scope_info and otel_target_info metrics (#5887)
• JdkHttpSender should retry on connect exceptions (#5867)
• Expand the set of retryable exceptions in JdkHttpSender (#5942)
• Identify OTLP export calls with context key used for instrumentation suppression (#5918)

Testing

• Add log support to junit extensions (#5966)

SDK Extensions

• Add file configuration to autoconfigure (#5831)
• Update to file configuration to use opentelemetry-configuration v0.1.0 (#5899)
• Add env var substitution support to file configuration (#5914)
• Stop setting Resource schemaUrl in autoconfigure (#5911)
• Add AutoConfigureListener to provide components with autoconfigured SDK (#5931)

OpenCensus Shim

• Clean up OpenCensus shim (#5858)

OpenTracing Shim

• Fix OpenTracing header name issue (#5840)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@abdolsamad
@anuraaga
@asafm
@breedx-splk
@dashpole
@jack-berg
@jackshirazi
@jamesylgan
@jkwatson
@laurit
@LikeTheSalad
@mateuszrzeszutek
@mikelaspina
@nluk
@steffan-westcott
@trask

Version 1.31.0

API

Incubator

• Refactor advice API to simplify usage (#5848)

SDK

• BatchLogRecordProcessor and BatchSpanProcessor unify queueSize metric description and attribute name for processorType (#5836)

Metrics

• Allow instrument names to contain a forward slash (#5824)
• Memory Mode support: Adding memory mode, and implementing it for Asynchronous Instruments (#5709, #5855)
• Stabilize MetricProducer, allow custom MetricReaders (#5835)
• Drop NaN measurements to metric instruments (#5859)
• Fix flaky MetricExporterConfigurationTest (#5877)

Logs

• Add addAllAttributes() to ReadWriteLogRecord. (#5825)

Exporters

• Prometheus exporter: handle colliding metric attribute keys (#5717)

SDK Extensions

• File configuration ConfigurationReader handles null values as empty (#5829)

Semantic conventions

• BREAKING: Stop publishing io.opentelemetry:opentelemetry-semconv. Please use io.opentelemetry.semconv:opentelemetry-semconv:1.21.0-alpha instead, which is published from open-telemetry/semantic-conventions-java. The new repository is published in lockstep with open-telemetry/semantic-conventions. (#5807)

Project Tooling

• Add Benchmark workflows (#5842, #5874)
• Add clearer docs around coroutine support with an example (#5799)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@aabmass
@asafm
@breedx-splk
@cbos
@cmunger
@dashpole
@evantorrie
@jack-berg
@jkwatson
@laurit
@LikeTheSalad
@mateuszrzeszutek
@puckpuck
@scprek
@trask
@tylerbenson

Version 1.30.1

This is a patch release on the previous 1.30.0 release, fixing the issue(s) below.

• Fix autoconfigure bug creating multiple PrometheusHttpServer instances with same port (#5911)

Version 1.30.0

API

Incubator

• Add experimental synchronous gauge (#5506)

SDK

Metrics

• Add attributes advice API (#5677, #5722)
• Add AttributesProcessor toString, add attribute filter helper (#5765)
• Increase metric name maximum length from 63 to 255 characters (#5697)

Exporter

• Prometheus exporter: remove non-ucum units from conversion (#5719)
• Prometheus exporter: add units to metric names in TYPE and HELP comments (#5718)

SDK Extensions

• Add support for file based configuration to incubator (#5687, #5751, #5758, #5757, #5755, #5763, #5766, #5773, #5771, #5779)
• Autoconfigure ConfigProperties#getMap filters entries with blank values instead of throwing (#5784)

Semantic conventions

• DEPRECATION: io.opentelemetry:opentelemetry-semconv is deprecated for removal. Please use io.opentelemetry.semconv:opentelemetry-semconv:1.21.0-alpha instead, which is published from open-telemetry/semantic-conventions-java. The new repository is published in lockstep with open-telemetry/semantic-conventions. (#5786)

Project Tooling

• Update Gradle Wrapper from 8.2.1 to 8.3 (#5728)
• Remove dependabot and update-gradle-wrapper task in favor of renovate (#5746)

🙇 Thank you

This release was possible thanks to the following contributors who shared their brilliant ideas and awesome pull requests:

@breedx-splk
@brunobat
@dashpole
@dependabot
@Emily-Jiang
@erenming
@jack-berg
@jkwatson
@jsuereth
@mateuszrzeszutek
@tigrannajaryan
@trask
@tylerbenson