How grpc/grpc-go works
gRPC-Go is a Go RPC framework. Its main workflow is a client issuing an RPC through connection setup and load balancing to an HTTP/2 transport, where a server dispatches it to a registered service and returns a response. The repository also provides xDS-based client and server configuration, authorization, observability, and administrative services. The graph emphasizes those product stages; unsampled implementation links are omitted or marked dashed rather than inferred from package names.
Main entry points: server.go gRPC Server · clientconn.go Client Connection · http2_client.go Client HTTP/2 · xds/server.go xDS Server
Components 22
RPC Runtime
- RPC Client
call.go - Client Connection
clientconn.go - Client HTTP/2
internal/transport/http2_client.go - gRPC Server
server.go - Server Transport
internal/transport/handler_server.go - Message Encoding
encoding/encoding.go - Interop Service
interop/server/server.go
Discovery and Routing
- Name Resolver
resolver/resolver.go - Load Balancers
balancer/balancer.go
xDS and Security
- xDS Server
xds/server.go - xDS Server Routing
internal/xds/server - xDS Dependencies
internal/xds/xdsdepmgr/xds_dependency_manager.go - xDS Client
internal/xds/xdsclient - RBAC Engine
internal/xds/rbac/rbac_engine.go - Server Authorization
authz/grpc_authz_server_interceptors.go
Operations and Telemetry
- Health Service
health/server.go - Admin Services
admin/admin.go - Stats Handlers
stats/handlers.go - OpenTelemetry
stats/opentelemetry/opentelemetry.go
Other components
- Application Caller
- HTTP/2 Peer
- xDS Management
Connections 18
- Application Caller → RPC Client: invokes
- Client Connection → Name Resolver: resolves names
- Client Connection → Load Balancers: selects policy
- RPC Client → Client Connection: uses connection
- Client HTTP/2 → HTTP/2 Peer: exchanges frames
- gRPC Server → Server Transport: serves transport
server.go - gRPC Server → Stats Handlers: combines handlers
server.go - Interop Service → gRPC Server: registers service
interop/server/server.go - xDS Server → xDS Server Routing: delegates routing
xds/server.go - xDS Dependencies → xDS Client: watches resources
internal/xds/xdsdepmgr/xds_dependency_manager.go - xDS Dependencies → Name Resolver: builds DNS resolver
internal/xds/xdsdepmgr/xds_dependency_manager.go - xDS Server → xDS Management: communicates xDS
- gRPC Server → Health Service: registers optionally
- gRPC Server → Admin Services: registers optionally
- RBAC Engine → HTTP/2 Peer: authorizes RPCs
- OpenTelemetry → Stats Handlers: records telemetry
- Message Encoding → Client HTTP/2: encodes messages
- Client HTTP/2 → Client Connection: serves RPC calls