●Change8

edge-25.10.2

Breaking Changes
📦 linkerd
⚠ 2 breaking✨ 2 features🐛 1 fixes⚡ 1 deprecations🔧 4 symbols

Summary

This release drops support for OpenCensus tracing and promotes native sidecar support to beta, introducing new OpenTelemetry annotation support for tracing customization.

⚠️ Breaking Changes

  • Support for the OpenCensus trace protocol has been dropped. Users relying on this protocol for tracing must migrate to OpenTelemetry.
  • The change adding `linkerd.io/proxy-root-parent` and `linkerd.io/proxy-root-parent-kind` labels to injected pods was reverted in edge-25.10.3 due to unforeseen issues, meaning these labels are not present in this release.

Migration Steps

  1. If you were using the OpenCensus trace protocol, migrate your tracing configuration to use OpenTelemetry.
  2. For new native sidecar configurations, use the beta annotation `config.beta.linkerd.io/proxy-enable-native-sidecar` instead of the deprecated alpha annotation.

✨ New Features

  • Added support for setting OpenTelemetry tracing values via `resource.opentelemetry.io/<label>` annotations on pods.
  • Native sidecar support has been moved to beta, introduced via the `config.beta.linkerd.io/proxy-enable-native-sidecar` annotation.

🐛 Bug Fixes

  • Reverted the removal of 'hotpatch' versioning introduced in a previous commit.

🔧 Affected Symbols

linkerd.io/proxy-root-parentlinkerd.io/proxy-root-parent-kindresource.opentelemetry.io/<label>config.beta.linkerd.io/proxy-enable-native-sidecar

⚡ Deprecations

  • The alpha annotation for enabling native sidecars is deprecated, although it will continue to function for now.