OpenSimulator · FR

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.

Commencez par les logs avant de modifier un INI, vider un cache ou redémarrer un serveur. Une correction à l’aveugle peut masquer la cause initiale.

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.

Sources des chemins log4net

OpenSim.exe.config · Robust.exe.config

Diagnostic d’installation · Autres pannes