Comment lire les journaux de serveur et les rapports de plantage
Trouve la ligne qui compte dans le journal d'un serveur de jeu : les niveaux de journalisation, les traces d'appels, la règle de la première erreur, et où vivent les journaux et les rapports de plantage dans ton panneau.
5 min de lecture · Mis à jour le 21 oct. 2026 · Par GuavaHost Team
Quand un serveur plante ou refuse de démarrer, la raison est presque toujours écrite dans son journal. Les journaux ont l'air intimidants, mais tu as rarement besoin de tout comprendre : tu as besoin de trouver une seule ligne. Ce guide te montre comment lire une ligne de journal, ce que veulent dire les niveaux, comment lire une trace d'appels, et où vivent les journaux et les rapports de plantage dans ton panneau.
Anatomie d'une ligne de journal
Voici une ligne typique d'un serveur Minecraft :
[14:02:11] [Server thread/INFO]: Done (8.412s)! For help, type "help"
[14:02:11]est l'heure. C'est l'horloge du serveur, qui peut ne pas correspondre à ton fuseau horaire.Server threadindique quelle partie du programme a écrit la ligne. Le thread du serveur est la boucle de jeu principale.INFOest le niveau : à quel point la ligne est grave.- Tout ce qui suit les deux points est le message.
D'autres jeux formatent leurs lignes différemment, mais presque tous incluent une heure, un niveau et un message quelque part.
Les niveaux de journalisation
| Niveau | Signification | Faut-il s'inquiéter ? |
|---|---|---|
| DEBUG ou TRACE | Détail fin destiné aux développeurs | Généralement masqué ; à ignorer |
| INFO | Activité normale : démarrage, connexions, sauvegardes | Non |
| WARN | Quelque chose cloche, mais le serveur continue | Parfois ; beaucoup d'avertissements sont du bruit inoffensif |
| ERROR | Quelque chose a échoué | Oui, si cela coïncide avec ton problème |
| FATAL ou SEVERE | Le serveur ne peut pas continuer | Oui, c'est généralement le plantage lui même |
Ne cours pas après chaque avertissement. Une foule de serveurs en pleine forme affichent les mêmes avertissements inoffensifs à chaque démarrage. Concentre toi sur les erreurs qui surviennent au moment où ton problème survient.
La règle de la première erreur
Un seul vrai problème provoque souvent une pile d'erreurs derrière lui, à mesure que d'autres parties du serveur trébuchent sur la première défaillance. La dernière erreur à l'écran est généralement un symptôme. La première erreur après la dernière ligne qui semblait normale est généralement la cause.
- Trouve la dernière ligne où tout avait l'air normal.
- Descends jusqu'à la première occurrence de
ERROR,ExceptionouFATAL. - Corrige celle là, redémarre, et relis. Si le serveur va maintenant plus loin avant d'échouer, tu progresses.
Lire une trace d'appels
Une trace d'appels est la liste des étapes que le programme était en train de suivre quand il a échoué. En voici une courante, issue d'un serveur Minecraft à plugins :
[12:40:03 ERROR]: Error occurred while enabling ExampleShop v2.1 (Is it up to date?)
java.lang.NoClassDefFoundError: net/milkbowl/vault/economy/Economy
at com.example.shop.ShopPlugin.onEnable(ShopPlugin.java:57)
...
Caused by: java.lang.ClassNotFoundException: net.milkbowl.vault.economy.Economy
Comment la lire :
- La première ligne dit ce qui a échoué : le plugin ExampleShop n'a pas pu démarrer.
- Le type d'exception dit pourquoi :
NoClassDefFoundErrorsignifie qu'il avait besoin de code qui n'est pas là. - Les lignes
atmontrent où. Cherche un nom que tu reconnais, comme celui du plugin lui même, plutôt que les entrailles du jeu. Caused byest la racine. Quand une trace en contient plusieurs, le dernierCaused byest généralement la vraie raison. Ici, une classe de Vault est absente : le correctif est donc d'installer le plugin Vault dont cette boutique dépend.
Les erreurs courantes et ce qu'elles veulent dire
| Ce que tu vois | Cela veut généralement dire |
|---|---|
NoClassDefFoundError, ClassNotFoundException | Une dépendance manquante, ou un plugin ou mod destiné à une autre version |
NoSuchMethodError | Quelque chose conçu pour une autre version du jeu |
OutOfMemoryError | Le serveur n'a plus de RAM |
FAILED TO BIND TO PORT ou Address already in use | Le port est pris, souvent par une deuxième copie encore en cours |
found character '\t' that cannot start any token | Une tabulation dans un fichier de configuration YAML ; le YAML n'accepte que des espaces |
NullPointerException | Un bug, ou une valeur de configuration manquante ou mal orthographiée |
Les rapports de plantage
Certains jeux écrivent un rapport séparé et plus détaillé quand ils plantent.
- Minecraft les enregistre dans le dossier
crash-reports, nommés avec la date et l'heure. Près du haut, tu trouveras une ligneDescriptionet l'exception. Les serveurs moddés listent chaque mod chargé, et les rapports de Forge et NeoForge pointent souvent vers un mod suspect. - Un plantage de Java qui emporte Java lui même laisse un fichier
hs_err_pid(suivi d'un numéro) dans le dossier principal du serveur. Ceux là désignent généralement la mémoire ou une bibliothèque native plutôt qu'un plugin.
Où vivent les journaux dans ton panneau
L'onglet Console affiche la sortie en direct. Il ne garde que les lignes récentes : pour tout ce qui est plus ancien, ouvre les fichiers de journal dans l'onglet Files (fichiers) ou télécharge les par SFTP.
| Jeu | Où regarder |
|---|---|
| Minecraft Java | logs/latest.log ; les journaux plus anciens sont des fichiers .log.gz dans logs (à télécharger et décompresser) ; les plantages dans crash-reports |
| Valheim avec BepInEx | BepInEx/LogOutput.log |
| ARK: Survival Evolved et Ascended | ShooterGame/Saved/Logs/ShooterGame.log |
| Don't Starve Together | server_log.txt dans DoNotStarveTogether/config/server/Master et .../Caves, un par shard |
| Enshrouded | Le dossier défini par logDirectory dans enshrouded_server.json, logs par défaut |
| Autres jeux | Ce que la Console a affiché ; cherche aussi un dossier logs ou Logs, ou des fichiers finissant par .log |
Quand le panneau signale un plantage
Si le processus du serveur s'arrête de façon inattendue, le panneau peut afficher son propre message indiquant que le serveur a planté, accompagné d'un code de sortie. Quelques uns valent la peine d'être connus :
- 0 : un arrêt normal.
- 1 : le jeu a quitté à cause d'une erreur ; lis les lignes juste au dessus.
- 137 : le processus a été tué de force, généralement pour avoir dépassé sa limite de mémoire. Voir les signes qu'un serveur manque de RAM.
- 139 : un plantage natif à l'intérieur du jeu lui même.
Chercher dans un long journal
- Télécharge le journal et ouvre le dans un éditeur de texte.
- Utilise la recherche (Ctrl+F, ou Cmd+F sur un Mac) pour
ERROR, puisException, puisCaused by. - Cherche le nom du dernier plugin ou mod que tu as ajouté.
- Fais correspondre les horodatages au moment où le problème est arrivé.
Demander de l'aide avec un journal
Copie depuis la dernière ligne normale jusqu'à la fin de la première erreur, et colle le texte plutôt qu'une capture d'écran. Avant de le partager où que ce soit, enlève les mots de passe, les jetons et tout ce qui est privé. Apporte le ensuite sur notre Discord, où l'équipe pourra le lire avec toi. Pour les problèmes de démarrage en particulier, voir serveur bloqué au démarrage.
Toujours bloqué ? Rejoins notre Discord sur discord.gg/GuavaHost et l'équipe t'aidera.
- logs
- crash report
- stack trace
- console
- troubleshooting
- errors
Toujours besoin d'aide ? Notre équipe est en ligne 24h/24 et 7j/7 pour répondre à tes questions.