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:

Installs
6
GitHub Stars
78
First Seen
Jun 3, 2026