Comment diagnostiquer les crashs et lenteurs d'un serveur FiveM
Trouvez la cause d'un crash ou d'un ralentissement sur votre serveur FiveM Linux : journaux, mémoire, hitch warnings, resmon, profiler et isolation de la ressource responsable.
Sur cette page
Vos valeurs
Renseignez-les une fois, les commandes du guide se mettent à jour.
Un serveur FiveM qui plante ou qui ralentit a souvent une cause précise : une ressource, un manque de mémoire ou une machine saturée. Ce guide vous donne une méthode pour trouver laquelle : qualifier le symptôme, lire les bons journaux, mesurer, puis isoler la ressource responsable.
Prérequis
- Un serveur installé avec le guide Créer un serveur FiveM : utilisateur
fivem, servicefivem.service, console dans/home/fivem/fxserver.log - Un accès SSH avec
sudoet un accès à txAdmin - Une sauvegarde récente, à faire avec
sudo /usr/local/sbin/backup-fivem.shavant de modifier quoi que ce soit
Qualifier le symptôme
| Ce que vous observez | Piste principale | Section à consulter |
|---|---|---|
| Le serveur redémarre seul, les joueurs sont tous déconnectés | Arrêt du processus ou blocage | Étapes 1 à 3 |
| Le serveur ne démarre plus ou s'arrête au chargement | Ressource ou configuration | Étape 4 |
| Les joueurs voient des saccades, des véhicules qui se téléportent | Serveur surchargé | Étapes 5 et 6 |
| Un seul joueur a peu d'images par seconde | Côté client | Étape 7 |
| Le problème a commencé après un ajout ou une mise à jour | Changement récent | Étape 8 |
Étape 1 : conserver les journaux
Le fichier /home/fivem/fxserver.log est vidé à chaque démarrage du service. Copiez-le avant de redémarrer quoi que ce soit :
sudo install -o fivem -g fivem -m 640 /home/fivem/fxserver.log "/home/fivem/fxserver-incident-$(date +%F_%H-%M).log"txAdmin garde aussi ses propres journaux, avec rotation, dans /home/fivem/txData/default/logs/ :
| Fichier | Contenu |
|---|---|
fxserver.log |
Console du serveur. Les anciens fichiers portent la date dans leur nom |
admin.log |
Actions des administrateurs et redémarrages automatiques |
server.log |
Événements en jeu : connexions, morts, messages, commandes |
Ces fichiers contiennent des données de joueurs. Ne les publiez pas tels quels.
Étape 2 : savoir pourquoi le serveur a redémarré
Cherchez les décisions prises par txAdmin :
sudo grep -a 'Restarting server' /home/fivem/txData/default/logs/admin.log | tail -n 20| Raison affichée | Signification | Que faire |
|---|---|---|
Server process close detected |
Le processus FXServer s'est arrêté | Regardez la fin de la console et la mémoire (étape 3) |
Server is not responding |
FXServer tourne mais ne répond plus | Recherchez un blocage : étapes 5 et 6 |
Server is taking too long to start |
Le démarrage dépasse le délai autorisé | Passez à l'étape 4 |
Resource "nom" failed to start within the ... time limit |
Cette ressource bloque le démarrage | Testez sans elle (étape 8) |
Lisez ensuite les dernières lignes de la console avant l'incident, dans la copie faite à l'étape 1 :
sudo bash -c 'ls -t /home/fivem/fxserver-incident-*.log | head -n 1 | xargs tail -n 80'Regardez aussi l'historique du service :
sudo systemctl status fivem.service --no-pager
sudo journalctl -u fivem.service --since "2 days ago" --no-pager | tail -n 40Étape 3 : vérifier la mémoire et le disque
Quand la mémoire manque, le noyau Linux tue un processus. Cherchez sa trace :
sudo journalctl -k --since "2 days ago" --no-pager | grep -iE 'out of memory|oom-kill|killed process'
free -h
df -h /home /var/lib/mysql- Une ligne
Out of memory: Killed processapparaît : le serveur manque de mémoire. Cherchez une ressource dont la consommation augmente, puis réduisez la charge ou augmentez la mémoire de la machine. - Un disque est plein à 100 % : libérez de la place. MariaDB et les journaux ne peuvent plus écrire.
Pour suivre la mémoire de FXServer dans le temps, relevez cette commande à plusieurs moments. txAdmin et le serveur de jeu apparaissent comme deux processus, le plus gros étant en général le serveur de jeu :
ps -u fivem -o pid,pcpu,pmem,rss,etime,args --sort=-rss | cut -c1-110Une colonne RSS qui grimpe sans jamais redescendre, alors que le nombre de joueurs reste stable, oriente vers une fuite de mémoire dans une ressource.
Étape 4 : analyser un démarrage qui échoue
Affichez les derniers événements de chargement :
sudo grep -a -E "Started resource|Could not (find|start) dependency|Couldn't (find|start) resource|can't run|Failed to load script|SCRIPT ERROR" /home/fivem/fxserver.log | tail -n 30| Message | Cause | Solution |
|---|---|---|
Couldn't find resource nom. |
Le dossier n'existe pas, ou le nom diffère de la ligne ensure |
Corrigez server.cfg ou le dossier, puis tapez refresh |
Couldn't start resource nom. |
Le démarrage a échoué | Lisez les lignes juste au-dessus |
Could not find dependency x for resource y. |
Il manque la ressource x |
Installez-la |
Could not start dependency x for resource y. |
La ressource x existe mais ne démarre pas |
Traitez d'abord x |
Resource 'nom' can't run: |
Une condition n'est pas remplie, par exemple server needs to be 12913 or higher |
Mettez à jour FXServer |
Failed to load script fichier. |
Fichier absent ou invalide | Réinstallez la ressource |
SCRIPT ERROR: |
Erreur dans le code d'un script | Le message indique le fichier et la ligne : mettez à jour ou signalez à son auteur |
Pour une erreur de base de données, consultez Installer et configurer oxmysql.
Étape 5 : repérer les ralentissements du serveur
FXServer signale les retards de ses boucles internes par des hitch warnings :
sudo grep -a -c 'hitch warning' /home/fivem/fxserver.log
sudo grep -a 'hitch warning' /home/fivem/fxserver.log | tail -n 20| Message | Déclenché à partir de | Concerne |
|---|---|---|
server thread hitch warning |
150 ms | Boucle principale, où s'exécutent les scripts serveur |
network thread hitch warning |
150 ms | Réseau |
sync thread hitch warning |
100 ms | Synchronisation OneSync |
Un avertissement isolé au démarrage ou lors d'un redémarrage de ressource n'est pas inquiétant. Des avertissements réguliers en jeu le sont. Cfx.re les attribue le plus souvent à une ressource peu performante, par exemple une boucle trop coûteuse ou une requête SQL lente.
Avant d'accuser une ressource, vérifiez que la machine n'est pas saturée :
uptime
vmstat 1 10Dans vmstat, regardez trois colonnes :
| Colonne | Valeur élevée |
|---|---|
id |
Faible : le processeur est presque entièrement occupé |
wa |
Le processeur attend le disque |
st |
Du temps processeur est pris par l'hyperviseur |
Regardez ensuite le détail des fils d'exécution, en remplaçant PID par le numéro du processus le plus gros relevé à l'étape 3. Quittez avec q :
top -H -p PIDUn seul fil proche de 100 % indique qu'une boucle du serveur est saturée, même si la machine a d'autres cœurs libres. Dans ce cas, ajouter des cœurs aide peu : il vaut mieux alléger les scripts. Si wa ou st restent élevés alors que le serveur est peu chargé, contactez le support depuis votre espace client, avec vos relevés.
Vérifiez aussi les requêtes lentes signalées par oxmysql :
sudo grep -a 'to execute a query' /home/fivem/fxserver.log | tail -n 20Étape 6 : enregistrer un profil du serveur
Le profiler intégré montre quelle ressource consomme le temps. Lancez-le dans Live Console pendant que le problème se produit, avec des joueurs connectés si possible :
profiler record 500
profiler statusAttendez que profiler status indique Recording: No, puis enregistrez le résultat :
profiler saveJSON profil-serveur.jsonLe fichier est créé dans le dossier du serveur, dont le nom se termine par .base. Sur le serveur, copiez-le dans votre dossier personnel, en remplaçant NOM_DU_DOSSIER :
sudo find /home/fivem/txData -maxdepth 1 -type d -name '*.base'
sudo install -o "$USER" -m 600 /home/fivem/txData/NOM_DU_DOSSIER.base/profil-serveur.json "$HOME/profil-serveur.json"
sudo rm /home/fivem/txData/NOM_DU_DOSSIER.base/profil-serveur.jsonPuis récupérez-le depuis votre ordinateur :
scp VOTRE_USER@IP_DU_SERVEUR:profil-serveur.json .Ouvrez Google Chrome, puis les outils de développement avec F12. Dans l'onglet Performance, chargez le fichier avec Load profile. Repérez les pics de la courbe d'activité, zoomez dessus, puis lisez le nom des ressources et des fonctions les plus longues.
Étape 7 : mesurer côté joueur avec resmon
resmon affiche le coût de chaque ressource sur le client. Il aide pour les baisses d'images par seconde, pas pour les retards du serveur.
Dans le jeu, ouvrez la console avec F8 et tapez :
resmon trueTriez par CPU msec ou Time % pour repérer les ressources coûteuses, et regardez Memory pour la mémoire. Tapez resmon false pour fermer.
Si la console répond Access denied for command resmon, le mode développeur n'est pas actif sur votre client. Lancez FiveM avec l'argument +set moo 31337. Avec FiveM pour GTA V Enhanced, cet argument n'existe plus et le serveur doit définir sv_devMode true.
La page Player Drops de txAdmin complète cette analyse : elle montre si les joueurs quittent le serveur à cause de crashs de leur jeu, et depuis quand.
Étape 8 : isoler la ressource responsable
Commencez par ce qui a changé récemment. Si rien n'a changé, procédez par moitiés.
Test rapide sur le serveur démarré
Pour une ressource secondaire, arrêtez-la dans Live Console puis observez les avertissements pendant une dizaine de minutes :
stop nom_de_la_ressourceRelancez-la ensuite avec ensure nom_de_la_ressource. N'arrêtez pas ainsi oxmysql, es_extended, qb-core ou une autre ressource dont beaucoup d'autres dépendent : vous provoqueriez des erreurs sans rapport avec le problème.
Recherche par moitiés
Faites d'abord une copie de la configuration, en remplaçant NOM_DU_DOSSIER :
sudo -u fivem cp /home/fivem/txData/NOM_DU_DOSSIER.base/server.cfg /home/fivem/txData/NOM_DU_DOSSIER.base/server.cfg.avant-diagnosticPuis, en dehors des heures d'affluence :
- Dans CFG Editor, désactivez la moitié des ressources optionnelles en ajoutant
#devant leur ligneensure. Gardez le framework et ses dépendances. - Redémarrez le serveur et essayez de reproduire le problème.
- Si le problème disparaît, il vient de la moitié désactivée. Sinon, il vient de celle qui reste active.
- Recommencez sur le groupe suspect, jusqu'à ne garder qu'une ressource.
Si plusieurs ressources sont lancées par un dossier, comme ensure [addons], remplacez temporairement cette ligne par une ligne ensure pour chacune d'elles. Une erreur Could not find dependency pendant le test signifie simplement que vous avez désactivé une dépendance : réactivez-la.
Une fois la ressource trouvée, mettez-la à jour, corrigez sa configuration ou signalez le problème à son auteur, avec votre profil et vos journaux. Remettez ensuite la configuration d'origine, puis redémarrez le serveur depuis txAdmin :
sudo -u fivem cp /home/fivem/txData/NOM_DU_DOSSIER.base/server.cfg.avant-diagnostic /home/fivem/txData/NOM_DU_DOSSIER.base/server.cfgDemander de l'aide
Pour un problème de ressource, adressez-vous à son auteur ou au forum Cfx.re. Préparez :
- la build de FXServer et la version de txAdmin, relevées comme dans Mettre à jour les artifacts FXServer
- le moment de l'incident et ce qui a changé juste avant
- les lignes de console concernées, le profil et les résultats de
free -hetvmstat
Cfx.re rappelle que la version Linux de FXServer est un portage proposé par commodité : si un défaut vient de FXServer lui-même, il a plus de chances d'être corrigé s'il est reproduit sous Windows. Vérifiez aussi qu'il persiste sur la dernière version recommandée avant de le signaler.
En cas de problème pendant le diagnostic
profiler saveJSON renvoie Invalid path
Utilisez un simple nom de fichier, sans dossier, et vérifiez que l'utilisateur fivem peut écrire dans le dossier du serveur.
A recording is already taking place
Un enregistrement est déjà en cours. Attendez sa fin avec profiler status, ou arrêtez-le avec profiler record stop.
Le fichier fxserver.log est vide
Le service vient de redémarrer. Utilisez /home/fivem/txData/default/logs/fxserver.log, ainsi que les fichiers datés du même dossier.
Le serveur redémarre en boucle pendant les tests
Arrêtez-le avec sudo systemctl stop fivem.service, remettez server.cfg.avant-diagnostic en place avec la commande ci-dessus, puis relancez le service avec sudo systemctl start fivem.service.