Clusters and destinations

Goal

Model upstream capacity with clusters and destinations.

Prerequisites

• proxy.clusters.read / proxy.clusters.write.

Steps

1. Open Topology → Clusters.
2. Create a cluster and choose load-balancing behavior.
3. Add destinations (addresses the Proxy can reach).
4. Configure session affinity, active health checks, and timeouts as needed.
5. Save.

Concepts

Setting	Why it matters
Load balancing	Spreads traffic across destinations
Session affinity	Sticky sessions for stateful apps
Health checks	Remove unhealthy destinations from rotation
Timeouts	Bound slow upstreams

Verify

• Destinations appear under the cluster.
• After publish, traffic distributes as expected (watch upstream logs).

Pitfalls

• Unreachable destinations cause errors only after routing—validate network first.
• Health-check paths must exist on the upstream.

Related

• Routes
• First proxy: create cluster