History

Darren Shepherd d246c89254 go mod vendor		5 years ago
..
balancer	go mod vendor	5 years ago
binarylog/grpc_binarylog_v1	go mod vendor	5 years ago
codes	go mod vendor	5 years ago
connectivity	go mod vendor	5 years ago
credentials	go mod vendor	5 years ago
encoding	go mod vendor	5 years ago
grpclog	go mod vendor	5 years ago
health	go mod vendor	5 years ago
internal	go mod vendor	5 years ago
keepalive	go mod vendor	5 years ago
metadata	go mod vendor	5 years ago
naming	go mod vendor	5 years ago
peer	go mod vendor	5 years ago
resolver	go mod vendor	5 years ago
stats	go mod vendor	5 years ago
status	go mod vendor	5 years ago
tap	go mod vendor	5 years ago
.travis.yml	go mod vendor	5 years ago
AUTHORS	Update vendor	6 years ago
CONTRIBUTING.md	go mod vendor	5 years ago
LICENSE	Update vendor	6 years ago
Makefile	go mod vendor	5 years ago
README.md	go mod vendor	5 years ago
backoff.go	go mod vendor	5 years ago
balancer.go	go mod vendor	5 years ago
balancer_conn_wrappers.go	go mod vendor	5 years ago
balancer_v1_wrapper.go	go mod vendor	5 years ago
call.go	go mod vendor	5 years ago
clientconn.go	go mod vendor	5 years ago
codec.go	Update vendor	6 years ago
codegen.sh	go mod vendor	5 years ago
dialoptions.go	go mod vendor	5 years ago
doc.go	Update vendor	6 years ago
go.mod	go mod vendor	5 years ago
go.sum	go mod vendor	5 years ago
install_gae.sh	go mod vendor	5 years ago
interceptor.go	go mod vendor	5 years ago
picker_wrapper.go	go mod vendor	5 years ago
pickfirst.go	go mod vendor	5 years ago
proxy.go	go mod vendor	5 years ago
resolver_conn_wrapper.go	go mod vendor	5 years ago
rpc_util.go	go mod vendor	5 years ago
server.go	go mod vendor	5 years ago
service_config.go	go mod vendor	5 years ago
stream.go	go mod vendor	5 years ago
trace.go	go mod vendor	5 years ago
version.go	go mod vendor	5 years ago
vet.sh	go mod vendor	5 years ago

README.md

gRPC-Go

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

Prerequisites

gRPC-Go requires Go 1.9 or later.

Constraints

The grpc package should only depend on standard Go packages and a small number of exceptions. If your contribution introduces new dependencies which are NOT in the list, you need a discussion with gRPC-Go authors and consultants.

Documentation

See API documentation for package and API descriptions and find examples in the examples directory.

Performance

See the current benchmarks for some of the languages supported in this dashboard.

Status

General Availability Google Cloud Platform Launch Stages.

FAQ

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:

mis-configured transport credentials, connection failed on handshaking
bytes disrupted, possibly by a proxy in between
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.