v1.65.0

grpc-netty in this release is compatible with Netty 4.1.111; it fixes the incompatibility that caused data corruption. grpc-netty-shaded is still using Netty 4.1.100.

New Features

• New module grpc-gcp-csm-observability (df8cfe9)

Improvements

• api: Add ClientStreamTracer.inboundHeaders(Metadata) (960012d). This is the same as the existing inboundHeaders(), but is provided the Metadata
• api: Fix various typos in the documentation (#11144) (6ec744f)
• core: When queuing RPCs, don’t request picks from the LB twice (8844cf7). This could be viewed as a small performance optimization, but mainly reduces the amount of race-handling code
• util: Improve AdvancedTlsX509KeyManager’s documentation, verification, and testing. (#11139) (781b4c4) This change shows @ExperimentalApi being removed, but it was re-added in 3c97245 before the release
• examples: Fix broken command in reflection readme (#11131) (c31dbf4)
• binder: Add a connection timeout (#11255) (791f894)

Bug fixes

• core: Exit idle mode when delayed transport is in use (fea577c). This was a long-standing race that could cause RPCs to hang, but was very unlikely to be hit. Avoiding the double-picking (8844cf7) made the race more visible
• netty: Fix Netty composite buffer merging to be compatible with Netty 4.1.111 (#11294) (0fea7dd). The previous behavior easily caused data corruption
• okhttp: Workaround SSLSocket not noticing socket is closed (a28357e). Previously, shutting down when a new connection was being established could result in the server never becoming terminated
• inprocess: Fix listener race if transport is shutdown while starting (e4e7f3a). This issue was unlikely to be hit outside of specialized tests
• services: restore //services:binarylog bazel target (#11292) (d57f271). This fixes a regression introduced in 1.62.2
• binder: Wait for all server transports to terminate before returning the security policy executor to the object pool (#11240) (34ee600)
• binder: Reject further SETUP_TRANSPORT requests post-BinderServer shutdown (#11260) (1670e97)
• bazel: Include missing com_google_protobuf_javalite in MODULE.bazel (#11147) (f995c12)

Thanks to

@hakusai22
@firov
@mateusazis
@Mir3605
@niloc132

v1.63.1

Bug fixes

• netty: Release SendGrpcFrameCommand when stream is missing (#11116) (fb9a108)
• Change defaults to use the older PickFirstLoadBalancer and disable Happy Eyeballs. This disables a performance optimization added in v1.63.0 (#11120) We have had a report that the new implementation can trigger a NullPointerException

v1.64.0

Avoid upgrading your application to Netty 4.1.111, with this version as there is a possible corruption. For Netty 4.1.111 compatibility, it is best to use 1.63.2, 1.64.2, 1.65.1, and later. See #11284 .

API Changes

• compiler: the option jakarta_omit was renamed @generated=omit (#11086) (8a21afc)

New Features

• New API LoadBalancer.getChannelTarget() (4561bb5)
• opentelemetry: Publish new module grpc-opentelemetry (5ba1a55). The feature is still missing documentation and an example. It only supports metrics; tracing and logs will be future enhancements. See gRFC A66
• bazel: Add support for bzlmod (#11046) (d1890c0)
• bazel: Replace usages of the old compatibility maven targets with @maven targets (0064991)
• okhttp: Support serverBuilder.maxConcurrentCallsPerConnection (Fixes #11062). (#11063) (8050723)
• xds: Experimental metrics recording in WRR LB (06df25b, 35a171b, 2897b39), to be exported by grpc-opentelemetry if explicitly enabled in GrpcOpenTelemetry. See gRFC A78
• rls: Experimental metrics recording in RLS LB (a9fb272, a1d1932, 8133318), to be exported by grpc-opentelemetry if explicitly enabled in GrpcOpenTelemetry

Improvements

• examples: support bazel build for retry policy example (58de563)
• netty: Allow deframer errors to close stream with a status code, as long as headers have not yet been sent (e036b1b). This will greatly improve the debuggability of certain server errors in particular cases. Instead of the client seeing “CANCELLED: RST_STREAM closed stream. HTTP/2 error code: CANCEL”, they could see “RESOURCE_EXHAUSTED: gRPC message exceeds maximum size 4194304: 6144592”
• netty: Improve handling of unexpected write queue promise failures (#11016)
• servlet: Avoid unnecessary FINEST hex string conversion by checking log level. Fixes #11031. (f7ee5f3)
• StatusException/StatusRuntimeException hide stack trace in a simpler way (#11064) (e36f099)
• util: Status desc for outlier detection ejection (#11036) (10cb4a3)
• binder: Helper class to allow in process servers to use peer uids in test (#11014) (537dbe8)
• Add load() statements for the Bazel builtin top-level java symbols (#11105) (add8c37)
• Add StatusProto.toStatusException overload to accept Throwable (#11083) (5c9b492)

Bug fixes

• Fix retry race condition that can lead to double decrementing inFlightSubStreams and so miss calling closed (#11026) (bdb6230)
• Change defaults to use the older PickFirstLoadBalancer and disable Happy Eyeballs. This disables a performance optimization added in v1.63. (#11120) We have had a report that the new implementation can trigger a NullPointerException
• core: Transition to CONNECTING immediately when exiting idle (2c5f0c2). Previously the visible state change from channel.getState() was delayed until the name resolver returned results. This had no impact to RPC behavior
• xds: Specify a locale for upper/lower case conversions (e630593)
• rls: Synchronization fixes in CachingRlsLbClient (6e97b18). These races had not been witnessed in practice
• rls: Guarantee backoff will update RLS picker (f9b6e5f). This fixes a regression introduced by 6e97b18 that could hang RPCs instead of using fallback, but fixes a pre-existing bug that could greatly delay RPCs from using fallback.
• rls: Fix time handling in CachingRlsLbClient (da619e2). This could have caused backoff entries to improperly be considered expired
• xds: Properly disable the default endpoint identification algorithm with XdsChannelCredentials (097a46b). The credential does its own verification and the default needs to be disabled for SPIFFE
• netty: Release SendGrpcFrameCommand when stream is missing (#11116) (fb9a108)
• okhttp: Remove finished stream even if a pending stream was started (d21fe32)

Dependencies

• cronet: Update Cronet to latest release + Move to Stable Cronet APIs. (5a8da19)
• cronet: @JavaDoc update android permission MODIFY_NETWORK_ACCOUNTING (deprecated) => UPDATE_DEVICE_STATS (c703a1e)
• cronet: Update to Java-8 API's and tighten the scopes (163efa3)
• cronet: Update to StandardCharsets and assertNotNull API's (77e59b2)

Acknowledgements

@panchenko
@Ashok-Varma
@benjaminp
@AutomatedTester
@hypnoce
@keith
@laglangyue
@rostik404
@ryanpbrewster
@abtom
@hvadehra
@rtadepalli

v1.63.0

API Changes

• xds: Stabilize CsdsService (#11003) (0d749c5)
• api: Stabilize server.getListenerSockets (#10910) (ff34d51)
• servlet: Introduce ServletServerBuilder.buildServlet(#10921) (257d1c2)
• api: Allow configuration of the queued byte threshold at which a Stream is considered not ready (#10977) (2c83ef0)

New Features

xds, dual stack, happy eyeballs: Support dual stack in xds, change list includes:

• Enable new PickFirst lb policy by default. The new PickFirst implements subchannel picking logic. (#11002) (8a9ce99)
• EDS resource now supports additional addresses (#11011) (38f968f)
• Change address based outlier detection to endpoint based (#10939) (c61fe69)
• Enable Happy Eyeballs by default (#11022) (51f811d)

Improvements

• rls: Adding extra debug logs (#10902) (eba699a)
• binder: Add missing Android API annotations (#10841) (ce2adcc)
• core: Provide DEADLINE_EXCEEDED insights for context deadline (3abab95). When the deadline triggered and the deadline was set on the RPC via the stub or CallOptions, gRPC would gather additional debugging information to help understand where the RPC took so long. However if the deadline came from io.grpc.Context the error was simply “context timed out.” Now the debugging information is provided in both cases
• examples: Fix file paths in debug example README (e19f1f1)
• compiler: implement ability to skip generation of javax annotation (#10927) (0d39c2c). Pass the option jakarta_omit to protoc-gen-grpc-java when generating code
• xds: Get rid of xDS v2 proto dependencies (#10968) (feab4e5). grpc-xds jar size has decreased by 35%.
• xds: Support retrieving names from wrapped resource containers (#10975) (867e469)
• netty: improve server handling of writes to reset streams (#10258) (a68399a)
• api: Fix a typo in ServerInterceptor JavaDoc (#10990) (0b82f01)
• servlet: Check log fine level before hex string conversion. (#11038)
• auth: Specify a locale for upper/lower case conversions (1.63.x backport) #11050

Bug Fixes

• xds: Copy data in least request to avoid picker data race (f4cc166). This fixes a possible regression introduced in 1.60.0. Auditing the buggy code showed it unlikely to cause problems in practice, but that was more by happenstance than by design
• xds: Fix data race in the xds client that contacts the control plane (d7628a3)
• rls: Fix a local and remote race (aa90768). The remote race could cause an RPC to hang until its deadline. It had been seen in practice when the client was severely CPU under-provisioned
• xds: Fix xdsNameResolver virtual host lookup authority with xdstp style names. Use service authority instead of ldsResourceName (#10960) (78b3972)
• core: Fix retry race condition that can lead to double decrementing inFlightSubStreams and so miss calling closed (#11026) (#11033)
• okhttp: Fix OkHTTP client transport leak (#11060)
• xds: Use empty string when disabling server hostname verification ( #11058)

Dependencies

• Upgraded google-auth-library-java to 1.22.0

Acknowledgement

Alex Panchenko
Benjamin Peterson
David Ankin
Prashanth Swaminathan
Touko Vainio-Kaila

v1.62.2

gRPC Java 1.62.2 Release Notes

Note that this is the initial 1.62.x release

API Changes

• services: Remove io.grpc.services.BinaryLogs, which was deprecated since 2021. io.grpc.protobuf.services.BinaryLogs should be used instead (#10832).
• Allow users outside of io.grpc.xds package to create custom xDS resources (#10834) (6d96e65)

New Features

• api:Add ClientTransportFilter. Similarly to ServerTransportFilter, this will provide an observability hook and it allows direct modification of the transport's attributes. (#10646)

Improvements

• java_grpc_library.bzl: Add support for Auto Exec Groups (cb03bd2). This is mostly a behind-the-scenes change to adjust to the newer way Bazel operates
• java_grpc_library.bzl: Support runfiles for protoc and the plugin (65a6b3b). Neither binary uses runfiles, but the task will be ready if they need to in the future
• xds: Add EC key support for XdsChannelCredentials/XdsServerCredentials (100d5a5)
• binder:Change log level from WARNING to FINER for expected exception during close with error, to reduce log spamming (#10899) (7ba0718)

Bug Fixes

• xds: Fix a bug in WeightedRoundRobinLoadBalancer policy that could raise NullPointerException and further cause channel panic when picking a subchannel. This bug can only be triggered when connection can not be established and the channel reports TRANSIENT_FAILURE state. (#10868)

Dependencies

• The protoc plugin no longer supports macOS Big Sur (macOS 11). Binaries are now built using Monterey (macOS 12)

Acknowledgements

• @joybestourous

v1.61.1

Bug Fixes

xds: Fix a bug in WeightedRoundRobinLoadBalancer policy that could raise NullPointerException and further cause channel panic when picking a subchannel. This bug can only be triggered when connection can not be established and the channel reports TRANSIENT_FAILURE state. (#10868)

v1.60.2

Bug Fixes

xds: Fix a bug in WeightedRoundRobinLoadBalancer policy that could raise NullPointerException and further cause channel panic when picking a subchannel. This bug can only be triggered when connection can not be established and the channel reports TRANSIENT_FAILURE state. (#10868)

v1.61.0

API Changes

• Remove unused experimental API ManagedChannelBuilder.enableFullStreamDecompression (#10744)
• api: Deprecate LoadBalancer.EMPTY_PICKER added in 1.58.0 in favor of FixedResultPicker (860b5cb)

New Features

• binder: Experimental support for asynchronous security policies (#10566)

Improvements

• core: reduce CompositeReadableBuffer allocation (#3279)
• core: Improve error message clarity when a channel leak is detected (201893f)
• util: use shared index across round_robin pickers (dca89b2). This makes its implementation more similar to weighted_round_robin.
• xds: Implement ADS stream flow control mechanism (#10674). This limits the maximum memory consumed if the control plane sends updates more rapidly than they can be processed.

Bug Fixes

• core: Check outbound maximum message size for the compressed size in addition to the already-checked uncompressed size (#10739). Fixed the status code to be RESOURCE_EXHAUSTED instead of UNKNOWN.
• util: Fix NPE when multiple addresses are in an address group for petiole load balancer policies (#10769)
• util: Disable publishing of fixtures (8ac43dd). The Gradle test fixtures are for use by grpc-java's internal tests.
• okhttp: Ignore known conscrypt socket close issue (#10812). This stops an exception from being thrown when a known Conscrypt synchronization issue happens.

Dependencies

• Drop support for Bazel 5 (55a9c01). Bazel 7 is available, and Protobuf has already dropped support for Bazel 5.
• Change many compile deps to runtime deps (d6830d7). This reduces the transitive classes "leaked" into the compile classpath. In particular, grpc-core (io.grpc.internal) will be less frequently included transitively at compile time.
• Upgrade dependencies (c985797)
  • Protobuf to 3.25.1
  • auto-value-annotations to 1.10.4
  • error_prone_annotations to 2.23.0
  • proto-google-common-protos to 2.29.0
  • google-cloud-logging to 3.15.14
  • guava to 32.1.3-android
  • okio to 3.4.0

Acknowledgements

• @Gordiychuk
• @jroper
• @jyane
• @ulfjack

v1.60.1

Bug Fixes

• util: Fix NPE when multiple addresses in an address group for petiole load balancer policies (#10770)

v1.58.1

• xds: PickFirst was not receiving its configuration so it used the default configuration which meant that randomize was ignored.