skills.rest
alex-quan-001
alex-quan-001COMMUNITY
Explore all skills by this author →
GitHub

tikv-storage

Diagnose TiKV storage-engine, RocksDB, Titan, and disk incidents.

Updated Jun 3, 2026
Search Tags:#database operations#oncall#tikv#storage diagnosis#rocksdb troubleshooting#titan issues#disk incidents
One-click install
npx skills add https://github.com/alex-quan-001/nutshell-skills --skill tikv-storage
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tikv-storage
Source: https://github.com/alex-quan-001/nutshell-skills/tree/main/skills/diagnosis/tikv-storage
Command: npx skills add https://github.com/alex-quan-001/nutshell-skills --skill tikv-storage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the time-consuming process of manually searching scattered documentation and past oncall tickets to troubleshoot complex TiKV storage-engine, RocksDB, Titan, and disk-related incidents that cause cluster performance degradation, service unavailability, or capacity exhaustion.

Core Features & Use Cases

  • RocksDB Incident Reference: Covers common RocksDB issues including compaction pressure, SST file corruption, pending compaction bytes overflow, manifest rewrite overhead, and WAL encryption gaps, with proven workarounds and fixed version information.
  • Titan-Specific Diagnosis: Provides guidance for Titan GC-induced read/write slowdowns, inaccurate region size estimation, and severe data skew across TiKV instances caused by Titan enablement.
  • Host and Disk Behavior Analysis: Includes reference material for host-level disk IO anomalies, RaftEngine periodic traffic spikes, and THP-related latency/memory regressions that impact TiKV performance.
  • Use Case: When a TiKV cluster experiences sudden QPS drops, disk capacity exhaustion, or elevated write latency, use this Skill to quickly match observed symptoms to known root causes and proven mitigation steps.

Quick Start

Invoke the tikv-storage skill to diagnose the root cause of your TiKV cluster's abnormal disk usage growth and pending compaction bytes overflow, and retrieve the corresponding mitigation steps.

Frequently Asked Questions about tikv-storage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose TiKV pending compaction bytes overflow and sudden QPS drops?▼

To diagnose TiKV pending compaction bytes overflow and QPS drops, reference this handbook to match symptoms against known RocksDB compaction pressure root causes and retrieve proven mitigation steps.

What is the best way to troubleshoot TiKV Titan GC induced read/write slowdowns?▼

Troubleshooting TiKV Titan GC slowdowns involves identifying inaccurate region size estimation or data skew caused by Titan enablement, using this reference to apply targeted workarounds for latency recovery.

Why does TiKV disk capacity exhaustion happen and how can I resolve it?▼

TiKV disk capacity exhaustion happens due to host-level disk IO anomalies or compaction overhead, and you resolve it by matching observed symptoms to known root causes and applying documented mitigation steps.

How do I fix RocksDB SST file corruption in a TiKV cluster?▼

Fixing RocksDB SST file corruption in a TiKV cluster requires consulting this oncall reference to identify the specific corruption pattern, apply proven workarounds, and determine the necessary fixed version upgrade.

Can I use this reference for host-level IO anomalies and RaftEngine traffic spikes in TiKV?▼

Yes, you can use this TiKV reference for host-level IO anomalies, including RaftEngine periodic traffic spikes and THP-related latency regressions, to find documented workarounds and restore cluster performance.

What should I do when TiKV storage diagnosis does not match standard compaction pressure symptoms?▼

When standard TiKV compaction pressure diagnosis does not match your symptoms, consult the oncall ticket references provided here to verify if your issue involves WAL encryption gaps or manifest rewrite overhead.

Related Skills

Explore More Software Engineering Skills→
alex-quan-001alex-quan-001

tikv-slow-diagnosis

Diagnose TiKV latency regressions using metric-driven workflows and evidence.

Community
Advanced
alex-quan-001alex-quan-001

tikv-panic

Diagnose TiKV fatal process exits with log signatures and workarounds.

Community
Intermediate
alex-quan-001alex-quan-001

tikv-cdc

Diagnose TiKV and TiCDC interaction failures with curated root cause guidance.

Community
Intermediate
alex-quan-001alex-quan-001

transaction-oncall-handbook

Reference known TiDB/TiKV transaction incident patterns, root causes, and workarounds.

Community
Advanced