Release Notes

Red Hat OpenShift Service Mesh 3.4

OpenShift Service Mesh release notes

Red Hat OpenShift Documentation Team

Abstract

This documentation provides information about each Red Hat OpenShift Service Mesh release.

Chapter 1. OpenShift Service Mesh release notes

Review new features, compatibility updates, fixed issues, and known issues for Red Hat OpenShift Service Mesh to stay informed about changes across different product versions.

1.1. Red Hat OpenShift Service Mesh version 3.4 new features and enhancements

This release makes Red Hat OpenShift Service Mesh 3.4 generally available, adds new features, addresses Common Vulnerabilities and Exposures (CVEs), and is supported on OpenShift Container Platform 4.20 and later versions.

For a list of supported component versions and support features, see Service Mesh feature support tables.

Service Mesh compatibility with Red Hat Enterprise Linux 10

Red Hat OpenShift Service Mesh 3.4 introduces native nftables support for traffic management in both sidecar and ambient modes. This support is required for clusters running on Red Hat Enterprise Linux (RHEL) 10 or Red Hat Enterprise Linux CoreOS (RHCOS) 10, where the legacy iptables framework has been removed.

OpenShift Service Mesh relies on packet filtering rules to redirect network traffic to the proxy. Because RHEL 10 systems use nftables exclusively, you must enable native nftables support to ensure that the service mesh can initialize and manage network traffic correctly on these hosts.

To enable native nftables support, set the values.global.nativeNftables parameter to true when you install or update the Service Mesh control plane.

If you use ambient mode, you might need to reboot nodes after enabling nftables. For guidance, see Nftables migration in ambient mode.

Content from redhat.atlassian.net is not included.OSSM-6748

OpenShift Service Mesh supports FIPS 140-3 compliance

On FIPS-enabled OpenShift Container Platform clusters, Service Mesh supports FIPS 140-3 for both sidecar and ambient modes, ensuring continued compliance after the FIPS 140-2 standard expires on September 21, 2026. This release adds TLS 1.3 support for all mesh traffic in addition to the existing TLS 1.2 support, providing stronger encryption for mesh communications. The minimum TLS version remains TLS 1.2.

This content is not included.OSSM-12531

OpenShift Service Mesh supports the coexistence of sidecar and ambient mode workloads

Service Mesh supports running sidecar proxy and ambient mode workloads simultaneously in separate namespaces within the same mesh (with limitations noted in the documentation). This coexistence enables an incremental migration to ambient mode. You can also maintain specific workloads in sidecar mode if they require features that ambient mode does not yet support.

For more information, see Coexistence of ambient and sidecar modes.

Content from redhat.atlassian.net is not included.OSSM-11487

Kiali reduces false warnings in multi-cluster AuthorizationPolicies

In this release, Kiali validates trust domains in AuthorizationPolicies by checking the trustDomainAliases field in the Istio MeshConfig. This enhanced validation provides more accurate feedback when working with federated multi-cluster meshes.

This enhancement introduces two validation message changes:

  • New validation message KIA0108 - Unable to verify principal, trust domain is not known to Kiali appears when a trust domain is genuinely unknown.
  • Existing validation KIA0107 - Service Account for this principal found on a remote cluster was downgraded from Warning to Informational, eliminating false warnings for working multi-cluster configurations.

    Content from redhat.atlassian.net is not included.OSSM-13864

Kiali supports stricter namespace access control for multi-tenancy environments

This release introduces a new configuration attribute, KialiFeatureFlags.Authz.RequireNamespaceGet, to improve multi-tenancy support in Kiali. By default, when Kiali runs in cluster-wide mode, it treats users with List permission to a namespace as also having Get permission, and displays all List namespaces in the Namespace dropdown. In environments where List and Get permissions differ, this can expose namespaces that users should not access. When you set KialiFeatureFlags.Authz.RequireNamespaceGet=true, Kiali limits the Namespace dropdown to only those namespaces for which users have Get permission, ensuring stricter access control. The default value is false, so existing deployments are not affected.

This content is not included.OSSM-13288

Kiali Overview page redesigned for performance and multi-cluster awareness

This release replaces the Kiali Overview page with a compact, multi-cluster-aware dashboard that provides a high-level view of mesh health at a glance. The redesigned page uses pre-computed and cached data to ensure fast rendering independent of mesh size.

