shared-data

Installation
SKILL.md

Shared-Data Troubleshooting

Investigation guide for shared-data architecture issues: DataCache (StarCache) corruption and autoscaling regressions, S3 rate limiting and multipart upload failures, FE leader switch bugs, and compaction score management.

Five root causes account for the vast majority of cases:

  • Cause A — DataCache autoscaling regression (eviction triggers S3 reads, compaction slows)
  • Cause B — DataCache corruption (checksum mismatch causing publish or query failures)
  • Cause C — S3 rate limiting (503 errors or multipart upload failures)
  • Cause D — FE leader switch issues (EditLog gap causing transaction replay failure)
  • Cause E — Cached tablet metadata inconsistency (stale cache version mismatch)

Metric Taxonomy — Read This First

Before using any metrics, understand the key observability sources:

Installs
6
GitHub Stars
78
First Seen
Jun 3, 2026