kubectl Describe Pod¶

Introduction¶

This guide explains kubectl describe pod with practical kubectl commands, realistic output, and production-focused checks. The examples focus on commands you can run during daily cluster administration and incident response.

When to Use This Command¶

Use it when you need to inspect, change, or verify Kubernetes resources without guessing. Prefer namespace-scoped commands unless you intentionally need cluster-wide output.

Basic Syntax¶

kubectl get pods -n app -o wide

Practical Examples¶

kubectl get pods -n app -o wide
kubectl describe pod web-7d9f8c-abcde -n app
kubectl logs web-7d9f8c-abcde -n app --previous
kubectl rollout status deployment/web -n app
kubectl get events -n app --sort-by=.lastTimestamp

Example output:

NAME                  READY   STATUS             RESTARTS   AGE
web-7d9f8c-abcde      0/1     CrashLoopBackOff   6          8m

Useful Options¶

• Use -n <namespace> to avoid checking the wrong namespace.
• Use -o wide, -o yaml, or -o json when default columns are not enough.
• Use label selectors for application-focused output.

Verification¶

kubectl get events -n app --sort-by=.lastTimestamp
kubectl get all -n app

Common Mistakes¶

• Running commands in the wrong context or namespace.
• Editing live resources without saving the manifest in version control.
• Ignoring events because the first kubectl output looks normal.

Production Tips¶

Check the current context before making changes, use dry-run where supported, and prefer declarative manifests for repeatable changes.

Related Guides¶

• kubectl Troubleshooting Cheat Sheet
• kubectl Logs Examples
• kubectl Events Troubleshooting

Summary¶

Good kubectl usage is precise: choose the right context, namespace, output format, and verification command before changing production workloads.