• Home
  • History
  • Annotate
  • only in this directory
Name Date Size

..11-Jan-20224 KiB

.github/H11-Jan-20224 KiB

.travis.ymlH A D11-Jan-20221.1 KiB

AUTHORSH A D11-Jan-202212

backoff.goH A D11-Jan-20221.1 KiB

balancer/H11-Jan-20224 KiB

balancer.goH A D11-Jan-202210.9 KiB

balancer_conn_wrappers.goH A D11-Jan-20227.6 KiB

balancer_switching_test.goH A D11-Jan-202213.1 KiB

balancer_test.goH A D11-Jan-202224.5 KiB

balancer_v1_wrapper.goH A D11-Jan-20228.5 KiB

benchmark/H11-Jan-20224 KiB

binarylog/grpc_binarylog_v1/H11-Jan-20224 KiB

call.goH A D11-Jan-20222.4 KiB

call_test.goH A D11-Jan-20227.3 KiB

channelz/H11-Jan-20224 KiB

clientconn.goH A D11-Jan-202244.8 KiB

clientconn_state_transition_test.goH A D11-Jan-202212.8 KiB

clientconn_test.goH A D11-Jan-202229.3 KiB

codec.goH A D11-Jan-20221.6 KiB

codec_test.goH A D11-Jan-2022891

codegen.shH A D11-Jan-2022635

codes/H11-Jan-20224 KiB

connectivity/H11-Jan-20224 KiB

CONTRIBUTING.mdH A D11-Jan-20222.4 KiB

credentials/H11-Jan-20224 KiB

dialoptions.goH A D11-Jan-202215.8 KiB

doc.goH A D11-Jan-2022755

Documentation/H11-Jan-20224 KiB

encoding/H11-Jan-20224 KiB

examples/H11-Jan-20224 KiB

go.modH A D11-Jan-2022832

go.sumH A D11-Jan-20223 KiB

grpclog/H11-Jan-20224 KiB

health/H11-Jan-20224 KiB

install_gae.shH A D11-Jan-2022236

interceptor.goH A D11-Jan-20223.9 KiB

internal/H11-Jan-20224 KiB

interop/H11-Jan-20224 KiB

keepalive/H11-Jan-20224 KiB

LICENSEH A D11-Jan-202211.1 KiB

MakefileH A D11-Jan-20221.1 KiB

metadata/H11-Jan-20224 KiB

naming/H11-Jan-20224 KiB

peer/H11-Jan-20224 KiB

picker_wrapper.goH A D11-Jan-20224.4 KiB

picker_wrapper_test.goH A D11-Jan-20224.9 KiB

pickfirst.goH A D11-Jan-20222.8 KiB

pickfirst_test.goH A D11-Jan-202211.6 KiB

proxy.goH A D11-Jan-20224 KiB

proxy_test.goH A D11-Jan-20225.6 KiB

README.mdH A D11-Jan-20222.7 KiB

reflection/H11-Jan-20224 KiB

resolver/H11-Jan-20224 KiB

resolver_conn_wrapper.goH A D11-Jan-20224.3 KiB

resolver_conn_wrapper_test.goH A D11-Jan-20224.7 KiB

rpc_util.goH A D11-Jan-202224.4 KiB

rpc_util_test.goH A D11-Jan-20228.2 KiB

server.goH A D11-Jan-202241.9 KiB

server_test.goH A D11-Jan-20223.2 KiB

service_config.goH A D11-Jan-202211.3 KiB

service_config_test.goH A D11-Jan-20228.2 KiB

stats/H11-Jan-20224 KiB

status/H11-Jan-20224 KiB

stream.goH A D11-Jan-202243.1 KiB

stress/H11-Jan-20224 KiB

tap/H11-Jan-20224 KiB

test/H11-Jan-20224 KiB

testdata/H11-Jan-20224 KiB

trace.goH A D11-Jan-20222.7 KiB

version.goH A D11-Jan-2022683

vet.shH A D11-Jan-20224.4 KiB

README.md

1# gRPC-Go
2
3[![Build Status](https://travis-ci.org/grpc/grpc-go.svg)](https://travis-ci.org/grpc/grpc-go) [![GoDoc](https://godoc.org/google.golang.org/grpc?status.svg)](https://godoc.org/google.golang.org/grpc) [![GoReportCard](https://goreportcard.com/badge/grpc/grpc-go)](https://goreportcard.com/report/github.com/grpc/grpc-go)
4
5The Go implementation of [gRPC](https://grpc.io/): A high performance, open source, general RPC framework that puts mobile and HTTP/2 first. For more information see the [gRPC Quick Start: Go](https://grpc.io/docs/quickstart/go.html) guide.
6
7Installation
8------------
9
10To 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:
11
12```
13$ go get -u google.golang.org/grpc
14```
15
16Prerequisites
17-------------
18
19gRPC-Go requires Go 1.9 or later.
20
21Constraints
22-----------
23The 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](http://godoc.org/google.golang.org/grpc?imports), you need a discussion with gRPC-Go authors and consultants.
24
25Documentation
26-------------
27See [API documentation](https://godoc.org/google.golang.org/grpc) for package and API descriptions and find examples in the [examples directory](examples/).
28
29Performance
30-----------
31See the current benchmarks for some of the languages supported in [this dashboard](https://performance-dot-grpc-testing.appspot.com/explore?dashboard=5652536396611584&widget=490377658&container=1286539696).
32
33Status
34------
35General Availability [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages).
36
37FAQ
38---
39
40#### Compiling error, undefined: grpc.SupportPackageIsVersion
41
42Please update proto package, gRPC package and rebuild the proto files:
43 - `go get -u github.com/golang/protobuf/{proto,protoc-gen-go}`
44 - `go get -u google.golang.org/grpc`
45 - `protoc --go_out=plugins=grpc:. *.proto`
46
47#### How to turn on logging
48
49The default logger is controlled by the environment variables. Turn everything
50on by setting:
51
52```
53GRPC_GO_LOG_VERBOSITY_LEVEL=99 GRPC_GO_LOG_SEVERITY_LEVEL=info
54```
55
56#### The RPC failed with error `"code = Unavailable desc = transport is closing"`
57
58This error means the connection the RPC is using was closed, and there are many
59possible reasons, including:
60 1. mis-configured transport credentials, connection failed on handshaking
61 1. bytes disrupted, possibly by a proxy in between
62 1. server shutdown
63
64It can be tricky to debug this because the error happens on the client side but
65the root cause of the connection being closed is on the server side. Turn on
66logging on __both client and server__, and see if there are any transport
67errors.
68