Liveness probe failed: HTTP probe failed with statuscode: 404
Proba de liveness cere o adresă pe care aplicația nu o are (404), iar kubelet-ul crede că aplicația s-a blocat și repornește containerul la nesfârșit. Corectează path-ul probei (de exemplu /health) și portul, ca să indice un endpoint care răspunde 200.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Proba de liveness întreabă periodic containerul dacă e „viu”. Pentru httpGet, orice cod între 200 și 399 înseamnă succes; 404, 500 sau lipsa răspunsului înseamnă eșec. După failureThreshold eșecuri la rând (implicit 3), kubelet-ul omoară containerul și îl repornește: în evenimente apare Container X failed liveness probe, will be restarted.
Un 404 înseamnă că aplicația răspunde, deci e sănătoasă, dar nu are calea cerută. E o greșeală de configurare: path scris greșit (/sanatate în loc de /health), alt prefix (/api/health), sau o aplicație care și-a schimbat endpoint-ul într-o versiune nouă.
Simptomul arată ca un crash: restarturi și CrashLoopBackOff, dar jurnalul aplicației e curat, iar ultimul lucru din el e o pornire reușită.
De ce apare: cauzele frecvente
1Path greșit
livenessProbe:
httpGet:
path: /sanatate
port: 8080 livenessProbe:
httpGet:
path: /health
port: 8080Aplicația are /health; /sanatate dă 404.
2Lipsește prefixul aplicației
path: /health # aplicația servește sub /api path: /api/healthPath-ul trebuie să fie exact cel la care răspunde aplicația.
3Probă care verifică dependențele
path: /api/produse # interoghează baza de date path: /health # doar procesulDacă proba depinde de baza de date, o problemă a bazei repornește toate podurile fără motiv.
Repară eroarea, direct în pagină
Deploymentul vitrina (academia/magazin:v1, ascultă pe 8080) al unui magazin de flori are o probă de liveness pe /sanatate, iar podurile repornesc continuu. Confirmă din evenimente motivul și schimbă path-ul probei în /health din ~/k8s/vitrina.yaml, apoi aplică fișierul.
Indiciu
Evenimentul Unhealthy arată codul primit; aplicația are endpoint-ul /health.
Reparația
Evenimentele probei:
kubectl get pods -l app=vitrina
kubectl describe pod -l app=vitrina | grep -E 'Unhealthy|Killing' | tail -2NAME READY STATUS RESTARTS AGE
vitrina-wgfv5dxrm2-9gv8r 1/1 Running 2 (25s ago) 63s
Warning Unhealthy 4s (x7 over 60s) kubelet Liveness probe failed: HTTP probe failed with statuscode: 404
Normal Killing 27s (x2 over 50s) kubelet Container vitrina failed liveness probe, will be restartedPath-ul corect:
sed -i 's#path: /sanatate#path: /health#' vitrina.yaml
kubectl apply -f vitrina.yaml
kubectl rollout status deploy/vitrinadeployment.apps/vitrina configured
Waiting for deployment "vitrina" rollout to finish: 1 old replicas are pending termination...
deployment "vitrina" successfully rolled outDe ce merge
Aplicația răspunde, dar nu are /sanatate, deci fiecare verificare primește 404. După trei eșecuri kubelet-ul consideră containerul blocat și îl repornește, la nesfârșit. Cu /health, proba primește 200, iar containerul rămâne pornit. Codul aplicației nu avea nicio problemă: eroarea era doar în configurația probei.
Alte forme ale mesajului
Normal Killing kubelet Container lv failed liveness probe, will be restartedLiveness probe failed: HTTP probe failed with statuscode: 500
Cum o eviți pe viitor
- Testează endpoint-ul probei din cluster înainte:
kubectl exec POD -- wget -qO- localhost:8080/health. - Fă proba de liveness simplă: răspunde dacă procesul funcționează, fără să verifice baze de date sau alte servicii.
- Folosește un
initialDelaySecondssau o startupProbe pentru aplicațiile care pornesc greu. - Documentează endpoint-urile de sănătate ale fiecărui serviciu.
Întrebări frecvente
Cum deosebesc un crash de o probă eșuată?
La o probă eșuată, evenimentele arată Unhealthy și failed liveness probe, will be restarted, iar jurnalul aplicației nu are nicio eroare. La un crash, jurnalul anterior arată eroarea, iar Last State are codul aplicației.
Care e diferența față de readiness?
Liveness repornește containerul. Readiness doar îl scoate din Service (podul apare 0/1), fără restart.
Erori înrudite
Readiness probe failed: HTTP probe failed with statuscode: 404 Proba de readiness cere o cale pe care aplicația nu o are, așa că podul rămâne 0/1 și nu primește trafic din Service, deși containerul rulează. Corectează path-ul (de exemplu /ready) ca să indice endpoint-ul real de pregătire. Liveness probe failed: Get "http://10.244.2.9:8080/health": dial tcp 10.244.2.9:8080: connect: connection refused Proba de liveness eșuează înainte ca aplicația să termine pornirea, iar kubelet-ul o repornește la nesfârșit, așa că nu apucă niciodată să pornească. Pentru aplicații lente adaugă o startupProbe (de exemplu failureThreshold 30 × periodSeconds 5) sau corectează portul dacă e greșit. Back-off restarting failed container api in pod api-6d8f7c9b5-x2kq9_default Containerul pornește și se oprește iar și iar, iar kubelet-ul așteaptă tot mai mult între reporniri (CrashLoopBackOff). Cauza e aproape mereu în jurnalul rulării care a căzut: kubectl logs POD --previous. Repară configurarea sau codul care face procesul să iasă. Învață Kubernetes de la zero, cu exerciții la fiecare lecție
Curs Kubernetes: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.
