FR

Serveurs de jeux

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.

10 min de lecture, mis à jour le 18 novembre 2026

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, service fivem.service, console dans /home/fivem/fxserver.log
  • Un accès SSH avec sudo et un accès à txAdmin
  • Une sauvegarde récente, à faire avec sudo /usr/local/sbin/backup-fivem.sh avant 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 :

Terminal
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 :

Terminal
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 :

Terminal
sudo bash -c 'ls -t /home/fivem/fxserver-incident-*.log | head -n 1 | xargs tail -n 80'

Regardez aussi l'historique du service :

Terminal
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 :

Terminal
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 process apparaî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 :

Terminal
ps -u fivem -o pid,pcpu,pmem,rss,etime,args --sort=-rss | cut -c1-110

Une 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 :

Terminal
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 :

Terminal
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 :

Terminal
uptime
vmstat 1 10

Dans 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 :

Terminal
top -H -p PID

Un 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 :

Terminal
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 :

Texte
profiler record 500
profiler status

Attendez que profiler status indique Recording: No, puis enregistrez le résultat :

Texte
profiler saveJSON profil-serveur.json

Le 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 :

Terminal
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.json

Puis récupérez-le depuis votre ordinateur :

Terminal
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 :

Texte
resmon true

Triez 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 :

Texte
stop nom_de_la_ressource

Relancez-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 :

Terminal
sudo -u fivem cp /home/fivem/txData/NOM_DU_DOSSIER.base/server.cfg /home/fivem/txData/NOM_DU_DOSSIER.base/server.cfg.avant-diagnostic

Puis, en dehors des heures d'affluence :

  1. Dans CFG Editor, désactivez la moitié des ressources optionnelles en ajoutant # devant leur ligne ensure. Gardez le framework et ses dépendances.
  2. Redémarrez le serveur et essayez de reproduire le problème.
  3. Si le problème disparaît, il vient de la moitié désactivée. Sinon, il vient de celle qui reste active.
  4. 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 :

Terminal
sudo -u fivem cp /home/fivem/txData/NOM_DU_DOSSIER.base/server.cfg.avant-diagnostic /home/fivem/txData/NOM_DU_DOSSIER.base/server.cfg

Demander 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 -h et vmstat

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.