pod-failure-diagnosis

Classify Kubernetes pod failure modes and output remediation commands.

71|88|Updated Nov 8, 2023
One-click install
npx skills add https://github.com/openshift/lightspeed-service --skill pod-failure-diagnosis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pod-failure-diagnosis
Source: https://github.com/openshift/lightspeed-service/tree/main/skills/pod-failure-diagnosis
Command: npx skills add https://github.com/openshift/lightspeed-service --skill pod-failure-diagnosis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Kubernetes/OpenShift pods can fail in various ways, and triaging them manually is time-consuming. This skill provides a structured, repeatable approach to identify root causes and propose remediation.

Core Features & Use Cases

  • CrashLoopBackOff triage: analyze current and previous container logs and pod events to determine why a container restarts.
  • ImagePullBackOff triage: verify image references, registry access, and imagePullSecrets to resolve image pull issues.
  • Pending / Init:Error triage: inspect scheduling constraints, resource requests, taints, node selectors, and PVC binding when a pod cannot start.
  • Remediation guidance: output concrete commands or manifest changes to fix the issue, with safety warnings for destructive actions.
  • Context awareness: applies across OpenShift and Kubernetes clusters, namespaces, and common workload scenarios.

Quick Start

Triaging a non-running pod: collect status and events, identify the failure mode, and provide actionable remediation steps.

Frequently Asked Questions about pod-failure-diagnosis

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

FAQPage Schema
How do I diagnose CrashLoopBackOff and ImagePullBackOff errors in Kubernetes?

To diagnose CrashLoopBackOff and ImagePullBackOff errors in Kubernetes, analyze container logs, pod events, and image pull secrets to classify the failure mode and identify the root cause before applying remediation steps.

Why does my OpenShift pod stay in Pending or Init:Error status?

A pod stays in Pending or Init:Error status in OpenShift when scheduling constraints, resource requests, taints, node selectors, or PVC binding issues prevent it from starting on an available node.

What is the best way to triage Kubernetes pod failures across multiple namespaces?

The best way to triage Kubernetes pod failures across namespaces is to automate the collection of pod status APIs, recent events, and container logs to systematically classify failure modes and recommend remediation.

Can I get concrete remediation commands for OpenShift pod failures?

Yes, you can get concrete remediation commands for OpenShift pod failures by analyzing the pod's status and events to generate structured fix steps, including safety warnings for any destructive actions required.

Does pod failure diagnosis work with both Kubernetes and OpenShift deployments?

Yes, pod failure diagnosis works with both Kubernetes and OpenShift deployments, applying context-aware analysis to workloads across clusters and namespaces to determine root causes and provide remediation guidance.

What do I need to access before troubleshooting a pod stuck in ImagePullBackOff?

To troubleshoot a pod stuck in ImagePullBackOff, you need access to pod status APIs, recent cluster events, and container logs to verify image references, registry access, and imagePullSecrets configuration.