Utiliser le décodeur d'erreurs : récupérer ses logs et les comprendre

Le décodeur d’erreurs lit vos logs et fait le tri : ce qui est grave, ce qui est à corriger, et ce qui n’est que du bruit. Le plus difficile est souvent de récupérer les bons logs : voici comment.

1. Récupérer les logs

Une application précise (la plus fréquente) :

cd /opt/stacks/<application>
sudo docker compose logs --tail 200 --no-color

Un conteneur par son nom :

sudo docker logs --tail 200 vaultwarden 2>&1

Le 2>&1 est important : beaucoup d’applications écrivent leurs erreurs sur un canal séparé, que la commande seule n’affiche pas.

Le reverse proxy, quand un site ne s’affiche pas ou que le HTTPS ne marche pas :

sudo docker logs --since 1h traefik 2>&1      # ou caddy

Le système (Docker lui-même, SSH, mises à jour) :

sudo journalctl -p warning --since -2h --no-pager
sudo journalctl -u docker --since -24h --no-pager

Une erreur dans le navigateur (« Bad Gateway », « 404 page not found », « trop de redirections ») : copiez simplement le texte affiché.

2. Copier depuis le terminal

• Windows Terminal / PowerShell : sélectionnez avec la souris, puis clic droit (ou Ctrl + C).
• Mac (Terminal) : sélectionnez, puis Cmd + C.
• Beaucoup de lignes : envoyez-les dans un fichier, puis affichez-le page par page, ou récupérez-le sur votre ordinateur.

sudo docker compose logs --tail 500 --no-color > ~/logs.txt

3. Coller et analyser

Collez dans la zone de gauche et cliquez sur Analyser. Le décodeur :

1. retire les couleurs et les espaces parasites ;
2. reconnaît chaque ligne connue et compte ses répétitions ;
3. trie le résultat : Grave en premier, puis À corriger, puis Sans gravité ;
4. montre une ligne d’exemple, la première chose à faire, et un lien vers la fiche complète.

Rien n’est envoyé : vous pouvez même couper internet avant de cliquer.

4. Lire le résultat

• Grave : c’est probablement la cause de votre problème. Commencez par là, ouvrez la fiche complète.
• À corriger : pas forcément la cause, mais ça finira par poser problème.
• Sans gravité : du bruit normal. Les robots qui cherchent des failles produisent des centaines de lignes d’erreur par jour sur n’importe quel serveur. Le décodeur vous le dit pour que vous arrêtiez de vous en inquiéter.

Si tout est « Sans gravité » mais que quelque chose ne marche pas, la cause est ailleurs : regardez les logs d’un autre conteneur (la base de données, le reverse proxy).

5. Une erreur inconnue ?

Les lignes qui contiennent « error », « failed », « denied »… sans être reconnues sont listées sous Lignes suspectes non reconnues. Pour les chercher sur internet :

• gardez la partie spécifique du message, sans la date, l’adresse IP ni les numéros ;
• ajoutez le nom de l’application : "vaultwarden" "Error loading config" ;
• cherchez dans les tickets GitHub de l’application (onglet Issues) : quelqu’un a souvent eu le même problème.

6. Avant de partager des logs

Sur un forum ou dans un chat d’aide, masquez :

• les mots de passe et jetons (password=, token=, key=, adresses de webhook) ;
• vos noms de domaine et adresses IP si vous préférez rester discret.

Le décodeur, lui, ne voit rien de tout ça : il travaille dans votre navigateur.

Aller plus loin

• Diagnostiquer une application : la méthode en 6 étapes
• Le contrôle technique du serveur, pour les problèmes qui ne sont pas encore dans les logs

Une commande qui ne marche pas, une explication pas claire ? Signaler une erreur dans cette page.