Lire les logs OpenSimulator et ROBUST
La première étape du dépannage : localiser les journaux, suivre un incident et relier les erreurs entre services.
Commencer par les logs : méthode en six étapes
1) Notez l’heure exacte, le nom de région, l’avatar concerné et l’action déclenchante. 2) Repérez le processus impliqué (région, ROBUST, MySQL ou module externe). 3) Lisez les lignes juste avant et après l’incident. 4) Recherchez la première erreur pertinente, pas seulement le dernier message ERROR. 5) Corrélez les journaux des autres services avec la même fenêtre horaire. 6) Formulez une hypothèse, vérifiez-la, et ne modifiez qu’un paramètre à la fois.
Où sont enregistrés les logs ?
Dans le fork 0.9.3.1, les fichiers OpenSim.exe.config et Robust.exe.config définissent par défaut les fichiers OpenSim.log et Robust.log via log4net. Ce sont des chemins relatifs au répertoire de travail du processus ; ne présumez pas que tous les serveurs utilisent bin/. Les exemples de rotation log/OpenSim.log et log/Robust.log sont commentés dans ces modèles. Vérifiez aussi si systemd, screen, tmux, Docker ou un gestionnaire de processus redirige la sortie.
Commandes de lecture seule, à adapter à vos chemins et services.
cd /chemin/vers/opensim/bin ls -lh OpenSim.log Robust.log log/ 2>/dev/null find /chemin/vers/opensim -type f \( -name 'OpenSim.log*' -o -name 'Robust.log*' \) -print # Consulter les fichiers de configuration log4net : grep -n -A 7 'name="LogFileAppender"' OpenSim.exe.config Robust.exe.config
Suivre le journal en direct
Pour reproduire un bug, démarrez la surveillance avant l’action concernée. Conservez les dizaines de lignes précédentes et suivantes ; l’erreur finale peut n’être qu’une conséquence. Sur Linux, tail -F suit un nom de fichier lors de rotations simples ; Ctrl+C arrête la lecture sans arrêter le simulateur.
Commandes de lecture seule, à adapter à vos chemins et services.
tail -n 150 /chemin/vers/bin/OpenSim.log tail -F /chemin/vers/bin/OpenSim.log # Pour les services centraux : tail -F /chemin/vers/bin/Robust.log
Chercher efficacement sans perdre le contexte
Cherchez d’abord ERROR, FATAL, exception, refused, timeout ou failed, puis revenez en arrière dans le journal. Tous les WARN ne sont pas critiques et une exception peut être récupérée. Vérifiez l’horodatage, le composant entre crochets, la trace complète et les lignes qui précèdent le premier échec.
Commandes de lecture seule, à adapter à vos chemins et services.
grep -nEi 'ERROR|FATAL|exception|refused|timeout|failed' /chemin/vers/bin/OpenSim.log | tail -n 80 # Exemples : afficher les lignes 420 à 470 autour d’une erreur sed -n '420,470p' /chemin/vers/bin/OpenSim.log # Plusieurs journaux simultanément : grep -nEi 'ERROR|FATAL|exception' /chemin/vers/bin/Robust.log
ROBUST et simulateurs : deux journaux complémentaires
Quand une région ne s’enregistre pas, lorsque l’avatar ne se connecte pas ou quand l’inventaire échoue, comparez OpenSim.log du simulateur et Robust.log du serveur central. Le simulateur peut seulement signaler un échec HTTP alors que ROBUST indique le service, la base ou le connecteur fautif. Synchronisez les horloges (NTP) et les fuseaux avant de comparer les heures.
Commandes de lecture seule, à adapter à vos chemins et services.
date -Is timedatectl status # Sur chaque machine, consulter la même tranche horaire dans les logs : grep '2026-11-09 14:' /chemin/vers/bin/OpenSim.log grep '2026-11-09 14:' /chemin/vers/bin/Robust.log
Logs systemd et services de démarrage
Si OpenSimulator ou ROBUST est lancé par un service systemd, le journal systemd peut révéler les erreurs qui apparaissent avant la création du fichier log : chemin de travail incorrect, droits d’accès, DLL manquante, arrêt immédiat, manque de mémoire ou signal de terminaison. Remplacez les noms d’unité d’exemple par ceux réellement présents.
Commandes de lecture seule, à adapter à vos chemins et services.
systemctl --type=service --all | grep -Ei 'opensim|robust' systemctl status robust.service --no-pager journalctl -u robust.service -n 150 --no-pager journalctl -u robust.service -f # Exemple pour une unité de simulateur : journalctl -u opensim.service --since '1 hour ago' --no-pager
MySQL, inventaire et assets
Une erreur SQL vue dans OpenSim.log ou Robust.log est un point de départ, pas nécessairement la cause racine. Vérifiez l’état du serveur SQL, ses journaux et les événements de redémarrage, de saturation, de refus de connexion ou de privilèges. Pour les assets introuvables, recherchez les UUID et les messages associés avant de recharger un OAR ou de purger un cache.
Commandes de lecture seule, à adapter à vos chemins et services.
systemctl status mysql --no-pager journalctl -u mysql --since '1 hour ago' --no-pager # Le service peut aussi s’appeler mariadb selon l’installation : systemctl status mariadb --no-pager # Adapter à un UUID d’asset connu : grep -n 'UUID_ASSET' /chemin/vers/bin/OpenSim.log
Windows : où consulter les traces
Sous Windows, repérez OpenSim.log et Robust.log selon le chemin défini par les fichiers .config et le dossier d’exécution. Le terminal PowerShell permet de lire et suivre les logs. Si le processus ne démarre pas, consultez également l’Observateur d’événements Windows, notamment Application.
Commandes de lecture seule, à adapter à vos chemins et services.
Get-Content .\OpenSim.log -Tail 150 Get-Content .\OpenSim.log -Wait -Tail 100 Select-String -Path .\Robust.log -Pattern 'ERROR|FATAL|Exception|timeout'
Préparer un rapport de bug exploitable
Indiquez version exacte d’OpenSimulator, système et version .NET, architecture Standalone ou Grid, région concernée, heure et fuseau, action reproduisant le bug, résultat attendu et observé. Joignez un extrait horodaté du journal avant et après le premier échec pertinent, ainsi que les versions de modules tiers. Masquez identifiants, mots de passe, tokens, clés WebRTC, données personnelles et informations de connexion sensibles.
Ne pas effacer les preuves
Évitez de redémarrer ou de vider les logs avant de relever le message pertinent. Si un redémarrage est indispensable, sauvegardez le journal et notez l’heure. Ne publiez pas l’intégralité d’un journal de production sans inspection : il peut exposer des secrets et données d’utilisateurs.