Guide to Troubleshooting Kubernetes Issues🚀

Guide to Troubleshooting Kubernetes Issues🚀

Table of contents

Common K8s Errors :-

  1. Error: Pods in Pending/Terminating/Waiting State

    • Err Message: PodPending

    • Issue Why ?

      • Container image unavailability

      • Network issues

      • Graceful shutdown

      • Finalizers

      • Stuck termination processes.

    • Resolution: kubectl describe po <pod_name>

  2. Error: Pod in ContainerCreating/CrashLoopBackOff/ImagePullBackOff

    • Err Message: CrashLoopBackOff

    • Issue :

      • Pod creation is stuck in the ContainerCreating state.

      • Pod keeps crashing and restarting in a loop

    • Resolution: 1. kubectl logs <pod-name> and

      2. kubectl describe po <pod_name>

  3. Error: Service not accessible

    • Err Message: ServiceUnavailable

    • Issue Why?

      • Could be because of, the network policies/firewalls blocking the access to service. OR

      • Service could not find pods matching its selector.

    • Resolution: 1. kubectl describe svc <service_name> and

      2. kubectl get endpoints <service_name>

  4. Error: Node status is NotReady

    • Err Message: NodeNotReady

    • Issue Why?

      • Due to resource constraints

      • Network connectivity issues

      • Kubelet failures

      • Node hardware failures.

    • Resolution: kubectl get no <node_name> and kubectl describe no <node_name>

  5. Error: Insufficient CPU or memory

    • Issue: Pods are unable to be scheduled due to insufficient CPU or memory resources.

    • Resolution: kubectl get po <pod_name> -o wide

      get the node name and check the resources left in the node and schedule the pod to some other node.

  6. Error: Ingress Or Load Balancer Issue

    • Err Message: IngressControllerFailed

    • Issue why?

      • Routing rule could be misconfigured.

      • Invalid SSL certificates

      • Incorrect host or path definitions

      • Networking problems between the ingress controller and backend services.

    • Resolution: kubectl describe ing <ingress_name>

  7. Error: Storage Issue

    • Err Message: PersistentVolumeClaimPending

    • Issue Why?

      • Misconfiguration of storage classes or PVCs
    • Resolution: 1.kubectl get pv and

      2. kubectl get pvc