Cluster Configuration

XyPriss clustering is managed by the high-performance Go core (XHSC). All settings reside under the cluster key in your server options.

import { createServer } from "xypriss";

const app = createServer({
    cluster: {
        enabled: true,
        workers: "auto", // Spawns 1 worker per physical CPU core
        strategy: "least-connections",
        resources: {
            maxMemory: "1GB",
            maxCpu: 80,
        },
    },
});

Core Options

Distribution Strategies

The XHSC engine supports multiple distribution algorithms to suit different workload profiles:

Worker Guardrails

Manage worker health and prevent resource exhaustion with native enforcement:

• maxMemory: Gracefully recycles workers if memory usage exceeds limits (e.g., "512MB", "2GB").
• maxRequests: Limits the number of requests a worker handles before recycling, mitigating potential memory leaks.

Network Quality Rejection

Protect your cluster from "poison pill" requests or slow clients that might degrade performance for others.

requestManagement: {
    networkQuality: {
        enabled: true,
        rejectOnPoorConnection: true,
        maxLatency: 500, // Reject if avg latency > 500ms
        minBandwidth: 1024, // Min 1KB/s requirement
    },
}