compaction

Installation
SKILL.md

Compaction Troubleshooting (Shared-Nothing)

This skill applies to shared-nothing deployments only. For shared-data, compaction is managed by the storage layer and diagnosed differently.

Three root causes account for the vast majority of cases:

  • Cause A — import rate exceeds cumulative compaction throughput (rowset pile-up)
  • Cause B — batch DELETE statements causing version explosion
  • Cause C — large tablet where base compaction is not self-triggering

Metric Taxonomy — Read This First

Before using any metrics, understand the two-layer structure:

BE-level metrics (type-specific, per-node)

Installs
6
GitHub Stars
78
First Seen
Jun 3, 2026