The Overview page displays summary cards for:

  • Cluster health
  • Istio configuration validation
  • Control plane status
  • Namespace mesh participation (Ambient, Sidecar, or Out of mesh)
  • An interactive application health donut chart
  • Workload insights such as missing sidecars, high error rates, or failing probes

    This release also adds a dedicated Namespaces page.

    Content from redhat.atlassian.net is not included.OSSM-11833

Kiali Namespace detail page provides a comprehensive namespace view

Clicking a namespace in the Kiali Namespaces list opens a detail page with a split-panel layout showing namespace metadata, health, and traffic.

The left panel displays:

  • Namespace attributes such as cluster, revision, status, mesh mode, and mTLS status
  • Links to applications, services, workloads, and Istio configuration with health breakdowns
  • Editable labels and annotations with click-to-filter navigation

    The right panel displays a namespace-scoped traffic minigraph.

    Additionally, an Actions menu lists options such as traffic policies. The page also supports breadcrumb navigation, view-only mode, and kiosk mode.

    Content from redhat.atlassian.net is not included.OSSM-13271

OpenShift Service Mesh supports Gateway API 1.5.1, in which the following features are now stable
  • ListenerSet for simplified gateway listener configuration
  • TLSRoute for routing encrypted non-HTTP traffic
  • HTTPRoute CORS configuration for cross-origin API access
  • Client certificate validation for mutual TLS authentication at the gateway
  • Certificate selection for multi-domain gateway TLS configurations
  • ReferenceGrant for cross-namespace access delegation

    Additionally, for teams serving AI/ML models with Red Hat OpenShift, this release supports Gateway API Inference Extension 1.4.0. This extension provides intelligent routing and load balancing optimized for GPU-accelerated inference workloads.

    Content from redhat.atlassian.net is not included.OSSM-11956

Performance and security improvements from upstream Istio and the Sail Operator

As a distribution based on upstream Istio and the Sail Operator, OpenShift Service Mesh inherits enhancements from these projects. Review the following upstream changes in this release to determine whether your deployment needs configuration updates:

  • Circuit breaker metrics tracking is disabled by default to improve proxy memory usage. Before this update, this tracking was enabled by default. To reenable it, set the environment variable DISABLE_TRACK_REMAINING_CB_METRICS=false in istiod. This affects the track_remaining setting in Envoy’s circuit breaker configuration.
  • Debug endpoint authorization is now enabled by default. This change affects tools that access debug endpoints from non-system namespaces. For example, this change might affect Kiali if you deploy it in a different namespace from the Istio control plane. This release restricts non-system namespaces to specific debug endpoints only, with access limited to config_dump, ndsz, and edsz for same-namespace proxies. To restore the previous behavior, set the environment variable ENABLE_DEBUG_ENDPOINT_AUTH=false in istiod.
  • HTTP compression for Envoy metrics is now enabled by default. The sidecar.istio.io/statsCompression annotation was removed. This release replaces it with a new statsCompression option in proxyConfig that defaults to true. Envoy now compresses metrics using brotli, gzip, or zstd based on the Accept-Encoding header. You can override per-pod compression, if needed, by using the proxy.istio.io/config annotation.
  • DNS proxying is now enabled by default for workloads in an ambient mesh. This ensures that Istio correctly resolves and tracks ServiceEntry destinations. DNS traffic from already-running workloads is not automatically redirected through ztunnel when you enable or upgrade ambient mode. To enable DNS proxying for these existing pods, manually restart them. Alternatively, configure Istio CNI with --set cni.ambient.reconcileIptablesOnStartup=true to reconcile the required iptables rules automatically. This setting is enabled by default in Istio 1.29 and later versions. (Note that DNS capture is still not enabled by default in sidecar mode, as ServiceEntry resources are correctly handled at the sidecar proxy with default settings.)

1.2. Red Hat OpenShift Service Mesh version 3.4 Technology Preview features

This release includes some features that are currently in Technology Preview. These experimental features are not intended for production use.

For more information about the support scope of Red Hat Technology Preview features, see Technology Preview Features Support Scope.

SPIRE integration enables zero-trust workload identity

Red Hat OpenShift Service Mesh integrates with the SPIFFE Runtime Environment (SPIRE) to provide stronger cryptographically verifiable workload identities. SPIFFE (Secure Production Identity Framework for Everyone) is an open standard for establishing trust between workloads in distributed systems.

