grpcecho

README

Minimal implementation for Istio Echo app, gRPC only

The intent is to evaluate the overhead of various gRPC options.

• 0.8M for a min go program

• 4.7M for an echo using HTTP.

• 9M - this server, only plain gRPC

• 20M - same app, but proxyless gRPC

• 22M - plus opencensus, prom, zpages, reflection

• ocgrpc adds ~300k

Documentation

Index

• Constants
• Variables
• type EchoGrpcHandler
  • func (h *EchoGrpcHandler) Echo(ctx context.Context, s *nio.Conn, req *proto.EchoRequest) (*proto.EchoResponse, error)
  • func (h *EchoGrpcHandler) ForwardEcho(ctx context.Context, req *proto.ForwardEchoRequest) (*proto.ForwardEchoResponse, error)
  • func (h *EchoGrpcHandler) ServeHTTP(writer http.ResponseWriter, request *http.Request)
• type Field

Constants

const (
	ConnectionTimeout = 2 * time.Second
)

Variables

var (
	StatusCodeOK              = strconv.Itoa(http.StatusOK)
	StatusUnauthorized        = strconv.Itoa(http.StatusUnauthorized)
	StatusCodeForbidden       = strconv.Itoa(http.StatusForbidden)
	StatusCodeUnavailable     = strconv.Itoa(http.StatusServiceUnavailable)
	StatusCodeBadRequest      = strconv.Itoa(http.StatusBadRequest)
	StatusCodeTooManyRequests = strconv.Itoa(http.StatusTooManyRequests)
)

var DefaultRequestTimeout = 5 * time.Second

Types

type EchoGrpcHandler

type EchoGrpcHandler struct {
	Port         int
	Version      string
	Cluster      string
	IstioVersion string
}

func (*EchoGrpcHandler) Echo

func (h *EchoGrpcHandler) Echo(ctx context.Context, s *nio.Conn, req *proto.EchoRequest) (*proto.EchoResponse, error)

func (*EchoGrpcHandler) ForwardEcho

func (h *EchoGrpcHandler) ForwardEcho(ctx context.Context, req *proto.ForwardEchoRequest) (*proto.ForwardEchoResponse, error)

func (*EchoGrpcHandler) ServeHTTP

func (h *EchoGrpcHandler) ServeHTTP(writer http.ResponseWriter, request *http.Request)

Handle /grpc/ requests, equivalent with forward

type Field

type Field string

Field is a list of fields returned in responses from the Echo server.

const (
	RequestIDField      Field = "X-Request-Id"
	ServiceVersionField Field = "ServiceVersion"
	ServicePortField    Field = "ServicePort"
	StatusCodeField     Field = "StatusCode"
	URLField            Field = "URL"
	HostField           Field = "Host"
	HostnameField       Field = "Hostname"
	MethodField         Field = "Method"
	ResponseHeader      Field = "ResponseHeader"
	ClusterField        Field = "Cluster"
	IstioVersionField   Field = "IstioVersion"
	IPField             Field = "IP" // The Requester’s IP Address.
)