●Change8

Migrating to Linkerd edge-25.10.3

Version edge-25.10.3 introduces 1 breaking change. This guide details how to update your code.

Released: 10/13/2025

1
Breaking Changes
1
Migration Steps
4
Affected Symbols

⚠️ Check Your Code

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

ip_port_subscribersworkload_subscriberslinkerd.io/proxy-root-parentlinkerd.io/proxy-root-parent-kind

Breaking Changes

●Issue #1

The metric `ip_port_subscribers` has been removed and replaced by the lower-cardinality metric `workload_subscribers`.

Migration Steps

  1. 1
    If you rely on the `ip_port_subscribers` metric, update monitoring configurations to use `workload_subscribers` instead.

Release Summary

This release introduces configuration for destination controller stream queue capacity and fixes a potential deadlock, but it contains a breaking change removing the `ip_port_subscribers` metric. This version is explicitly marked as NOT RECOMMENDED.

Need More Details?

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

View Full Changelog