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

pd-operations

Diagnose PD operational incidents with triage steps and documented workarounds.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the guesswork and lengthy investigation time for PD-related operational incidents, enabling on-call engineers to quickly identify root causes and apply proven workarounds to restore service.

Core Features & Use Cases

  • Structured Triage Steps: Clear first checks to categorize incidents as ETCD, TLS, Dashboard, Prometheus scraping, or TSO-related, and distinguish between leader-only and cluster-wide degradation.
  • Documented Known Cases: Detailed breakdowns of common failure patterns including ETCD capacity exhaustion, TLS rollout breakage, Dashboard unavailability, PD leader CPU spikes from TSO pressure, and Prometheus metric scrape gaps, each with verified workarounds and related incident tickets.
  • Use Case Example: If your PD cluster loses service after ETCD backend usage exceeds its quota, this Skill provides the exact compaction, defragmentation, and alarm clearing steps to recover service without additional research.

Quick Start

Use the pd-operations skill to triage a PD leader CPU spike caused by TSO pressure and apply the recommended TSO follower proxy configuration change.

Frequently Asked Questions about pd-operations

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

FAQPage Schema
How do I fix ETCD capacity exhaustion in a TiDB PD cluster?▼

To fix ETCD capacity exhaustion, you must perform backend compaction and defragmentation on the PD cluster, followed by clearing the triggered alarms to restore normal service.

What causes PD leader CPU spikes during TSO processing?▼

PD leader CPU spikes are caused by TSO pressure, which you can resolve by applying a recommended TSO follower proxy configuration change to redistribute the processing load.

How do I troubleshoot Dashboard unavailability and Prometheus scrape gaps in PD?▼

Troubleshooting Dashboard unavailability and Prometheus scrape gaps involves structured triage steps to distinguish between leader-only and cluster-wide metric degradation, applying documented workarounds for the specific failure mode.

Why does a TLS rollout break PD cluster service?▼

TLS rollout breakage causes PD cluster service degradation because of configuration mismatches, requiring verified workarounds from past incident cases to restore secure connectivity.

Can I use documented incident cases for oncall TiDB PD troubleshooting?▼

You can use documented incident cases for oncall PD troubleshooting to quickly categorize failure patterns like ETCD exhaustion or TSO spikes and apply proven workarounds without extra research.

Related Skills

Explore More Software Engineering Skills→
redpanda-dataredpanda-data
6

sql-admin-api

Automate Oxla SQL cluster admin via API for TLS, logging, health checks, and Prometheus metrics on port 9090.

Official
Advanced
yaacovyaacov

check-ocp-health

Diagnose OpenShift cluster health issues and provide kubectl remediation commands.

Community
Advanced
Prompt-or-Die-LabsPrompt-or-Die-Labs
7

metrics-pipeline-builder

Design Prometheus and Grafana metrics pipelines with custom exporters.

Official
Intermediate
alex-quan-001alex-quan-001

tikv-cdc

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

Community
Intermediate