google.golang.org/grpc => github.com/grpc/grpc-go (every 6h) https://github.com/grpc/grpc-go
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Doug Fawley 6b46f470d1
client: consider service config invalid if loadBalancingConfig… (#3034)
2 days ago
.github github: add mergeable config (#3008) 2 weeks ago
Documentation doc: clarify client concurrency (#3001) 2 weeks ago
balancer internal: update proto library version (#3025) 5 days ago
benchmark internal: update proto library version (#3025) 5 days ago
binarylog/grpc_binarylog_v1 binarylog: implement methodlogger (#2334) 11 months ago
channelz internal: update proto library version (#3025) 5 days ago
codes docs: add note about retrying UNAVAILABLE (#2774) 5 months ago
connectivity fix: typos (#2591) 8 months ago
credentials internal: update proto library version (#3025) 5 days ago
encoding encoding: check whether encoding.Name() is empty before calling strings.ToLower (#2707) 6 months ago
examples internal: update proto library version (#3025) 5 days ago
grpclog Downgrade grpclb package info logs to V(2). (#2710) 6 months ago
health internal: update proto library version (#3025) 5 days ago
internal server: set and advertise max frame size of 16KB (#3018) 1 week ago
interop internal: update proto library version (#3025) 5 days ago
keepalive keepalive: apply minimum ping time of 10s to client and 1s to server (#2642) 7 months ago
metadata cleanup: replace "x/net/context" import with "context" (#2439) 10 months ago
naming Update go.mod for golang/x/tools and staticcheck (#2832) 4 months ago
peer cleanup: replace "x/net/context" import with "context" (#2439) 10 months ago
reflection internal: update proto library version (#3025) 5 days ago
resolver balancer/resolver: add loadBalancingConfig and pre-parsing support (#2732) 3 months ago
serviceconfig serviceconfig: mark new package experimental (#2852) 3 months ago
stats internal: update proto library version (#3025) 5 days ago
status status: Implement *statusError.Is (#2868) 2 months ago
stress internal: update proto library version (#3025) 5 days ago
tap cleanup: replace "x/net/context" import with "context" (#2439) 10 months ago
test test: fix channelz test for violating flow control (#3031) 4 days ago
testdata testdata: get test assets related to package root instead of GOPATH (#2272) 1 year ago
xds Add functionality to read xDS bootstrap file. (#3000) 1 week ago
.travis.yml internal: update proto library version (#3025) 5 days ago
AUTHORS add AUTHORS and LICENSE 2 years ago
CONTRIBUTING.md internal: clean up README (#2764) 5 months ago
LICENSE Make Apache 2.0 LICENSE file a verbatim copy (#1329) 2 years ago
MAINTAINERS.md change from Inc. to LLC for Google (#2997) 3 weeks ago
Makefile makefile: remove testappengine from make all (#2621) 7 months ago
README.md internal: clean up README (#2764) 5 months ago
backoff.go fix: typos (#2591) 8 months ago
balancer.go docs: clarify "deprecated" to indicate whether some features may be removed in 1.x (#2900) 2 months ago
balancer_conn_wrappers.go balancer: filter out grpclb addresses if balancer is not grpclb (#2907) 2 months ago
balancer_switching_test.go balancer/resolver: add loadBalancingConfig and pre-parsing support (#2732) 3 months ago
balancer_test.go client: remove option to send RPCs before HTTP/2 handshake is completed (#2904) 2 months ago
balancer_v1_wrapper.go balancer: provide parsed target through BuildOptions (#2803) 4 months ago
call.go fix: typos (#2591) 8 months ago
call_test.go interceptor: new APIs for chaining client interceptors. (#2696) 5 months ago
clientconn.go client: fix race between transport draining and new RPCs (#2919) 2 months ago
clientconn_state_transition_test.go client: fix race between transport draining and new RPCs (#2919) 2 months ago
clientconn_test.go test: fix race reading while incrementing (#2935) 1 month ago
codec.go encoding: Introduce new method for registering and choosing codecs (#1813) 1 year ago
codec_test.go grpctest: add new package to manage tests and support per-test setup/teardown (#2523) 8 months ago
codegen.sh FIX: use /usr/bin/env bash in shebang 2 years ago
dialoptions.go client: remove option to send RPCs before HTTP/2 handshake is completed (#2904) 2 months ago
doc.go Fix missing and wrong license (#1422) 2 years ago
go.mod internal: update proto library version (#3025) 5 days ago
go.sum internal: update proto library version (#3025) 5 days ago
grpc_test.go test: disable leakcheck after the first failure (#2563) 8 months ago
install_gae.sh testing: upgrade appengine sdk to version 1.9.68 (#2311) 1 year ago
interceptor.go cleanup: replace "x/net/context" import with "context" (#2439) 10 months ago
picker_wrapper.go client: return helpful error message when wait-for-ready RPCs fail with timeout (#2777) 4 months ago
picker_wrapper_test.go Fix error formatting based on best practices from Code Review Comments (#2615) 7 months ago
pickfirst.go client: log balancer info messages only for verbosity level >=2 (#2908) 1 month ago
pickfirst_test.go client: remove option to send RPCs before HTTP/2 handshake is completed (#2904) 2 months ago
preloader.go Mark PreparedMsg as EXPERIMENTAL (#2783) 5 months ago
proxy.go proxy: support basic authentication (#2426) 10 months ago
proxy_test.go cleanup: use time.Until(t) instead of t.Sub(time.Now) (#2571) 8 months ago
resolver_conn_wrapper.go balancer/resolver: add loadBalancingConfig and pre-parsing support (#2732) 3 months ago
resolver_conn_wrapper_test.go grpctest: add new package to manage tests and support per-test setup/teardown (#2523) 8 months ago
rpc_util.go grpc: implementation of PreparedMsg API 5 months ago
rpc_util_test.go Remove call to proto.Clone() in http2Server.WriteStatus. (#2842) 3 months ago
server.go server: avoid call to trace.FromContext and resulting allocations when tracing is disabled (#2926) 1 month ago
server_test.go grpctest: add new package to manage tests and support per-test setup/teardown (#2523) 8 months ago
service_config.go client: consider service config invalid if loadBalancingConfig… (#3034) 2 days ago
service_config_test.go client: consider service config invalid if loadBalancingConfig… (#3034) 2 days ago
stream.go stream: call stats handler if the attempt failed to get transport (#2962) 1 month ago
trace.go client: restore remote address in traces (#2718) 5 months ago
version.go Change version to 1.24.0-dev (#2974) 1 month ago
vet.sh internal: update proto library version (#3025) 5 days ago

README.md

gRPC-Go

Build Status GoDoc GoReportCard

The Go implementation of gRPC: A high performance, open source, general RPC framework that puts mobile and HTTP/2 first. For more information see the gRPC Quick Start: Go guide.

Installation

To install this package, you need to install Go and setup your Go workspace on your computer. The simplest way to install the library is to run:

$ go get -u google.golang.org/grpc

With Go module support (Go 1.11+), simply import "google.golang.org/grpc" in your source code and go [build|run|test] will automatically download the necessary dependencies (Go modules ref).

If you are trying to access grpc-go from within China, please see the FAQ below.

Prerequisites

gRPC-Go requires Go 1.9 or later.

Documentation

Performance

Performance benchmark data for grpc-go and other languages is maintained in this dashboard.

Status

General Availability Google Cloud Platform Launch Stages.

FAQ

I/O Timeout Errors

The golang.org domain may be blocked from some countries. go get usually produces an error like the following when this happens:

$ go get -u google.golang.org/grpc
package google.golang.org/grpc: unrecognized import path "google.golang.org/grpc" (https fetch: Get https://google.golang.org/grpc?go-get=1: dial tcp 216.239.37.1:443: i/o timeout)

To build Go code, there are several options:

  • Set up a VPN and access google.golang.org through that.

  • Without Go module support: git clone the repo manually:

  git clone https://github.com/grpc/grpc-go.git $GOPATH/src/google.golang.org/grpc

You will need to do the same for all of grpc’s dependencies in golang.org, e.g. golang.org/x/net.

  • With Go module support: it is possible to use the replace feature of go mod to create aliases for golang.org packages. In your project’s directory:
  go mod edit -replace=google.golang.org/grpc=github.com/grpc/grpc-go@latest
  go mod tidy
  go mod vendor
  go build -mod=vendor

Again, this will need to be done for all transitive dependencies hosted on golang.org as well. Please refer to this issue in the golang repo regarding this concern.

Compiling error, undefined: grpc.SupportPackageIsVersion

Please update proto package, gRPC package and rebuild the proto files:

  • go get -u github.com/golang/protobuf/{proto,protoc-gen-go}
  • go get -u google.golang.org/grpc
  • protoc --go_out=plugins=grpc:. *.proto

How to turn on logging

The default logger is controlled by the environment variables. Turn everything on by setting:

GRPC_GO_LOG_VERBOSITY_LEVEL=99 GRPC_GO_LOG_SEVERITY_LEVEL=info

The RPC failed with error "code = Unavailable desc = transport is closing"

This error means the connection the RPC is using was closed, and there are many possible reasons, including:

  1. mis-configured transport credentials, connection failed on handshaking
  2. bytes disrupted, possibly by a proxy in between
  3. server shutdown

It can be tricky to debug this because the error happens on the client side but the root cause of the connection being closed is on the server side. Turn on logging on both client and server, and see if there are any transport errors.