Comment trouver et lire les journaux txAdmin

Utilisez la sortie console FXServer de txAdmin pour les erreurs de ressources et son journal d'actions administratives pour les actions du personnel. Enregistrez d'abord l'heure de l'incident et le profil actif afin de rechercher le bon serveur et la bonne génération de journaux.

Trouver le journal pertinent

Ouvrez le panneau txAdmin actif en utilisant votre route d'administration sécurisée normale. Examinez la console en direct pour les erreurs de démarrage et de ressources. Utilisez les vues d'événements joueur/serveur et les enregistrements d'actions à leurs fins distinctes ; un événement de jeu n'est pas nécessairement une exception de script.

Pour les journaux stockés, localisez le répertoire txData et le profil actif utilisé par votre lanceur. Les catégories de journaux, les noms de fichiers et la configuration peuvent changer selon la version de txAdmin. Vérifiez la documentation/source officielle de txAdmin avant de vous fier à un ancien chemin ou à un extrait JSON de logger.

Rechercher une fenêtre de temps étroite

1. Enregistrez l'heure UTC, le nom de la ressource, l'action du joueur et les modifications de déploiement récentes. Notez le fuseau horaire local si le journal en utilise un.
2. Recherchez la première occurrence de la ressource ou de l'erreur près de cette heure. Incluez les lignes précédentes et la trace complète.
3. Comparez les messages F8 du client concerné avec ceux du serveur. Un export manquant peut résulter de l’échec antérieur d’une dépendance.
4. Enregistrez uniquement l'extrait nécessaire avec les informations d'identification et les identifiants de joueur masqués avant de le partager.

Exemple de recherche de fichier

Si ripgrep est installé sur l'hôte d'administration, exécutez ceci dans le répertoire de journaux réel. Remplacez resource_name par la ressource pertinente :

rg -n -i --glob '*.log' 'resource_name|error|warn' .

Inspectez le fichier correspondant directement autour de l'incident. Les journaux compressés archivés peuvent nécessiter une décompression séparée dans un espace de travail privé. Ne recherchez pas de données client ou joueur non pertinentes simplement parce qu'elles sont à proximité.

Utilisez la journalisation verbeuse temporairement

Activez une option de diagnostic documentée uniquement pour une enquête spécifique. Enregistrez l'ancien paramètre et désactivez-le par la suite. Les journaux verbeux peuvent contenir des identifiants et augmenter l'utilisation du stockage ; limitez l'accès et définissez la rétention.

Si txAdmin ne peut pas lire un profil ou une configuration, sauvegardez-le et vérifiez les permissions et la validité du JSON. Ne supprimez pas les fichiers admins.json ou de profil pour forcer la régénération : cela peut supprimer l'état opérationnel.

Vérifiez un correctif

Répétez l'action originale, puis reconnectez-vous ou redémarrez selon le cas. Confirmez que la première erreur a disparu et que le comportement prévu fonctionne toujours. Conservez la version exacte et la modification de configuration avec l'extrait de journal.

Documentation de référence

Cfx.re — txAdmin