●Change8

Migrating to Linkerd edge-25.10.2

Version edge-25.10.2 introduces 2 breaking changes. This guide details how to update your code.

Released: 10/9/2025

2
Breaking Changes
2
Migration Steps
4
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

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

Breaking Changes

●Issue #1

Support for the OpenCensus trace protocol has been dropped. Users relying on this protocol for tracing must migrate to OpenTelemetry.

●Issue #2

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

Release Summary

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

Need More Details?

View the full release notes and all changes for Linkerd edge-25.10.2.

View Full Changelog