While OpenShift Service Mesh already supports workload identity creation and management through the SPIFFE protocol, SPIRE extends this with:

  • Deep workload attestation - Verifies workload identity based on configurable criteria backed by hardware or cloud environment verification
  • Trust domain federation - Enables workloads from different trust domains to authenticate and communicate securely

    SPIRE is supported as part of the OpenShift Zero Trust Workload Identity Manager. Integration with OpenShift Service Mesh is a Technology Preview feature.

    For more information, see SPIRE integration for mesh security.

    Content from redhat.atlassian.net is not included.OSSM-9387

Multi-cluster support in Istio ambient mode

Support for ambient mode in multi-primary multi-network topologies continues to be a Technology Preview feature.

For more information, see Installing a multi-primary multi-network mesh in ambient mode.

Content from redhat.atlassian.net is not included.OSSM-12578

Multi-network ingress gateway support in ambient mode

This release adds cross-cluster networking for ingress gateways in multi-network ambient deployments. You can configure two environment variables in the Istio resource under spec.values.pilot.env:

  • AMBIENT_ENABLE_MULTI_NETWORK_INGRESS - Allows ingress gateways to route traffic to remote clusters. This enables load balancing across local and remote pods and ensures requests are served even when local pods are unavailable.
  • AMBIENT_ENABLE_BAGGAGE - Ensures service mesh telemetry metrics include accurate source and destination labels for cross-network traffic.

    Both variables support ambient mode in multi-primary multi-network topologies and are therefore Technology Preview features.

    Content from redhat.atlassian.net is not included.OSSM-13455

1.3. Red Hat OpenShift Service Mesh version 3.4 fixed issues

This release addresses the following fixed issues:

Istiod containers include termination message policy for easier debugging

Before this update, istiod containers did not specify a terminationMessagePolicy. As a consequence, when an istiod container failed, you had to retrieve log information from log storage systems for troubleshooting. This release sets the terminationMessagePolicy to FallbackToLogsOnError. As a result, when a container fails, the last chunk of log output is captured in the pod status and accessible with oc describe pod, making initial debugging easier without requiring log storage access.

This content is not included.OSSM-13701

Kiali correctly validates Istio configuration for multiple meshes in a cluster

Before this update, when multiple Istio control planes ran in the same OpenShift cluster, Kiali used only one control plane’s MeshConfig properties to validate all Istio configurations. As a consequence, Kiali reported incorrect KIA1101 (VirtualService) and KIA0203 (DestinationRule) validation errors. This release validates Istio resources within the context of each control plane’s managed namespace, using each control plane’s own MeshConfig properties. As a result, resources belonging to one mesh are validated independently, and false validation errors no longer appear.

Content from redhat.atlassian.net is not included.OSSM-12562

1.4. Additional resources

Chapter 2. Service Mesh component versions

Knowing which versions of Istio, Kiali, Envoy, and other components are included in your release of OpenShift Service Mesh helps you plan upgrades and troubleshoot compatibility issues.

2.1. Component version tables

For OpenShift Service Mesh 3.4 and each maintenance release, a table lists the corresponding component versions.

2.1.1. OpenShift Service Mesh 3.4 component versions

ComponentSupported versions

OpenShift Service Mesh 3 Operator

3.4.0

OpenShift Service Mesh Istio control plane resource

1.30.1

OpenShift Container Platform

4.20 and later

Envoy proxy

1.38.3

IstioCNI resource

1.30.1

Ztunnel resource

1.30.1

Kiali Operator

2.27

Kiali server

2.27

2.2. Additional resources

Chapter 3. Service Mesh feature support tables

Feature support tables help you determine which OpenShift Service Mesh 3.4 features are generally available, in Technology Preview, in Developer Preview, or not available.

3.1. Support level definitions

For Red Hat OpenShift Service Mesh 3.4, features that are Generally Available (GA) are fully supported and are suitable for production use.

Technology Preview (TP) features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and give feedback during the development process. See the Technology Preview scope of support on the Red Hat Customer Portal for more information about Technology Preview features.

Developer Preview (DP) features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to upcoming product features in advance of their possible inclusion in a Red Hat product offering, enabling customers to test functionality and give feedback during the development process. These features might not have any documentation, are subject to change or removal at any time, and testing is limited. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA.

Not available (NA) features might not be available with Red Hat OpenShift Service Mesh 3.4.

3.2. Sail Operator APIs

The Sail Operator provides the following custom resource definitions (CRDs) for managing Istio components in OpenShift Service Mesh.

