Diagnostiquer les problèmes matériels et pilotes sous Linux avec dmesg¶

Contexte¶

Lorsque vous branchez un périphérique (disque dur, clé USB, carte réseau) ou que vous rencontrez un comportement anormal sur votre serveur ou votre poste de travail (déconnexions réseau intempestives, plantages de la carte graphique, erreurs disques), il n'y a souvent aucune notification visible. Le noyau Linux enregistre pourtant minutieusement tous ces événements. L'outil dmesg permet de lire ces enregistrements pour identifier la source du problème.

Prérequis¶

• Un accès en ligne de commande à un système Linux.
• Les droits sudo ou root (sur les distributions récentes, la lecture de dmesg est restreinte aux administrateurs pour des raisons de sécurité).

Utilisation de base¶

Étape 1 : Lire les messages récents¶

Par défaut, dmesg affiche tout l'historique depuis le démarrage, ce qui représente des centaines de lignes. Pour un diagnostic immédiat (par exemple après avoir branché une clé USB), on limite généralement la sortie aux dernières lignes.

sudo dmesg | tail -n 20

sudo dmesg -T | tail -n 20

Étape 2 : Suivre les événements en temps réel¶

Si vous souhaitez diagnostiquer un périphérique USB défectueux ou un câble réseau capricieux, le meilleur moyen est de suivre les logs du noyau en temps réel, puis de provoquer l'action (débrancher et rebrancher le câble/périphérique).

sudo dmesg -w

Étape 3 : Filtrer par type d'équipement¶

Pour retrouver une information noyée dans la masse, il est d'usage d'associer dmesg à grep. Voici quelques mots-clés classiques.

sudo dmesg | grep -i eth
sudo dmesg | grep -i enp

sudo dmesg | grep -i -E "sd[a-z]|nvme"
sudo dmesg | grep -i usb

sudo dmesg | grep -i memory
sudo dmesg | grep -i "out of memory"

Filtrage avancé intégré¶

Depuis les versions récentes, la commande dmesg possède ses propres options de filtrage, souvent plus propres que l'utilisation de grep.

Filtrer par niveau de criticité (log level). Très utile pour ne faire ressortir que les erreurs :

# Affiche uniquement les alertes critiques (emerg, alert, crit, err)
sudo dmesg --level=err,crit

# Affiche les erreurs et avertissements
sudo dmesg --level=err,warn

Filtrer par composant du noyau (facility). Par exemple pour voir uniquement les logs liés aux pilotes matériels :

sudo dmesg --facility=kern,daemon

Cas concrets de pannes (Problème / Solution)¶

Problème 1 : Périphérique non reconnu¶

Vous branchez une clé USB ou une carte Wi-Fi, mais elle n'apparaît pas dans vos interfaces.

[ 1234.567890] usb 1-1: new high-speed USB device number 5 using xhci_hcd
[ 1234.678901] usb 1-1: firmware: failed to load rtlwifi/rtl8192eu_nic.bin (-2)

Solution : Le matériel est physiquement détecté par le port USB, mais le système n'a pas le programme (firmware) pour le piloter. Vous devez installer le paquet contenant les firmwares non libres (ex: sudo apt install linux-firmware ou firmware-realtek sur Debian).

Problème 2 : Processus tué silencieusement (OOM)¶

Votre serveur web ou votre base de données s'arrête sans raison apparente et sans laisser d'erreur dans ses propres logs.

[  567.890123] Out of memory: Killed process 1234 (mysqld) total-vm:2105124kB, anon-rss:512000kB, file-rss:0kB

Solution : Le système a manqué de mémoire vive (RAM) et a fait intervenir le Out Of Memory Killer pour sacrifier le processus qui consommait le plus de mémoire afin de sauver le système d'exploitation. Vous devez augmenter la RAM, ajouter du swap, ou limiter la consommation du service.

Aide-mémoire¶

Ressources¶

• Manuel de la commande dmesg — Documentation officielle du manuel Linux.
• Documentation du Kernel Linux — Architecture et documentation avancée du noyau.