Enquêter sur un pod : commandes et symptômes

Quand un pod ne se comporte pas comme attendu, une séquence de commandes kubectl permet de rapidement cerner la cause. Cette page liste les commandes essentielles et une grille de lecture des symptômes les plus courants.

Commandes de base pour investiguer

Lister les pods avec détails

kubectl get pods -n <ns> -o wide

Décrire le pod et ses événements

kubectl describe pod <pod> -n <ns>

Consulter les logs récents

kubectl logs <pod> -n <ns> --tail=200

Consulter les logs du conteneur précédent (après un crash)

kubectl logs <pod> -n <ns> --previous

Voir la consommation de ressources

kubectl top pod <pod> -n <ns>

Lister les événements récents du namespace

kubectl get events -n <ns> --sort-by=.lastTimestamp | tail -30

Grille de symptômes et pistes

Symptôme	Piste à suivre
CrashLoopBackOff	Consultez les logs du conteneur précédent avec `--previous`. Vérifiez ensuite les variables d’environnement, les secrets et l’état de la base de données.
OOMKilled	Le pod dépasse sa limite mémoire. Augmentez la limite ou optimisez la consommation du conteneur.
ImagePullBackOff	Vérifiez le tag de l’image et la validité du secret `argo-pull` pour l’authentification au registre.
Pending	Vérifiez les ressources disponibles (CPU/mémoire), l’état des volumes persistants et les règles d’affinity/anti-affinity.
Redémarrages fréquents en Running	La `livenessProbe` est peut-être trop stricte, ou le programme subit une fuite mémoire qui finit par le tuer.

Commencez toujours par kubectl describe pod : il affiche les événements Kubernetes, les conditions, les restarts et les raisons de l’état actuel en un seul bloc.

Si un pod est en CrashLoopBackOff, les logs actuels (kubectl logs sans --previous) peuvent être vides ou incomplets. Pensez systématiquement à ajouter --previous pour voir ce qui a provoqué le dernier crash.

Outillage

Observabilité

Surveillance quotidienne

Catalogue applicatif

Stack de supervision

Commandes de base pour investiguer

Grille de symptômes et pistes

​Commandes de base pour investiguer

​Grille de symptômes et pistes

Commandes de base pour investiguer

Grille de symptômes et pistes