rpc

name: rpc description: Guidelines for RPC interface design, resilience, and tracing.

RPC

Design

• Context: Every RPC entry point or client call MUST accept context.Context as the first argument.
• Tracing: All RPCs MUST be instrumented with OpenTelemetry.
  • Server: Extract context, start span.
  • Client: Inject context, start span.

Resilience

Timeouts

Set a deadline on every outgoing request.

ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()

Retries

Use exponential backoff with jitter for transient failures.

• gRPC: Use grpc_retry middleware.
• HTTP: Use go-retryablehttp.