couchbase-performance-tuninglisted

# Couchbase Performance Tuning A skill for diagnosing and fixing performance problems at the cluster level — KV latency, throughput limits, disk I/O, compaction, connection saturation, and thread pool configuration. Distinct from: - `couchbase-sqlpp-tuning` — SQL++ query tuning (index design, EXPLAIN plans, anti-patterns) - `couchbase-observability` — what metrics to monitor and alert thresholds - `couchbase-sizing` — how much capacity to provision in the first place If the question is "my queries are slow," go to `couchbase-sqlpp-tuning`. If the question is "my cluster is right-sized but everything is slow," this is the right skill. ## When this skill applies - "KV get/set latency is higher than expected" - "Throughput isn't reaching the hardware's capability" - "Compaction is killing performance" - "We're hitting connection limits" - "Rebalance is taking too long" - "High CPU on Couchbase nodes but no obvious cause" - "Disk I/O is spiking unpredictably" - "DCP consumers are falling behind" ## Pick the right reference | Question | Read | |---|---| | "KV latency / throughput — diagnosis and tuning" | `references/kv-tuning.md` | | "Compaction — autocompaction settings, impact, tuning" | `references/compaction.md` | | "Connection limits, thread pools, OS-level tuning" | `references/system-tuning.md` | ## The diagnosis sequence Before tuning anything, locate the actual bottleneck: 1. **Is it memory?** Check `ep_mem_used / ep_mem_high_wat`. If > 85%, ejections are happe