OpenTelemetry Kotlin v0.10.0 - SDK errors and API migration

OpenTelemetry Kotlin v0.10.0 arrived on November 5, 2026. Its SDK resilience fixes route failures in user code and the SDK to SdkErrorHandler, addressing crashes and silent failures. GitHub does not mark this version as a prerelease.

The full release notes are on the OpenTelemetry Kotlin v0.10.0 release page.

SDK failures reach the error handler

The error routing fixes cover both application supplied code and the SDK’s own implementation. For applications with custom telemetry code, this changes where those failures go. Check the application’s response to telemetry errors as part of the upgrade.

Gauges and observable metrics instruments

The metrics API adds createLongGauge and createDoubleGauge. A gauge represents a value at a particular moment, such as the current depth of a queue. These constructors give instrumentation code an explicit choice between long and double values for gauges.

Observable instruments also arrive in this release. The additions include long and double counters, long and double up down counters, and a long gauge. Named entry points include createObservableLongCounter, createObservableDoubleUpDownCounter, and createObservableLongGauge.

Custom certificates for OTLP HTTP

The OTLP HTTP exporters support custom certificates and mTLS through configureTls() on JVM and Android. This matters when a telemetry endpoint requires custom certificates or mutual authentication.

The release notes name JVM and Android for this feature. If your project targets either platform, check its exporter TLS configuration during the upgrade.

Upgrade notes

Existing context code needs attention even if you do not use the new metrics instruments. The release changes the term “implicit context” to “current context”, with corresponding API renames.

Apply these changes where your code uses the old names:

  • Replace ImplicitContextStorage with CurrentContextStorage, which also absorbs ScopedCurrentContextStorage.
  • Use CurrentContextStorageMode in place of ImplicitContextStorageMode.
  • Replace the GLOBAL mode with SINGLE_SLOT.
  • Change ContextFactory.implicit() to current().
  • Replace asImplicitContext { } with asCurrentContext { }.

The release also removes SpanFactory and the OpenTelemetry.span factory. The migration notes direct callers to createInvalidSpanContext(), createNonRecordingSpan(), and Context.storeSpanContext() instead. Review each affected call against those replacements when you update your code. These removals require source changes for callers of the old factories.

Where to get it

← All updates