Release 1.62.1

Bug Fixes

• xds: fix a bug that results in no matching virtual host found RPC errors due to a difference between the target and LDS resource names (#6997)
• server: fixed stats handler data InPayload.Length for unary RPC calls (#6766)
  • Special Thanks: @hueypark
• grpc: the experimental RecvBufferPool DialOption and ServerOption are now active during unary RPCs with compression (#6766)
  • Special Thanks: @hueypark
• grpc: trim whitespaces in accept-encoding header before determining compressors
  • Special Thanks: @sercand

GCP Observability v1.0.1

Update dependencies

The latest released version of stackdriver depends upon an unstable version of prometheus. Symbols needed by stackdriver were moved inside of prometheus after this release. To address this, this release updates our dependencies to use an unreleased version of stackdriver (which is archived) that removed its dependency on prometheus entirely. Please see #7008 for more details.

Release 1.62.0

New Features

• grpc: Add StaticMethod CallOption as a signal to stats handler that a method is safe to use as an instrument key (#6986)

Behavior Changes

• grpc: Return canonical target string from ClientConn.Target() and resolver.Address.String() (#6923)

Bug Fixes

• server: wait to close connection until incoming socket is drained (with timeout) to prevent data loss on client-side (#6977)
  • Special Thanks: @s-matyukevich for discovering the root cause

Performance Improvements

• *: Allow building without x/net/trace by using grpcnotrace to enable dead code elimination (#6954)
  • Special Thanks: @hugelgupf
• rand: improve performance and simplify implementation of grpcrand by adopting math/rand's top-level functions for go version 1.21.0 and newer. (#6925)
  • Special Thanks: @kmirzavaziri

Dependencies

• *: Use google.golang.org/protobuf/proto instead of github.com/golang/protobuf. (#6919)
  • Special Thanks: @Clement-Jean

Note

The above change in proto library usage introduces a minor behavior change within those libraries. The old github.com/golang/protobuf library would error if given a nil message to Marshal, while the new google.golang.org/protobuf library will successfully output zero bytes in this case. This means server method handlers that did return nil, nil will now return an empty message and no error, while it used to return an error. This also affects the client side, where clients sending nil messages used to fail without sending the RPC, and now they will send an empty message.

Release 1.61.1

Bug Fixes

• server: wait to close connection until incoming socket is drained (with timeout) to prevent data loss on client-side (#6977)
  • Special Thanks: @s-matyukevich for discovering the root cause

Release 1.61.0

New Features

• resolver: provide method, AuthorityOverrider, to allow resolver.Builders to override the default authority for a ClientConn. (EXPERIMENTAL) (#6752)
  • Special Thanks: @Aditya-Sood
• xds: add support for mTLS Credentials in xDS bootstrap (gRFC A65) (#6757)
  • Special Thanks: @atollena
• server: add grpc.WaitForHandlers ServerOption to cause Server.Stop to block until method handlers return. (EXPERIMENTAL) (#6922)

Performance Improvements

• grpc: skip compression of empty messages as an optimization (#6842)
  • Special Thanks: @jroper
• orca: use atomic pointer to improve performance in server metrics recorder (#6799)
  • Special Thanks: @danielzhaotongliu

Bug Fixes

• client: correctly enable TCP keepalives with OS defaults on windows (#6863)
  • Special Thanks: @mmatczuk
• server: change some stream operations to return UNAVAILABLE instead of UNKNOWN when underlying connection is broken (#6891)
  • Special Thanks: @mustafasen81
• server: fix GracefulStop to block until all method handlers return (v1.60 regression). (#6922)
• server: fix two bugs that could lead to panics at shutdown when using NumStreamWorkers (EXPERIMENTAL). (#6856)
• reflection: do not send invalid descriptors to clients for files that cannot be fully resolved (#6771)
  • Special Thanks: @jhump
• xds: don't fail channel/server startup when xds creds is specified, but bootstrap is missing certificate providers (#6848)
• xds: Atomically read and write xDS security configuration client side (#6796)
• xds/server: fix RDS handling for non-inline route configs (#6915)

Release v1.60.1

Bug Fixes

• server: fix two bugs that could lead to panics at shutdown when using NumStreamWorkers (experimental feature).

Release 1.60.0

Security

• credentials/tls: if not set, set TLS MinVersion to 1.2 and CipherSuites according to supported suites not forbidden by RFC7540.
  • This is a behavior change to bring us into better alignment with RFC 7540.

API Changes

• resolver: remove deprecated and experimental ClientConn.NewServiceConfig (#6784)
• client: remove deprecated grpc.WithServiceConfig DialOption (#6800)

Bug Fixes

• client: fix race that could cause a deadlock while entering idle mode and receiving a name resolver update (#6804)
• client: always enable TCP keepalives with OS defaults (#6834)
• credentials/alts: fix a bug preventing ALTS from connecting to the metadata server if the default scheme is overridden (#6686)
  • Special Thanks: @mjamaloney

Behavior Changes

• server: Do not return from Stop() or GracefulStop() until all resources are released (#6489)
  • Special Thanks: @fho

Documentation

• codes: clarify that only codes defined by this package are valid and that users should not cast other values to codes.Code (#6701)

Release 1.57.2

Bug Fixes

• server: fix a bug introduced in v1.57.1 that causes connections to eventually stop processing any RPCs.

Release 1.59.0

Behavior Changes

• balancer: grpc will switch to case-sensitive balancer names soon; log a warning if a capital letter is encountered in an LB policy name (#6647)
• server: allow applications to send arbitrary data in the grpc-status-details-bin trailer (#6662)
• client: validate grpc-status-details-bin trailer and pass through the trailer to the application directly (#6662)

New Features

• tap (experimental): Add Header metadata to tap handler (#6652)
  • Special Thanks: @pstibrany
• grpc: channel idleness enabled by default with an idle_timeout of 30m (#6585)

Documentation

• examples: add an example of flow control behavior (#6648)

Bug Fixes

• xds: fix hash policy header to skip "-bin" headers and read content-type header as expected (#6609)

Release 1.58.3

Security

• server: prohibit more than MaxConcurrentStreams handlers from running at once (CVE-2023-44487)

  In addition to this change, applications should ensure they do not leave running tasks behind related to the RPC before returning from method handlers, or should enforce appropriate limits on any such work.