open-telemetry/opentelemetry-java v1.15.0

Version 1.15.0

on GitHub

This release targets the OpenTelemetry SDK 1.15.0.

API

• Add batch callback API, allowing a single callback to record measurements to multiple metric instruments.

SDK

Metrics

• SdkMeterProvider#toString() now returns a useful string describing configuration.
• Fix bug preventing proper function of Metrics SDK when multiple readers are present (#4436).
• Fix reporting intervals for metrics for delta readers (#4400).

Exporter

• BREAKING: merge all stable OTLP exporters into opentelemetry-exporter-otlp. opentelemetry-exporter-otlp-trace, opentelemetry-exporter-otlp-metrics, opentelemetry-exporter-otlp-http-trace, and opentelemetry-exporter-otlp-http-metrics are no longer published and their contents have been merged into a single artifact.
• BREAKING: merge log OTLP exporters into opentelemetry-exporter-otlp-logs. opentelemetry-exporter-otlp-http-logs is no longer published and its contents have been merged into a single artifact.
• Upgrade to OTLP protobuf version 0.18.0.
• RetryInterceptor retries on SocketTimeoutException with no message.
• Added JaegerGrpcSpanExporterBuilder#setMeterProvider(), enabling support of experimental jaeger span export metrics.
• DEPRECATION: the opentelemetry-exporter-jaeger-proto module containing jaeger proto definitions and corresponding generated classes is deprecated for removal in next major version.
• OTLP gRPC exporters support overriding :authority via OtlpGrpc*ExporterBuilder#addHeader("host", "my-authority-override").

SDK Extensions

• BREAKING: Move ConfigureableMetricExporterProvider from opentelemetry-sdk-extension-autoconfigure to stable opentelemetry-sdk-extension-autoconfigure-spi.
• Autoconfigure now supports multiple values for otel.metrics.exporter.
• Autoconfigure now supports general attribute limits, applicable to span attributes, span event attributes, span link attributes, and log attributes.
• Autoconfigure now supports an experimental option to disable the SDK. If otel.experimental.sdk.enabled=true, AutoConfiguredOpenTelemetrySdk#getOpenTelemetrySdk() returns a minimal (but not noop) OpenTelemetrySdk. The same minimal instance is set to GlobalOpenTelemetry.
• New "get or default" methods have been added to ConfigProperties. E.g. ConfigProperties#getString("otel.metrics.exporter", "otlp") fetches the value for the property otel.metrics.exporter and returns otlp if it is not set.
• Fix bug in ContainerResource provider that caused it to throw an exception in some instances when containerd is used.

Micrometer shim

• Cache descriptions such that metrics with the same name use the first seen description.

🙇 Thank you

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

@anuraaga
@breedx-splk
@chenjazz
@cyrille-leclerc
@donce
@Donnerbart
@evantorrie
@jack-berg
@jkwatson
@jonahaapala
@jsuereth
@kubawach
@laurit
@marcalff
@mateuszrzeszutek
@nicklocaso
@Oberon00
@opentelemetry-java-bot
@pkgonan
@rupinder10
@trask
@wallezhang