Comment vérifier les erreurs dans les journaux txAdmin
txAdmin conserve trois types de fichiers journaux persistants dans le txData/ /journaux/ Répertoire : journaux d'administration pour les actions administratives, journaux fxserver pour les sorties console et journaux serveur pour les événements en jeu. Ces journaux sont essentiels pour diagnostiquer les problèmes de serveur, suivre les activités des joueurs et surveiller les performances du système.
Public cible: Administrateurs du serveur FiveM en utilisant txAdmin v4.6.0 ou plus récent avec des capacités de rotation des journaux.
Types et emplacements des journaux
Structure du fichier
txData/ └── / └── journaux/ ├── admin/ ├── fxserver/ └── serveur/
Catégories de journaux
Journaux d'administration (administrateur/) Contient le journal des actions administratives ainsi que certaines actions automatisées comme les redémarrages du serveur, les interdictions, les avertissements, les modifications de paramètres et les saisies en direct sur la console. N'enregistre pas les adresses IP des utilisateurs, sauf celles des points d'authentification.
Journaux FXServer (fxserver/) Contient le journal de toutes les opérations effectuées dans la console fxserver (stdin, stdout, stderr). Toute entrée de console active est préfixée par >.
Journaux du serveur (serveur/) Contient toutes les actions qui se produisent à l'intérieur du serveur, par exemple rejoindre/quitter/mourir un joueur, les messages de discussion, les explosions, les événements de menu, les commandes.
Accès au journal de l'interface Web
Méthode 1 : Console en direct
- Accédez à votre panneau Web txAdmin à
http://votre-ip-serveur:port - Accéder à Console en direct dans la barre latérale
- Surveillez les activités du serveur en temps réel, les avertissements et les messages d'erreur pour résoudre les problèmes de débogage
- Rechercher les entrées marquées avec
[ERREUR],[AVERTIR], ou[CRITIQUE]
Méthode 2 : Visionneuse de journaux du serveur
- Aller à Journal du serveur dans le menu latéral
- Surveillez toutes les activités sur le serveur, y compris les connexions des joueurs, les messages de discussion, les décès de jeu, les actions de menu, les commandes exécutées et les événements système
- Utilisez les options de filtrage pour isoler les messages d'erreur
- Exporter les sections du journal pour une analyse détaillée
Méthode 3 : Journal des actions
- Accéder à Paramètres → Diagnostic
- Afficher le journal des actions, qui enregistre toutes les actions effectuées par txAdmin ou tout administrateur
- Rechercher les actions administratives ayant échoué ou les erreurs système
Accès aux journaux basés sur des fichiers
Lecture directe de fichiers
# Accédez au répertoire des journaux cd txData/ /logs/ # Afficher les erreurs récentes dans les journaux fxserver tail -100 fxserver/fxserver-YYYY-MM-DD.log | grep -i error # Rechercher des modèles d'erreur spécifiques grep -r "ERROR\|WARN\|CRITICAL" ./ # Surveiller les journaux en temps réel tail -f fxserver/fxserver-$(date +%Y-%m-%d).log
Convention de dénomination des fichiers journaux
- Les fichiers suivent le modèle :
-AAAA-MM-JJ.log - Exemple:
fxserver-2025-06-10.log
Modèles d'erreur courants
Erreurs de chargement des ressources
[ERREUR] Échec du démarrage de la ressource « resource_name » [ERREUR] Impossible de charger les métadonnées de la ressource pour resource_name [AVERTISSEMENT] La ressource resource_name utilise une syntaxe obsolète
Problèmes de connexion à la base de données
[ERREUR] La connexion MySQL a échoué [ERREUR] Impossible d'exécuter la requête [AVERTISSEMENT] La connexion à la base de données a expiré
Erreurs liées aux joueurs
Les sources des joueurs sont conservées au format [mutex#id] nom où le mutex est un identifiant de l'exécution de ce serveur. Rechercher [mutex#id] pour trouver le joueur initial, rejoignez-le avec tous les identifiants.
Problèmes de mémoire et de performances
[AVERTISSEMENT] Utilisation élevée de la mémoire détectée [ERREUR] Délai d'expiration du script dans resource_name [CRITIQUE] Surcharge du serveur détectée
Configuration du journal
Paramètres de rotation
Modifiez votre txData/ /config.json et ajoutez un objet à l'intérieur du logger avec la clé étant l'une des [admin, fxserver, serveur]. Configurez les options de rotation en fonction de la référence de la bibliothèque de flux de fichiers rotatifs.
Exemple de configuration :
{ "logger": { "fxserver": { "size": "10M", "interval": "1d", "compress": "gzip" } } }
Journalisation détaillée
Ensemble txAdminVerbose à vrai pour imprimer sur la console des informations plus détaillées sur les erreurs et les événements :
# Windows ./FXServer.exe +set txAdminVerbose true # Linux ./run.sh +set txAdminVerbose true
Dépannage de problèmes spécifiques
txAdmin ne répond pas
Si vous obtenez «FXServer ne répond pas !Cela signifie que txAdmin:Monitor n'a pas pu se connecter au FXServer. Les causes possibles sont les suivantes :
- FXServer bloqué sur une ressource
- Conflits de ports entre FXServer et txAdmin
- Le contrôle de santé renvoie des erreurs 404
Problèmes d'autorisation
Si vous obtenez le message « Impossible de lire le fichier », le fichier d'administration txData/admins.json n'existe pas ou txAdmin n'a pas l'autorisation de le lire.
Erreurs de chargement du profil
Le profil sélectionné ne peut pas être chargé en raison de problèmes d'autorisation ou de JSON cassé.
Supprimez les fichiers corrompus et redémarrez txAdmin pour régénérer.
Bonnes pratiques
- Examen régulier du journal: Vérifiez les journaux quotidiennement pour détecter les avertissements accumulés
- Surveillance automatisée: Configurer des alertes pour les modèles d'erreur critiques
- Conservation des journaux: Configurer la rotation appropriée en fonction de l'activité du serveur
- Journaux de sauvegarde: Inclure les répertoires de journaux dans les procédures de sauvegarde
- Corrélation d'horodatage:Utilisez des horodatages pour corréler les événements entre différents types de journaux
- Assurez-vous que la configuration de votre serveur est correcte : Tutoriel Server.cfg
Ressources externes
- Documentation officielle de txAdmin – Référence principale pour les fonctionnalités et la configuration de txAdmin
- Référentiel txAdmin GitHub – Code source et suivi des problèmes
- Manuel du serveur FiveM – Guide complet de configuration du serveur
Note d'incertitude: Les spécifications du format du journal peuvent varier entre les versions de txAdmin ; vérifiez toujours par rapport à votre version installée.
La surveillance systématique des journaux via l'interface Web de txAdmin et l'accès direct aux fichiers permettent une identification proactive des problèmes de serveur avant qu'ils n'affectent l'expérience du joueur.






