cloudflared-mirror/vendor/google.golang.org/grpc
Paul Querna 748eb367fa
Add go modules vendor
2019-05-06 16:42:05 -07:00
..
balancer Add go modules vendor 2019-05-06 16:42:05 -07:00
binarylog/grpc_binarylog_v1 Add go modules vendor 2019-05-06 16:42:05 -07:00
codes Add go modules vendor 2019-05-06 16:42:05 -07:00
connectivity Add go modules vendor 2019-05-06 16:42:05 -07:00
credentials Add go modules vendor 2019-05-06 16:42:05 -07:00
encoding Add go modules vendor 2019-05-06 16:42:05 -07:00
grpclog Add go modules vendor 2019-05-06 16:42:05 -07:00
internal Add go modules vendor 2019-05-06 16:42:05 -07:00
keepalive Add go modules vendor 2019-05-06 16:42:05 -07:00
metadata Add go modules vendor 2019-05-06 16:42:05 -07:00
naming Add go modules vendor 2019-05-06 16:42:05 -07:00
peer Add go modules vendor 2019-05-06 16:42:05 -07:00
resolver Add go modules vendor 2019-05-06 16:42:05 -07:00
stats Add go modules vendor 2019-05-06 16:42:05 -07:00
status Add go modules vendor 2019-05-06 16:42:05 -07:00
tap Add go modules vendor 2019-05-06 16:42:05 -07:00
.travis.yml Add go modules vendor 2019-05-06 16:42:05 -07:00
AUTHORS Add go modules vendor 2019-05-06 16:42:05 -07:00
CONTRIBUTING.md Add go modules vendor 2019-05-06 16:42:05 -07:00
LICENSE Add go modules vendor 2019-05-06 16:42:05 -07:00
Makefile Add go modules vendor 2019-05-06 16:42:05 -07:00
README.md Add go modules vendor 2019-05-06 16:42:05 -07:00
backoff.go Add go modules vendor 2019-05-06 16:42:05 -07:00
balancer.go Add go modules vendor 2019-05-06 16:42:05 -07:00
balancer_conn_wrappers.go Add go modules vendor 2019-05-06 16:42:05 -07:00
balancer_v1_wrapper.go Add go modules vendor 2019-05-06 16:42:05 -07:00
call.go Add go modules vendor 2019-05-06 16:42:05 -07:00
clientconn.go Add go modules vendor 2019-05-06 16:42:05 -07:00
codec.go Add go modules vendor 2019-05-06 16:42:05 -07:00
codegen.sh Add go modules vendor 2019-05-06 16:42:05 -07:00
dialoptions.go Add go modules vendor 2019-05-06 16:42:05 -07:00
doc.go Add go modules vendor 2019-05-06 16:42:05 -07:00
go.mod Add go modules vendor 2019-05-06 16:42:05 -07:00
go.sum Add go modules vendor 2019-05-06 16:42:05 -07:00
install_gae.sh Add go modules vendor 2019-05-06 16:42:05 -07:00
interceptor.go Add go modules vendor 2019-05-06 16:42:05 -07:00
picker_wrapper.go Add go modules vendor 2019-05-06 16:42:05 -07:00
pickfirst.go Add go modules vendor 2019-05-06 16:42:05 -07:00
proxy.go Add go modules vendor 2019-05-06 16:42:05 -07:00
resolver_conn_wrapper.go Add go modules vendor 2019-05-06 16:42:05 -07:00
rpc_util.go Add go modules vendor 2019-05-06 16:42:05 -07:00
server.go Add go modules vendor 2019-05-06 16:42:05 -07:00
service_config.go Add go modules vendor 2019-05-06 16:42:05 -07:00
stream.go Add go modules vendor 2019-05-06 16:42:05 -07:00
trace.go Add go modules vendor 2019-05-06 16:42:05 -07:00
version.go Add go modules vendor 2019-05-06 16:42:05 -07:00
vet.sh Add go modules vendor 2019-05-06 16:42:05 -07:00

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

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:

  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.