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.
 
 
 
 
 
Menghan Li 7392afe7d2
xds: client should handle new watch requests even if there's no working stream (#3376)
4 days ago
.github github: make stalebot monitor PRs, too (#3202) 3 months ago
Documentation revert buffer reuse (#3338) 3 weeks ago
attributes resolver: introduce attributes package and use it for Address and State (#3151) 3 months ago
backoff client: add WithConnectParams to configure connection backoff and timeout (#2960) 4 months ago
balancer channelz: log on channelz trace events and trace on channelz relevant logs. (#3329) 1 week ago
benchmark Revert "profiling: add hooks within grpc (#3159)" (#3378) 1 week ago
binarylog/grpc_binarylog_v1 binarylog: implement methodlogger (#2334) 1 year ago
channelz channelz: log on channelz trace events and trace on channelz relevant logs. (#3329) 1 week ago
codes Modified tests to use tlogger. (#3343) 2 weeks ago
connectivity fix: typos (#2591) 1 year ago
credentials credentials: deprecate ProtocolInfo.SecurityVersion (#3372) 1 week ago
encoding Modified tests to use tlogger. (#3343) 2 weeks ago
examples examples: add client/server to be used for xds examples (#3362) 2 weeks ago
grpclog channelz: log on channelz trace events and trace on channelz relevant logs. (#3329) 1 week ago
health Modified tests to use tlogger. (#3343) 2 weeks ago
internal channelz: log on channelz trace events and trace on channelz relevant logs. (#3329) 1 week ago
interop interop: Build grpclb_fallback/client.go only for linux. (#3375) 1 week ago
keepalive keepalive: apply minimum ping time of 10s to client and 1s to server (#2642) 1 year ago
metadata Modified tests to use tlogger. (#3343) 2 weeks ago
naming Modified tests to use tlogger. (#3343) 2 weeks ago
peer cleanup: replace "x/net/context" import with "context" (#2439) 1 year ago
profiling Revert "profiling: add hooks within grpc (#3159)" (#3378) 1 week ago
reflection Modified tests to use tlogger. (#3343) 2 weeks ago
resolver balancer/resolver: remove temporary backward-compatibility type aliases (#3309) 1 month ago
security/advancedtls advancedtls: use grpc 1.27.0 and small fixes (#3360) 2 weeks ago
serviceconfig resolver: add State fields to support error handling (#2951) 4 months ago
stats Modified tests to use tlogger. (#3343) 2 weeks ago
status Modified tests to use tlogger. (#3343) 2 weeks ago
stress protobuf: update protoc-gen-go version and generated code (#3345) 3 weeks ago
tap cleanup: replace "x/net/context" import with "context" (#2439) 1 year ago
test interceptor: new APIs for chaining server interceptors. (#3336) 1 week ago
testdata testdata: get test assets related to package root instead of GOPATH (#2272) 1 year ago
xds xds: client should handle new watch requests even if there's no working stream (#3376) 4 days ago
.travis.yml advancedtls: fix internal tests (#3322) 1 month ago
AUTHORS add AUTHORS and LICENSE 2 years ago
CODE-OF-CONDUCT.md Update governance, contributing, code of conduct docs (#3033) 5 months ago
CONTRIBUTING.md Update governance, contributing, code of conduct docs (#3033) 5 months ago
GOVERNANCE.md Update governance, contributing, code of conduct docs (#3033) 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) 6 months ago
Makefile advancedtls: fix internal tests (#3322) 1 month ago
README.md README: update SupportPackageIsVersion help in FAQ section (#3350) 3 weeks ago
backoff.go client: add WithConnectParams to configure connection backoff and timeout (#2960) 4 months ago
balancer.go Revert "balancer: move Balancer and Picker to V2; delete legacy… (#3315) 1 month ago
balancer_conn_wrappers.go channelz: log on channelz trace events and trace on channelz relevant logs. (#3329) 1 week ago
balancer_conn_wrappers_test.go balancer/base: consider an empty address list an error (#3361) 2 weeks ago
balancer_switching_test.go Revert "balancer: move Balancer and Picker to V2; delete legacy… (#3315) 1 month ago
balancer_test.go Revert "balancer: move Balancer and Picker to V2; delete legacy… (#3315) 1 month ago
balancer_v1_wrapper.go Revert "balancer: move Balancer and Picker to V2; delete legacy… (#3315) 1 month ago
call.go fix: typos (#2591) 1 year ago
call_test.go Revert "profiling: add hooks within grpc (#3159)" (#3378) 1 week ago
clientconn.go channelz: log on channelz trace events and trace on channelz relevant logs. (#3329) 1 week ago
clientconn_state_transition_test.go client: add WithResolvers options for specifying client-local resolvers (#3320) 1 month ago
clientconn_test.go client: add WithResolvers options for specifying client-local resolvers (#3320) 1 month ago
codec.go revert buffer reuse (#3338) 3 weeks ago
codec_test.go grpctest: add new package to manage tests and support per-test setup/teardown (#2523) 1 year ago
codegen.sh FIX: use /usr/bin/env bash in shebang 3 years ago
dialoptions.go internal: remove withResolverBuilder and use WithResolvers instead (#3321) 1 month ago
doc.go Fix missing and wrong license (#1422) 2 years ago
go.mod protobuf: update protoc-gen-go version and generated code (#3345) 3 weeks ago
go.sum protobuf: update protoc-gen-go version and generated code (#3345) 3 weeks ago
grpc_test.go Modified tests to use tlogger. (#3343) 2 weeks 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) 1 year ago
picker_wrapper.go Revert "balancer: move Balancer and Picker to V2; delete legacy… (#3315) 1 month ago
picker_wrapper_test.go Revert "balancer: move Balancer and Picker to V2; delete legacy… (#3315) 1 month ago
pickfirst.go Revert "balancer: move Balancer and Picker to V2; delete legacy… (#3315) 1 month ago
pickfirst_test.go Revert "balancer: move Balancer and Picker to V2; delete legacy… (#3315) 1 month ago
preloader.go Revert "profiling: add hooks within grpc (#3159)" (#3378) 1 week ago
proxy.go proxy: support basic authentication (#2426) 1 year ago
proxy_test.go proxy_test: Fix a goroutine-leak bug in testHTTPConnect: now use channel done to store err and call t.Fatalf when err not nil (#3080) 4 months ago
resolver_conn_wrapper.go channelz: log on channelz trace events and trace on channelz relevant logs. (#3329) 1 week ago
resolver_conn_wrapper_test.go internal: Move parseTarget function into internal package and export it. (#3368) 1 week ago
rpc_util.go Revert "profiling: add hooks within grpc (#3159)" (#3378) 1 week ago
rpc_util_test.go Revert "profiling: add hooks within grpc (#3159)" (#3378) 1 week ago
server.go channelz: log on channelz trace events and trace on channelz relevant logs. (#3329) 1 week ago
server_test.go grpctest: add new package to manage tests and support per-test setup/teardown (#2523) 1 year ago
service_config.go internal: fix initialBackoff typo (#3289) 1 month ago
service_config_test.go resolver: add State fields to support error handling (#2951) 4 months ago
stream.go channelz: log on channelz trace events and trace on channelz relevant logs. (#3329) 1 week ago
trace.go trace: fix getting family for the method (#3216) 2 months ago
trace_test.go trace: fix getting family for the method (#3216) 2 months ago
version.go Change version to 1.28.0-dev (#3342) 3 weeks ago
vet.sh credentials: deprecate ProtocolInfo.SecurityVersion (#3372) 1 week 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

If you are using Go modules:

Please ensure your gRPC-Go version is required at the appropriate version in the same module containing the generated .pb.go files. For example, SupportPackageIsVersion6 needs v1.27.0, so in your go.mod file:

module <your module name>

require (
    google.golang.org/grpc v1.27.0
)
If you are not using Go modules:

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.