Composable resilience wrapper for Redis connections.

Stacks circuit breaker, retry, coalescing, and bulkhead patterns around a Redis connection. All patterns are optional -- include only what you need.

Requires {:ex_resilience, "~> 0.4"} in your dependencies.

Usage

# Full resilience stack
{:ok, r} = Redis.Resilience.start_link(
  port: 6379,
  retry: [max_attempts: 3, backoff: :exponential],
  circuit_breaker: [failure_threshold: 5, reset_timeout: 5_000],
  coalesce: true,
  bulkhead: [max_concurrent: 50]
)

# Same API as a regular connection
Redis.Resilience.command(r, ["GET", "key"])
Redis.Resilience.pipeline(r, [["GET", "a"], ["GET", "b"]])

# Inspect the stack
Redis.Resilience.info(r)

Composition Order (inside -> outside)

Connection -> Retry -> CircuitBreaker -> Coalesce -> Bulkhead
             ^ retries transient errors
                    ^ fails fast when unhealthy
                                 ^ deduplicates concurrent requests
                                              ^ limits concurrency

Options

• All Redis.Connection options (host, port, password, etc.)
• :retry - keyword opts for ExResilience.Retry, or false
• :circuit_breaker - keyword opts for ExResilience.CircuitBreaker, or false
• :coalesce - true or keyword opts, or false
• :bulkhead - keyword opts for ExResilience.Bulkhead, or false
• :chaos - keyword opts for ExResilience.Chaos (test only), or false