Configuration module for gRPC connection pooling.

This module provides a unified configuration interface that works with both production gRPC services and local/test environments with custom endpoints.

Configuration Options

• :endpoint - Connection endpoint configuration
  • :type - Either :production, :custom, or any atom for different environments
  • :host - Hostname (required for custom endpoints)
  • :port - Port number (required for custom endpoints)
  • :ssl - SSL configuration (default: auto-configured based on type)
  • :credentials - Custom gRPC credentials
  • :retry_config - Retry configuration for connection failures
  • :interceptors - List of gRPC client interceptors (modules implementing the interceptor behavior)
• :pool - Pool configuration
  • :size - Number of connections in pool (default: 5)
  • :name - Pool name (default: auto-generated)
  • :strategy - Channel selection strategy: :round_robin (default), :random, :power_of_two, or a custom module implementing GrpcConnectionPool.Strategy
  • :telemetry_interval - Interval in ms for the periodic :status event (default: 5_000)
  • :telemetry_sample_rate - Per-call :get_channel telemetry: 1 = emit every call (default), 0 = never, N = emit ~1-in-N (default: 1)
• :connection - Connection-specific settings
  • :keepalive - Keepalive interval in milliseconds (default: 30_000)
  • :health_check - Whether to enable connection health checks (default: true)
  • :ping_interval - Interval to send ping to keep connection warm (default: 25_000)

Examples

Production Configuration

config = %GrpcConnectionPool.Config{
  endpoint: %{
    type: :production,
    host: "api.example.com",
    port: 443,
    ssl: []
  },
  pool: %{
    size: 10,
    name: MyApp.GrpcPool
  }
}

Custom Endpoint Configuration

config = %GrpcConnectionPool.Config{
  endpoint: %{
    type: :test,
    host: "localhost",
    port: 9090
  },
  pool: %{
    size: 3
  }
}

Using Custom Credentials

config = %GrpcConnectionPool.Config{
  endpoint: %{
    type: :production,
    host: "secure-api.example.com", 
    port: 443,
    credentials: GRPC.Credential.new(ssl: [
      verify: :verify_peer,
      cacertfile: "/path/to/ca.pem"
    ])
  }
}

Using Interceptors

config = %GrpcConnectionPool.Config{
  endpoint: %{
    type: :production,
    host: "api.example.com",
    port: 443,
    interceptors: [MyApp.LoggingInterceptor, MyApp.AuthInterceptor]
  }
}