v1.55.1

The 1.55.0 release failed. There were no artifacts published for it.

API Changes

• services: Rename MetricRecorder.setQps/clearQps to setQpsMetric/clearQpsMetric (#10031)

Behavior Changes

• gcp-observability: Remove monitored resource detection for logging (#10020). The cloud libraries will fill in these details instead
• protoc-gen-grpc-java: binaries for Linux ARM and PPC are now built using Ubuntu 18.04. They will no longer work on Ubuntu 16.04 and Debian 9

New Features

• api: Stabilize the frequently used compression APIs (#9942): CallOptions.withCompression, CallOptions.getCompressor, AbstractStub.withCompression, ServerCall.setCompression, ServerCall.setMessageCompression
• api: Stabilize Detachable and HasByteBuffer
• gcp-observability: Stabilize GcpObservability (#10024). The GcpObservability API provides a simple way to export logging, tracing, and metrics to Google Cloud Operations. See the Google Cloud blog post.
• census: Add new tracer annotation to indicate the time when name resolution completed for those RPCs that experienced name resolution delay, or the time when picking subchannel completed for those RPCs that experienced picking subchannel delay. (#10014, #10044)
• protoc-gen-grpc-java: binary for s390x is now published (#9455). The glibc version used is available in Ubuntu 20.04, Debian 11, and CentOS 9 and later
• authz: Added FileWatcherAuthorizationServerInterceptor (#9775)
• services: Added OrcaMetricReportingServerInterceptor.create(MetricRecorder) which adds common metrics per-RPC (#9902)
• android: Add UdsChannelBuilder for using LocalSocket an Android (#8418)
• alts: Observe the GRPC_ALTS_MAX_CONCURRENT_HANDSHAKES environment variable user to adjust the max number of concurrent ALTS handshakes (#10016)
• binder: Expose client identity via PeerUid and PeerUids (#9952)
• binder: Add BindServiceFlags.setAllowActivityStarts() for BIND_ALLOW_ACTIVITY_STARTS added in Android U (#10008)

Bug Fixes

• core: Fix NPE race during hedging (#10007), fixing a Netty buffer memory leak for cancelled RPCs
• core: Allow transparent retries after a retry attempt and the configured max retries was 1 (#10066)
• okhttp: properly implement OkHttpServerBuilder.maxConnectionAgeGrace() (#9968)
• xds: Enable federation support. See gRFC A47
• xds: Enable Weighted Round Robin LB policy support. See gRFC A58
• xds: Avoid ClassCastException if the control plane changes the top-level policy (#10091). This is expected to be unlikely, but is possible
• xds: Fix java.util.NoSuchElementException: SecurityProtocolNegotiators$ClientSdsHandler#0 (#10118). This error did not cause any problems, other than unnecessary logging
• xds: Avoid using the default locale for case insensitive path matching (#10148)
• googleapis: Enable ignore_resource_deletion for google-c2p: resolver’s default xds bootstrap (#10121)
• rls: Refresh name resolution on rejected addresses (#10032)

New Examples

• Keepalive (#9956)
• Cancellation (#9962)
• Deadline (#9958)
• Using waitForReady (#9960)
• Client and Server sharing (#9969)
• Reflection (#9955)
• Doing debug (#9957)
• Health service (#9991)
• Error details (#9997)
• Custom load balancing (#9951)
• gRPC-level reverse proxy (#10059)

Dependencies

• protobuf-java and protobuf-java-util upgraded to 3.22.3 (#10045)

Acknowledgements

• @carl-mastrangelo
• @haubenr
• @jpd236
• @kenk42292

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