Course contentsShow
← Cloud and Infrastructure
Lesson 1232 of 2,98924. Kubernetes NetworkingFree lesson

Ingress Troubleshooting

Debug common Ingress issues by checking controller logs, resource status, and backend Service connectivity.

Ingress Troubleshooting

You'll learn how to systematically diagnose and fix common issues when your Ingress resources aren't routing traffic correctly.

Understanding Ingress Problems

When your Ingress isn't working, you're essentially dealing with a broken signpost system. Traffic arrives at your cluster's entrance, but something prevents it from reaching the right destination. The issue could be at the controller level (the traffic director), the Ingress resource itself (the routing rules), or the backend Services (the actual destinations).

The Three-Layer Debug Approach

1. Check Ingress Controller Logs

Your first stop should always be the Ingress controller's logs. It's like checking the security guard's logbook:

kubectl logs -n ingress-nginx deployment/ingress-nginx-controller

Look for errors about certificate problems, backend failures, or configuration parsing issues.

2. Inspect Ingress Resource Status

Verify your Ingress resource is properly configured:

kubectl describe ingress my-ingress

Check that the Address field shows an IP, rules are listed correctly, and there are no warning events at the bottom.

3. Test Backend Service Connectivity

Your Ingress might be fine, but the Service it points to could be broken:

kubectl get endpoints my-service
kubectl get service my-service

Ensure the Service has ready endpoints. An empty endpoints list means no Pods match the Service selector—your traffic has nowhere to go.

Common Issues Checklist

  • No address assigned: Controller might not be running
  • 404 errors: Path or host rules don't match your request
  • 503 errors: Backend Service or Pods are down
  • Certificate warnings: TLS Secret missing or misconfigured

Key Takeaway: Ingress troubleshooting follows a top-down approach—check controller health first, then Ingress resource configuration, and finally backend Service connectivity and endpoints.