Troubleshooting Decision Map¶
Use this map to quickly route from an observed symptom to the relevant diagnostic playbook.
Symptom to Playbook Routing¶
flowchart TD
Start[Observed Symptom] --> PodIssues{Pod Issues?}
Start --> NodeIssues{Node Issues?}
Start --> ConnectivityIssues{Connectivity?}
Start --> OperationIssues{Operation Fail?}
PodIssues -->|CrashLoop| P1[CrashLoopBackOff Playbook]
PodIssues -->|Pending| P2[Pending Pods Playbook]
PodIssues -->|ImagePull| P3[Image Pull Failure Playbook]
NodeIssues -->|NotReady| N1[Node Not Ready Playbook]
NodeIssues -->|IP Exhaust| N2[CNI IP Exhaustion Playbook]
ConnectivityIssues -->|Ingress| C1[Ingress Failure Playbook]
ConnectivityIssues -->|Service| C2[Service Unreachable Playbook]
OperationIssues -->|Upgrade| O1[Upgrade Failure Playbook]
OperationIssues -->|Scaling| O2[Scaling Failure Playbook]
click P1 "../troubleshooting/playbooks/pod-issues/crashloop.md" "View Playbook"
click P2 "../troubleshooting/playbooks/pod-issues/pending-pods.md" "View Playbook"
click P3 "../troubleshooting/playbooks/pod-issues/image-pull-failure.md" "View Playbook"
click N1 "../troubleshooting/playbooks/node-issues/node-not-ready.md" "View Playbook"
click N2 "../troubleshooting/playbooks/node-issues/cni-ip-exhaustion.md" "View Playbook"
click C1 "../troubleshooting/playbooks/connectivity/ingress-failure.md" "View Playbook"
click C2 "../troubleshooting/playbooks/connectivity/service-unreachable.md" "View Playbook"
click O1 "../troubleshooting/playbooks/operations/upgrade-failure.md" "View Playbook"
click O2 "../troubleshooting/playbooks/operations/scaling-failure.md" "View Playbook"How to Read This Map¶
- Identify the category: Start by classifying your symptom into Pod, Node, Connectivity, or Operation categories.
- Refine the symptom: Follow the path that most closely matches the specific error message or behavior observed.
- Jump to the playbook: Click the node in the diagram or follow the links below to start the step-by-step diagnostic procedure.