pd-scheduling

Diagnose PD scheduler anomalies and region health mismatches in TiDB clusters.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/alex-quan-001/nutshell-skills --skill pd-scheduling
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pd-scheduling
Source: https://github.com/alex-quan-001/nutshell-skills/tree/main/skills/diagnosis/pd-scheduling
Command: npx skills add https://github.com/alex-quan-001/nutshell-skills --skill pd-scheduling

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the guesswork when troubleshooting unexpected PD scheduler behavior, region health metric mismatches, and disruptive scheduling storms that impact TiDB cluster stability and performance.

Core Features & Use Cases

  • PD Scheduler Pattern Reference: Curated handbook of known PD region-checker and scheduler behaviors for common on-call scenarios.
  • Incident-Specific Guidance: Covers scatter conflicts, balance-region storms, evict-leader anomalies, low-space rebalancing issues, and post-topology-change scheduling problems.
  • Real-World Workarounds: Includes proven fixes and related oncall case references for all documented known issues.

Quick Start

Use the pd-scheduling skill to investigate unexpected PD scheduler behavior or region health mismatches in your TiDB cluster.

Frequently Asked Questions about pd-scheduling

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

FAQPage Schema
How do I troubleshoot PD scheduling anomalies and region health mismatches in a TiDB cluster?

Troubleshoot TiDB PD scheduling anomalies by applying curated reference patterns for region-checker behaviors, known case workarounds, and diagnostic guidance for root cause analysis. This resolves unexpected scheduler behavior and region health metric mismatches during on-call incidents.

What is the best way to resolve balance-region storms and evict-leader anomalies in TiDB?

Resolve balance-region storms and evict-leader anomalies in TiDB using proven fixes and incident-specific guidance. This Skill provides real-world workarounds that eliminate guesswork when handling disruptive scheduling storms impacting cluster stability.

Why does TiDB PD scheduling fail after a topology change or during scatter conflicts?

TiDB PD scheduling fails after topology changes or during scatter conflicts due to scheduler mismatches and region health issues. This Skill provides diagnostic guidance and reference patterns to identify root causes and apply known workarounds for these on-call scenarios.

Can I diagnose low-space rebalancing issues and post-topology-change scheduling problems in TiDB using this?

Yes, you can diagnose low-space rebalancing issues and post-topology-change scheduling problems in TiDB. The Skill offers incident-specific guidance covering these scenarios, providing reference patterns and real-world fixes to restore cluster stability.

What limitations should I expect when investigating unexpected PD scheduler behavior in TiDB?

When investigating unexpected PD scheduler behavior in TiDB, expect limitations inherent to reference-pattern based diagnosis. The Skill provides curated workarounds for known issues like scatter conflicts and evict-leader errors, but novel or undocumented scheduling anomalies may require deeper manual root cause analysis.