●Change8

Migrating to Linkerd edge-25.2.1

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

Released: 2/12/2025

2
Breaking Changes
1
Migration Steps
3
Affected Symbols

⚠️ Check Your Code

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

inbound HTTP metricsTLS metricslinkerd install

Breaking Changes

●Issue #1

The `hostname` label for inbound HTTP and TLS metrics will always have an empty value.

●Issue #2

The `authority` label has been removed from inbound HTTP metrics.

Migration Steps

  1. 1
    If you rely on the `hostname` label for inbound HTTP or TLS metrics, be aware that it will now be empty. If you rely on the `authority` label, remove usage as it has been removed.

Release Summary

This release significantly enhances OpenTelemetry compatibility, introduces metrics for issuer certificate TTL, and fixes a policy update bug related to HTTPRoutes without specified ports. It also relaxes the requirement for Gateway API CRDs during `linkerd install`.

Need More Details?

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

View Full Changelog