import
Installation
SKILL.md
Import Troubleshooting
Investigation guide for import slowness, timeouts, RPC failures, publish timeouts, Primary Key model tuning, and load profile analysis.
Six root causes account for the vast majority of cases:
- Cause A — Write slow: thread pool bottleneck (async_delta_writer / memtable_flush saturated)
- Cause B — Write slow: BRPC / network issue (connection backlog, packet loss)
- Cause C — Write slow: PK index rebuild during clone / decommission
- Cause D — Publish timeout: compaction lag on PK table
- Cause E — Read slow: source-side bottleneck (Kafka partition count, file IO, HTTP client)
- Cause F — RPC Failed: statistics collection conflict saturating BRPC
Metric Taxonomy — Read This First
Before using any metrics, understand the write pipeline and where each metric fits: