> ## Documentation Index
> Fetch the complete documentation index at: https://infra-docs.kaeyros.org/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Commandes kubectl pour investiguer un pod et grille de lecture des symptômes les plus fréquents.

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

```bash Lister les pods avec détails theme={null}
kubectl get pods -n <ns> -o wide
```

```bash Décrire le pod et ses événements theme={null}
kubectl describe pod <pod> -n <ns>
```

```bash Consulter les logs récents theme={null}
kubectl logs <pod> -n <ns> --tail=200
```

```bash Consulter les logs du conteneur précédent (après un crash) theme={null}
kubectl logs <pod> -n <ns> --previous
```

```bash Voir la consommation de ressources theme={null}
kubectl top pod <pod> -n <ns>
```

```bash Lister les événements récents du namespace theme={null}
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. |

> [!TIP]
>
> 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.

> [!WARNING]
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.