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

tikv-raftstore

Diagnose TiKV raftstore and region lifecycle incidents with diagnostic patterns and workarounds.

Updated Jun 3, 2026
Search Tags:#performance#on-call#incident diagnosis#tikv#database troubleshooting#raftstore#region lifecycle
One-click install
npx skills add https://github.com/alex-quan-001/nutshell-skills --skill tikv-raftstore
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tikv-raftstore
Source: https://github.com/alex-quan-001/nutshell-skills/tree/main/skills/diagnosis/tikv-raftstore
Command: npx skills add https://github.com/alex-quan-001/nutshell-skills --skill tikv-raftstore

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the time-consuming pain point of searching scattered internal and upstream documentation for TiKV raftstore and region lifecycle incident solutions, giving on-call engineering teams immediate access to pre-compiled diagnostic patterns, proven workarounds, and version-specific fix notes to resolve cluster stability and performance issues quickly.

Core Features & Use Cases

  • Comprehensive Incident Coverage: Addresses common raftstore and region failure patterns including region split, add learner timeouts, snapshot apply delays, peer cleanup issues, large-region scheduling side effects, and raftstore-related panics or restarts.
  • Actionable Diagnostic Guidance: Provides step-by-step initial checks, key metrics to monitor, diagnostic command examples, and proven workarounds for each known incident type.
  • Deep-Dive Reference Materials: Includes detailed reference documents for complex failure modes like add-learner timeout loops and SST ingest latency spikes during data movement, plus links to related internal oncall cases and upstream TiKV GitHub issues.

Quick Start

Use the tikv-raftstore skill to troubleshoot your TiKV cluster's region split, snapshot apply delay, or raftstore panic incident by following the provided diagnostic steps and workarounds.

Frequently Asked Questions about tikv-raftstore

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

FAQPage Schema
How do I diagnose TiKV raftstore panics and region split failures?▼

Resolve TiKV add learner timeouts and snapshot apply delays using proven workarounds and version-specific fix notes. These diagnostic patterns target slow recovery scenarios and provide specific command examples to restore cluster stability.

What is the best way to troubleshoot large-region scheduling side effects in TiKV?▼

Troubleshoot large-region scheduling side effects in TiKV by following deep-dive reference documentation for complex failure modes. This provides actionable diagnostic guidance and highlights known limitations for peer cleanup issues.

Why does my TiKV cluster experience slow recovery during data movement and SST ingest latency spikes?▼

TiKV clusters experience slow recovery during data movement due to SST ingest latency spikes and snapshot apply delays. Access detailed reference materials and related upstream GitHub issues to identify root causes and apply fixes.

Can I use these diagnostic patterns for on-call incident diagnosis during TiKV region lifecycle failures?▼

Yes, you can use these diagnostic patterns for on-call incident diagnosis during TiKV region lifecycle failures. They provide actionable workarounds for region split, peer cleanup, and raftstore restarts to quickly resolve on-call engineering scenarios.

Related Skills

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

tikv-oncall-handbook

Route TiKV incident symptoms to specialized diagnosis skills.

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

tikv-storage

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

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

tikv-scale

Diagnose bottlenecks in TiKV scale-out and scale-in operations for TiDB clusters.

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

transaction-oncall-handbook

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

Community
Advanced