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
ImplicitContextStoragewithCurrentContextStorage, which also absorbsScopedCurrentContextStorage. - Use
CurrentContextStorageModein place ofImplicitContextStorageMode. - Replace the
GLOBALmode withSINGLE_SLOT. - Change
ContextFactory.implicit()tocurrent(). - Replace
asImplicitContext { }withasCurrentContext { }.
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
- OpenTelemetry Kotlin v0.10.0 release notes
- OpenTelemetry Kotlin repository
- Release tag:
v0.10.0