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

pd-oncall-handbook

Routes PD incident symptoms to specialized TiDB diagnosis workflows.

Updated Jun 3, 2026
Search Tags:#database-operations#incident-triage#tidb#pd-oncall#placement-driver#cluster-diagnosis#oncall-routing
One-click install
npx skills add https://github.com/alex-quan-001/nutshell-skills --skill pd-oncall-handbook
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pd-oncall-handbook
Source: https://github.com/alex-quan-001/nutshell-skills/tree/main/skills/diagnosis/pd-oncall-handbook
Command: npx skills add https://github.com/alex-quan-001/nutshell-skills --skill pd-oncall-handbook

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the guesswork and delays in PD (Placement Driver) incident response for TiDB clusters by providing a structured entry-point guide that quickly classifies issues and routes on-call engineers to the correct specialized diagnosis workflow, reducing mean time to resolution for both control-plane and data-plane PD problems.

Core Features & Use Cases

  • Symptom-Based Routing: A clear mapping table that links observed PD incident symptoms (placement rule failures, region imbalance, RU throttling, ETCD capacity issues) to the correct specialized PD diagnosis skill.
  • First Response Checklist: A step-by-step list of critical context to capture immediately when a PD incident occurs, including version records, recent operational changes, and impact scope.
  • Triage Hints & Common Commands: Quick guidance to identify the most likely root cause category, plus reference for common PD CLI commands to run during initial investigation.
  • Use Case: If your TiDB cluster is experiencing unexpected region eviction after a scatter operation, this Skill immediately directs you to the pd-scheduling specialized skill instead of wasting time searching for relevant documentation.

Quick Start

Use the pd-oncall-handbook skill to triage your active PD incident and receive a direct link to the specialized PD diagnosis skill matching your observed symptoms.

Frequently Asked Questions about pd-oncall-handbook

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

FAQPage Schema
How do I triage a TiDB PD incident during on-call?▼

Routing PD incidents involves mapping observed symptoms like placement rule failures or RU throttling to specialized diagnosis skills. This handbook provides a routing table and first-response checklist to guide on-call engineers quickly.

What is the first response checklist for a Placement Driver incident?▼

The first response checklist for a Placement Driver incident includes capturing critical context immediately: TiDB version records, recent operational changes, and the impact scope to establish a baseline for diagnosis.

How do I diagnose region scheduling issues after a scatter operation in TiDB?▼

Diagnosing unexpected region eviction after a scatter operation requires routing to the specialized pd-scheduling skill. This handbook maps region scheduling symptoms directly to the correct diagnosis workflow.

Does this PD on-call guide cover ETCD operations and TLS configuration troubleshooting?▼

Yes, the PD on-call guide covers ETCD operations, TLS configuration, resource control, and Dashboard troubleshooting. It applies to all incident response workflows for both control-plane and data-plane PD problems.

What are the common PD CLI commands for initial incident investigation?▼

Common PD CLI commands for initial incident investigation are provided as triage hints in this handbook. They help identify the likely root cause category quickly during the first-response phase of an active incident.

When should I use a PD triage handbook instead of searching documentation directly?▼

Use a PD triage handbook when you need to eliminate guesswork during active incidents. It provides a structured entry point that quickly maps observed symptoms to specialized diagnosis skills, reducing mean time to resolution.

Related Skills

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

pd-operations

Diagnose PD operational incidents with triage steps and documented workarounds.

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

pd-scheduling

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

Community
Intermediate
yaacovyaacov

check-ocp-health

Diagnose OpenShift cluster health issues and provide kubectl remediation commands.

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

pd-placement-rules

Diagnose PD placement rule, placement policy, and isolation label incidents in TiDB clusters.

Community
Intermediate