Change8

edge-25.2.2

Breaking Changes
📦 linkerd
1 breaking3 features🐛 2 fixes🔧 2 symbols

Summary

This release changes the default tracing protocol to OpenTelemetry and includes fixes for policy controller lease handling and deterministic ordering of Server resources. Sites requiring IPv6 should avoid this version.

⚠️ Breaking Changes

  • The default tracing protocol has changed from OpenCensus to OpenTelemetry. If you rely on OpenCensus tracing, you must explicitly configure it, as it is no longer the default.

Migration Steps

  1. If you require IPv6 functionality, use version edge-25.4.1 or later instead of this release due to a known bug affecting IPv6.
  2. If you rely on OpenCensus for tracing, you must explicitly configure it, as OpenTelemetry is now the default.

✨ New Features

  • Enabled additional runtime metrics around Kubernetes watches.
  • Policy controller now retries errors during lease handling.
  • Converted opaque ports to application protocol in proto-detect.

🐛 Bug Fixes

  • Policy controller now retries lease creation errors.
  • Server resources are now ordered deterministically by creation time and name in case of overlap.

🔧 Affected Symbols

ServerRoute