v1.54.1

Bug Fixes

• core: Fix NPE race during hedging (#10046), fixing a Netty buffer memory leak for cancelled RPCs

Behavior Changes

• gcp-observability: Remove monitored resource detection for logging (#10026). The cloud libraries will fill in these details instead

API stabilizations

• Stabilize GcpObservability (#10027)
  • The GcpObservability API provides users with a simple way to export logging, tracing, and metrics to Google Cloud Operations. For more information, please see this blog post.

v1.50.3

Bug Fixes

• core: Free unused MessageProducer in RetriableStream (#9853), fixing a Netty buffer memory leak for cancelled RPCs

v1.54.0

New Features

• xds: Add weightedRoundRobin LB policy. The WRR policy allows picking the subchannel by weight based on the metrics feedback from the backend using ORCA API. See gRFC A58: Weighted Round Robin LB Policy. (#9873)
• census: Add per call latency metric which is latency across all attempts (#9906)
• Generated code now has an interface named AsyncService that the <service-name>ImplBase class implements. This allows you to provide your own base class when used with the static <service-name>Grpc.bindService(AsyncService) method(#9688).

Examples

• Add examples for gcp observability (#9967)

Bugfixes

• rls:Fix throttling in route lookup where success and error metrics had been inverted (b/262779100) (#9874)
• protobuf: update external javadoc link (#9890)
• core: fix outlier detection default ejection time (#9889)
• xds: deletion only to watchers of same control plane (#9896)
• api: Target scheme is now properly case insensitive (#9899). NameResolverProviders, however, are expected to return the scheme used for registration in lower-case
• api: ForwardingServerCall now forwards getMethodDescriptor(). Previously only SimpleForwardingServerCall forwarded the method

Behavior Changes

• xds:Allow a cluster’s sum of weights to exceed the maximum signed integer up to a limit of max unsigned integer (#9864)
• grpclb: no SRV lookup for "metadata.google.internal."

Improvements

• xds, orca: Allow removing OobLoadReportListener from a subchannel in OrcaOobUil. (#9881)
• services: ORCA API change to allow recording QPS in MetricRecorder and CallMetricRecorder. (#9866)
• Move name resolution retry from managed channel to name resolver (take #2) (#9812)
• Rename AbstractXdsClient to ControlPlaneClient (#9934)
• all: fix build with errorprone 2.18 (#9886)
• build: allow Java 11+ to use modern error prone
• errorprone: enable UnnecessaryAnonymousClass (#9927)
• core: add logger to OutlierDetectionLoadBalancer (#9880)
• census: add trace annotation to report received message sizes (#9944)
• gcp-observability: emit latency and payload size metrics by default when monitoring is enabled (#9893)
• gcp-observability: add trace information like TraceId and SpanId in logs for log correlation when both logging and traces are enabled (#9963)
• gcp-observability: close() will take longer, to ensure metrics and traces are flushed (#9972)
• gcp-observability: update status code type in logs to Google RPC code instead of an integer (#9959)
• gcp-observability: retain default opencensus-task identifier even when custom labels are specified in the configuration (#9982)
• Build Improvements (#9855)
• Fixes MethodDescriptor java documentation (#9860)
• api: forward getSecurityLevel on PartialForwardingServerCall (#9912)
• Updating ServerInterceptors.java to support different marshallers for Request and Response messages. (#9877)

API stabilizations

• Stabilize method ServerBuilder.intercept which had previously been marked experimental. (#9894)
• api:stabilize offloadExecutor usage in ManagedChannelBuilder and NameResolver. (#9931)

Dependencies

• netty:Upgrade Netty from 4.1.79 to 4.1.87, tcnative from 2.0.54 to 2.0.56 (#9784)
• gcp-observability: Transitive gRPC components now have the same gRPC version
• gcp-observability : Google cloud logging updated to 3.14.5

Acknowledgements

@benjaminp
@s-matyukevich
@Faqa
@antechrestos
@carl-mastrangelo
@ioanbsu

v1.53.0

New Features

• googleapis: Allow user set c2p bootstrap config (#9856)
• xds: Add contain and stringMatcher in RouteConfiguration (#9845)
• core: Add grpc-previous-rpc-attempts to the initial response metadata (#9686)
• servlet: Implement gRPC server as a Servlet (#8596)
• authz: Implement static authorization server interceptor (#8934)

Examples

• servlet: Add servlet example (#8596)

Bug Fixes

• xds: Update xds error handling logic. Specifically:
  • When the ads stream is closed only send errors to subscribers that haven't yet gotten results
  • Timers to detect missing resources don’t start until the adsStream is ready (#9745)
  • Call subscriber onError callback when xds client fails to connect to server (#9827)
• core: Delay retriable stream master listener close until all sub streams are closed. This fixes the call executor lifecycle and prevents potential RejectedExecutionException. (#9754)
• core: Free unused MessageProducer in RetriableStream (#9853), fixing a Netty buffer memory leak for cancelled RPCs
• api: Fail with NullPointerException when a Metadata.Marshaller returns null bytes (#9781). This would previously cause a NullPointerException later during the RPC. Now the return value of the Marshaller is checked immediately, to help find the broken Marshaller

Behavior Changes

• xds: Disallow duplicate addresses in the RingHashLB. (#9776)
• xds: EDS weight sums are allowed up to max unsigned int (was max signed int) (#9765)
• xds: Drop xds v2 support (#9760)

Dependencies

• JUnit upgraded to 4.13.2
• bazel: Dropped support for Bazel 4. We track the two most recent major versions of Bazel, Bazel 5 and 6. Bazel 4 may still work, but we are no longer testing it
• bazel: Include Tomcat annotations dependency for @Generated as used by autovalue (#9762). Necessary for building xds and rls on Java 9+
• bazel: Export deps from Maven Central-specific stand-in targets (#9780). Some Maven Central artifacts are a combination of multiple Bazel targets, like grpc-core is composed of //core:inprocess, //core:internal, //core:util, //api. There is a “//core:core_maven” target used by maven_install that uses the other targets. Previously the target used runtime_deps to discourage their use by Bazel users, but that could cause compilation failures from lack of hjars. These targets now use exports

Acknowledgement

@cpovirk
@niloc132
@stephenh
@olderwei
@pandaapo
@Panxuefeng

v1.45.4

Bug Fixes

• core: Free unused MessageProducer in RetriableStream (#9853), fixing a memory leak for cancelled RPCs

v1.51.3

Bug Fixes

• xds: Fix an internal bug in xds resource subscription that might cause xds stream not accepting response update for that resource type entirely. (#9811)

v1.52.1

Bug Fixes

• xds: Fix an internal bug in xds resource subscription that might cause xds stream not accepting response update for that resource type entirely. (#9810)

v1.45.3

Bug Fixes

• core: Fix retry causing memory leak for canceled RPCs. (#9360)

v1.52.0

gRPC Java 1.52.0 Release Notes

grpc-xds starting with 1.51.0 had a regression where resources might stop receiving updates. The trigger could happen hours or days after the binary had started. xDS users should avoid this release and use 1.50.x until patch releases with the fix are available. #9809

API Changes

• Fix CallOptions to be properly @Immutable (#9689)
• binder: Promote out of experimental status (#9669). Much of the API is now stable

New Features

• xds: Support localities in multiple priorities (#9683)
• xds: Log xDS node ID with verbosity INFO when environment variable GRPC_LOG_XDS_NODE_ID=true (#9731)

Examples

• Add examples for name resolver and load balancer (#9700)
• Swap to ChannelCredentials/ServerCredentials API, as it is preferred

Bug Fixes

• xds:Fix ConcurrentModificationException in PriorityLoadBalancer (#9728)
• ManagedChannelImpl.SubchannelImpl fix args check to avoid NPE (#9651)
• okhttp: Add missing server support for TLS ClientAuth (#9711)
• binder: Ensure the security interceptor is always closest to the actual transport (#9716)
• bazel: Include @generated dep for autovalue. This fixes builds of xds and rls using Java 9+
• xds: Nack xds response when weighted cluster total weight sums zero (#9738)
• core: Fix a bug about a retriable stream lifecycle. It stops using the call executor resource in a retriable stream when the client call is closed, thus preventing potential channel panics. (#9626)

Behavior Changes

• binder: Set default idle timeout to 60 seconds, and enable "strict lifecycle management". (#9486)
• xds: Limit ring hash max size to 4K instead of 8M (#9709). RingHashOptions.setRingSizeCap() can increase the limit
• binder: Set default idle timeout to 60 seconds, and add BinderChannelBuilder.strictLifecycleManagement() which disables idle timeout and prevents it from being changed (#9486). Disabling idle timeout can be useful to find bugs in applications that fail to promptly shut down the channel and are particularly sensitive to keeping Binder instances alive.
• bazel: Replace ctx.host_configuration.host_path_separator with ctx.configuration.host_path_separator (#9742). This changes no behavior today, but improves future compatibility with newer versions of Bazel
• xds: Refactor internal logics about LDS and CDS resource handling. It may cause minor log line changes about corresponding RDS and EDS subscriber event notification, but it should not change xds name resolution and LB behavior. (#9724)

Dependencies

Acknowledgement

@RapperCL
@Smityz
@pandaapo

v1.51.1

grpc-xds starting with 1.51.0 had a regression where resources might stop receiving updates. The trigger could happen hours or days after the binary had started. xDS users should avoid this release and use 1.50.x until patch releases with the fix are available. #9809

Bug Fixes

• xds: Fix ConcurrentModificationException in PriorityLoadBalancer. (#9744)