FeatureStatus

Istio

GA

IstioRevision

GA

IstioCNI

GA

IstioRevisionTag

GA

ZTunnel

GA

3.3. Istio deployment and lifecycle

Istio deployment and lifecycle features include installation, upgrades, multicluster configurations, and networking capabilities for OpenShift Service Mesh 3.4.

FeatureStatus

Installation with the Red Hat OpenShift Service Mesh Operator

GA

Istio sidecar mode data plane

GA

InPlace and RevisionBased control plane upgrades with the Red Hat OpenShift Service Mesh Operator

GA

The Istio multicluster mesh deployment models

GA

The Istio external control plane deployment models

GA

Multiple control planes on a single OpenShift Container Platform cluster

GA

IstioCNI plugin

GA

Istio configuration scoping: Sidecar API, exportTo and discovery selectors

GA

IPv6 support

GA

Dual stack IPv4/IPv6

GA [4]

Virtual machine (non-OpenShift) workload integration

DP

Istioctl for select commands

GA [1]

Helm or Istioctl installation

NA [2]

ProxyConfig

GA [3]

Native nftables support

GA [5]

Agentgateway

NA

  1. For more information, see "Support for Istioctl".
  2. Installation is only supported by using the OpenShift Service Mesh Operator, which uses the Istio Helm chart values for managing configuration.
  3. The ProxyConfig API is supported with the exception of the image field, which is not supported.
  4. Dual-Stack IPv4/IPv6 is supported on x86 environments only. On non-x86 environments, this feature remains a Technology Preview.
  5. To deploy OpenShift Service Mesh on nodes running Red Hat Enterprise Linux (RHEL) 10 or Red Hat Enterprise Linux CoreOS (RHCOS) 10, you must enable native nftables support. In the Istio resource, set the spec.values.global.nativeNftables parameter to true.

3.4. Istio traffic management

Traffic management features control how requests flow between services in your mesh, including routing, load balancing, and resilience capabilities.

FeatureStatus

Protocols: HTTP1.1/HTTP2/HTTPS/gRPC/TCP/TLS

GA

Traffic control: label/content based routing, traffic shifting

GA

VirtualService, DestinationRule and ServiceEntry

GA

Resilience features: timeouts, retries, connection pools, outlier detection

GA

Gateway: ingress, egress for all supported protocols

GA

Gateway injection

GA

TLS termination and SNI support in gateways

GA

Locality load balancing

GA

DNS proxying

GA

Kubernetes Multi-Cluster Service (MCS) discovery

DP

3.5. Kubernetes Gateway APIs

Kubernetes Gateway APIs provide standard resources for configuring ingress gateways, mesh traffic, and gateway behavior in OpenShift Service Mesh 3.4.

FeatureStatus

Kubernetes Gateway APIs for ingress (Gateway parentRef)

GA

Kubernetes Gateway APIs for mesh (Service parentRef)

GA

Kubernetes Gateway API custom resource definitions (CRDs)

GA [1]

Kubernetes Gateway API manual deployment

NA

Gateway network topology configuration

DP

Gateway inference extensions

TP

  1. The use of Kubernetes Gateway API requires custom resource definitions (CRDs). The CRDs are present by default and generally available on OpenShift Container Platform 4.19 and later releases. OpenShift Container Platform 4.18 and earlier releases do not include or provide support for these CRDs.

3.6. Security features

Security features provide encryption, authentication, and authorization capabilities for securing service-to-service communication and protecting workloads in your mesh.

3.6.1. Encryption and certificate management

FeatureStatus

Service-to-service mutual TLS encryption

GA

Identity and certificate management for workloads

GA

Peer authentication

GA

Certificate management for ingress gateway

GA

Pluggable key/certificate support for Istio certificate authority (CA)

GA

Cert-Manager integration with the cert-manager Operator for Red Hat OpenShift

GA

Kubernetes ClusterTrustBundles

DP

SPIFFE Runtime Environment (SPIRE) integration through the Zero Trust Workload Identity Manager

TP

3.6.2. Authorization and policy enforcement

FeatureStatus

AuthorizationPolicy

GA

External authorization

GA

End user (JWT) authentication

GA

JWT claim based routing

GA

Authorization dry run

TP

Copy JWT claims to HTTP Headers

DP

RequestAuthentication

GA

3.7. Observability features

