open-telemetry/opentelemetry-java v1.5.0

Version 1.5.0

on GitHub

API

• The io.opentelemetry.context.ContextStorage interface now allows providing a root Context.

SDK

• The io.opentelemetry.sdk.trace.samplers.SamplingResult class has been enhanced with new factory methods for the static result values.
• The io.opentelemetry.exporter.otlp.trace.OtlpGrpcSpanExporter now supports setting custom TLS certificates.
• The io.opentelemetry.sdk.trace.ReadableSpan interface now exposes the parent SpanContext directly.
• The io.opentelemetry.sdk.resources.Resource now exposes a getAttribute(AttributeKey) method to directly retrieve attributes.
• A new opentelemetry-exporter-otlp-http-trace module is now available to support OTLP over HTTP exports.

SDK Extensions

• The opentelemetry-sdk-extension-resources module now provides a new ContainerResource that auto-detects docker container Resource attributes.
• The Jaeger Remote Sampler in the opentelemetry-sdk-extension-jaeger-remote-sampler module is now java.io.Closeable.

Testing

• The SDK testing module (opentelemetry-sdk-testing) has been enhanced with additional assertions for Spans and Attributes.

Auto-configuration (alpha)

• BREAKING CHANGE: io.opentelemetry.sdk.autoconfigure.ConfigProperties in the opentelemetry-sdk-extension-autoconfigure is now an interface
  and io.opentelemetry.sdk.autoconfigure.OpenTelemetrySdkAutoConfiguration.initiatize() now accepts an optional ConfigProperties
  instance to add properties to the standard auto-detected ones.
• BREAKING CHANGE: OpenTelemetrySdkAutoConfiguration.getResource() has been removed in favor of using the new OpenTelemetryResourceAutoConfiguration class.
• The opentelemetry-sdk-extension-autoconfigure module now exposes a new OpenTelemetryResourceAutoConfiguration
  class specifically for acquiring autoconfigured Resource instances.
• The opentelemetry-sdk-extension-autoconfigure module now provides an option to not set the GlobalOpenTelemetry instance when auto-configuring.
• The opentelemetry-sdk-extension-autoconfigure module now has support for signal-specific timeout, header and TLS certificate configuration.
• A new SPI option is available for configuring a metrics exporter. See io.opentelemetry.sdk.autoconfigure.spi.ConfigurableMetricExporterProvider for details.
• A new OTEL_TRACES_SAMPLER/otel.traces.sampler option is available: jaeger_remote.
  • It can be configured using the OTEL_TRACES_SAMPLER_ARG/otel.traces.sampler.arg, which is parsed as a comma-separated map.
    • For example -Dotel.traces.sampler=jaeger_remote -Dotel.traces.sampler.arg=endpoint=192.168.1.5:14250,pollingInterval=5000,initialSamplingRate=0.01

Semantic Conventions (alpha)

• The SemanticAttributes and ResourceAttributes classes have been updated to match the semantic conventions
  as of specification release 1.5.0.

Metrics (alpha)

• BREAKING CHANGE: The Metrics API has been completely re-written to match the newly specified API.
  Please reach out on CNCF slack in the #otel-java channel,
  or in a github discussion if you need assistance with converting to the new API.
• A new opentelemetry-exporter-otlp-http-metrics module is now available to support OTLP over HTTP exports.