OpenShift Service Mesh 3.4 provides end-to-end support for observability, including logs, metrics, and distributed tracing with Red Hat OpenShift Observability and the Kiali Operator provided by Red Hat.

Integrations with other community projects (including community Prometheus) and third-party solutions can be configurable through Istio or Observability operators, but those solutions are not supported by Red Hat.

FeatureStatus

Integration with Red Hat OpenShift Observability - user workload monitoring

GA

Red Hat OpenShift distributed tracing platform (Tempo)

GA

Red Hat OpenShift distributed tracing data collection Operator

GA

Trace sampling configuration

GA

Istio Telemetry API for configuring logs, metrics, and traces

GA

Istio preconfigured Grafana dashboards

DP [1]

Request classification

NA

  1. While Grafana is not included as part of OpenShift Service Mesh, the preconfigured dashboards for Grafana maintained by the Istio community can be use with OpenShift Service Mesh under a Developer Preview scope. These are best used as a starting point for building your own dashboards.

3.8. Consoles and dashboards

Console and dashboard tools provide visualization and management capabilities for monitoring and configuring your service mesh.

FeatureStatus

Kiali Operator provided by Red Hat

GA

Kiali Server

GA

OpenShift Service Mesh Console (OSSMC) plugin

GA

3.9. Extensibility features

Extensibility features allow you to customize and extend Istio proxy behavior.

FeatureStatus

WebAssembly extension

GA [1]

EnvoyFilter API

DP [2]

TrafficExtension API

TP [3]

  1. The WasmPlugin API for extending Istio with WebAssembly extensions is supported, but support is not provided for any Web Assembly extension modules unless explicitly documented.
  2. The EnvoyFilter API is available for use with Red Hat OpenShift Service Mesh, but is not supported, except where explicitly documented. Due to tight coupling with the underlying Envoy APIs, backward compatibility cannot be maintained. Note that EnvoyFilter patches are very sensitive to the format of the Envoy configuration that is generated by Istio. If the configuration generated by Istio changes, it has the potential to break the application of the EnvoyFilter configuration. Any configuration provided through this API should be carefully monitored across Istio proxy version upgrades to ensure that deprecated fields are removed and replaced appropriately. If a support case is raised where an EnvoyFilter configuration is used, Red Hat might request that the issue be reproduced with the EnvoyFilter configuration removed.
  3. Red Hat does not debug or provide other support for plugins and scripts configured through the TrafficExtension API.

3.10. Istio Ambient mode (sidecarless) data plane

Ambient mode features include core ztunnel and waypoint capabilities, traffic management, security, multicluster support, and upgrade strategies.

FeatureStatus

Ztunnel: Core

GA

Waypoint: Core

GA

Waypoint: Gateway API Stable Channel (HTTPRoute, GRPCRoute)

GA

Gateway API Experimental Channel (TLSRoute, TCPRoute)

DP

Waypoint: DestinationRule

GA

Waypoint: VirtualService

TP

Waypoint: Cross-namespace usage

GA

Waypoint: WebAssembly extensibility (WasmPlugin)

DP

AuthorizationPolicy, PeerAuthentication, RequestAuthentication

GA

DNS Proxying

GA

Dual-stack and IPv6 single stack

TP

Mixing sidecar and ambient namespaces within a single mesh

GA

Deploying ambient mode on a cluster with an existing sidecar mesh

GA

Migrating workloads from sidecar mode to ambient mode

GA

Multiple “ambient mode” meshes in a single cluster

NA

Multi-Cluster - Multi-primary topology

TP

Multi-Cluster - Other topologies

NA

Upgrades: InPlace

GA

Upgrades: RevisionBased

NA

Virtual Machine workload integration

NA

† These features are supported with the exception of limitations noted in their respective documentation.

3.11. Additional resources

Legal Notice

Copyright © Red Hat.
Except as otherwise noted below, the text of and illustrations in this documentation are licensed by Red Hat under the Creative Commons Attribution–Share Alike 3.0 Unported license . If you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, the Red Hat logo, JBoss, Hibernate, and RHCE are trademarks or registered trademarks of Red Hat, LLC. or its subsidiaries in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
XFS is a trademark or registered trademark of Hewlett Packard Enterprise Development LP or its subsidiaries in the United States and other countries.
The OpenStack® Word Mark and OpenStack logo are trademarks or registered trademarks of the Linux Foundation, used under license.
All other trademarks are the property of their respective owners.