Performances OpenSimulator : guide de diagnostic et optimisation
Guide technique : statistiques, fréquence de simulation, CPU, RAM, physique, scripts, assets, réseau et cas pratiques.
Méthode : diagnostiquer sans tâtonner
1. Définir le symptôme
Distinguez un problème de fluidité de l’avatar, de rendu d’images, de chargement d’assets, de script, de téléportation ou de physique. Notez l’heure, la région, le nombre d’avatars, la version et le moment où cela se produit.
2. Mesurer avant / après
Mesurez au repos puis pendant une activité représentative. Conservez une période de comparaison, la même scène, le même nombre d’avatars et la même durée. Une valeur isolée n’explique pas la cause.
3. Modifier progressivement
Sauvegardez le fichier INI, faites une modification à la fois, surveillez les logs et revenez en arrière si le gain n’est pas mesurable. Ne transposez pas sans test des recommandations venant d’autres versions.
Statistiques OpenSimulator : lecture et interprétation
Commandes console réelles
Le code StatsManager.cs enregistre stats show et son alias show stats. Sans argument, la commande présente les statistiques historiques de la région si elles sont disponibles. list affiche les catégories ; all les statistiques enregistrées.
Exemple de commande ou paramètre : ne pas copier sans vérification.
stats show stats show list stats show all show stats
Statistiques visibles dans le visualiseur
Sur de nombreux visualiseurs, Ctrl+Maj+1 ouvre le panneau de statistiques. Le nombre d’images par seconde du visualiseur (Viewer FPS) est différent des statistiques de simulation. Vérifiez aussi Ping, pertes de paquets, Physics Time et Script Time lorsque disponibles.
Sim FPS et Physics FPS
Ne cherchez pas systématiquement 55 FPS réels. Le code dispose de Normalized55FPS et précise que certaines valeurs affichées sont normalisées pour les visualiseurs. La valeur attendue dépend de la fréquence de simulation configurée ; surveillez surtout la stabilité et les temps d’exécution.
Physics Time
Un temps physique qui augmente lors de collisions ou de mouvements indique une piste : objets physiques, collision meshes, véhicules et objets multipliés. Le taux de Physics FPS seul peut masquer une hausse de coût avant saturation.
Script Time et files d’événements
Un fort temps de script doit être étudié séparément de la fluidité des images. Les moteurs de scripts peuvent traiter les événements de manière asynchrone. Beaucoup de timers et de listeners peuvent surcharger un processus même si chaque script est individuellement léger.
Stats URI et exposition réseau
OpenSimDefaults.ini mentionne Stats_URI = jsonSimStats et ManagedStatsRemoteFetchURI pour les statistiques enregistrées. Si vous exposez ces URL, protégez l’accès au niveau réseau ; ne publiez pas automatiquement des endpoints de supervision sur Internet.
Exemple de commande ou paramètre : ne pas copier sans vérification.
[Startup] Stats_URI = "jsonSimStats" ; ManagedStatsRemoteFetchURI = "ManagedStats"
CPU, mémoire, swap et stockage Linux
Voir les processus qui consomment
top et ps montrent CPU et mémoire au niveau des processus. Sur un serveur contenant plusieurs simulateurs, comparez les PID : un seul moteur peut être saturé alors que la moyenne CPU du système reste modeste.
Exemple de commande ou paramètre : ne pas copier sans vérification.
top ps -eo pid,%cpu,rss,cmd --sort=-%cpu | head -n 20
Comprendre vmstat
r désigne les tâches exécutables en attente ; si/so les entrées et sorties swap ; wa le temps CPU en attente d’entrées/sorties ; st le temps volé par l’hyperviseur. Une colonne élevée doit être corrélée avec le ralentissement observé.
Exemple de commande ou paramètre : ne pas copier sans vérification.
vmstat 1 10
La mémoire cache n’est pas une fuite
Sous Linux, le cache disque utilise de la RAM pour accélérer les accès. La colonne available est souvent plus utile que free pour évaluer la mémoire restante. Un RSS élevé n’est pas une fuite sans croissance anormale et persistante.
Exemple de commande ou paramètre : ne pas copier sans vérification.
free -h ps -eo pid,rss,%mem,cmd --sort=-rss | head -n 20
Observer un processus et ses threads
top -H -p PID aide à vérifier si un thread monopolise un cœur. Le nombre de cœurs attribués à la machine ne signifie pas qu’une tâche particulière pourra automatiquement les utiliser tous.
Exemple de commande ou paramètre : ne pas copier sans vérification.
top -H -p PID
Disque et latence
De longues attentes disque peuvent ralentir les bases de données, les caches et les sauvegardes OAR. Mesurez les temps d’attente et contrôlez l’espace libre ; évitez de confondre débit élevé et latence élevée.
Exemple de commande ou paramètre : ne pas copier sans vérification.
df -h vmstat 1 10
Virtualisation et ressources partagées
Dans une VM, une forte valeur st sur vmstat indique du temps CPU indisponible au profit de l’hyperviseur. Un surengagement des vCPU ou une pression mémoire au niveau hôte peut produire des ralentissements même si OpenSimulator est correctement configuré.
Cadence des régions et paramètres de frame
FrameTime — paramètre délicat
Dans le fichier OpenSimDefaults.ini du dépôt OpenSimulator de référence, FrameTime vaut 0.0909 seconde (environ 11 mises à jour par seconde). Réduire cette durée peut augmenter la fréquence de certaines opérations, mais aussi la charge CPU et réseau. Le code recommande de ne pas descendre sous le pas du moteur physique.
Exemple de commande ou paramètre : ne pas copier sans vérification.
[Startup] FrameTime = 0.0909
UpdateObjectsEveryNFrames
Valeur de référence 1 : fréquence d’envoi des mises à jour programmées des objets. Une valeur plus élevée peut ralentir la diffusion de certains changements ; ne l’utilisez pas comme solution générique au lag.
Exemple de commande ou paramètre : ne pas copier sans vérification.
[Startup] UpdateObjectsEveryNFrames = 1
UpdateAgentsEveryNFrames
Valeur de référence 1 : fréquence de certaines mises à jour de position et vitesse des agents. Une valeur trop élevée peut affecter la fluidité des déplacements perçus.
Exemple de commande ou paramètre : ne pas copier sans vérification.
[Startup] UpdateAgentsEveryNFrames = 1
UpdatePhysicsEveryNFrames
Valeur de référence 1 : fréquence de synchronisation ou d’exécution physique selon le moteur. Le commentaire du code indique que ce paramètre doit rester à 1 dans les usages courants.
Exemple de commande ou paramètre : ne pas copier sans vérification.
[Startup] UpdatePhysicsEveryNFrames = 1
UpdateEventsEveryNFrames
Valeur de référence 1. Le code signale que ce paramètre ne devrait probablement jamais s’éloigner de 1, puisqu’il gouverne les événements de frame transmis aux modules.
Exemple de commande ou paramètre : ne pas copier sans vérification.
[Startup] UpdateEventsEveryNFrames = 1
UpdateCoarseLocationsEveryNFrames
Valeur de référence 50 : mise à jour de positions grossières utilisées, entre autres, par la mini-carte. Elle se mesure en nombre de frames et dépend donc de FrameTime.
Exemple de commande ou paramètre : ne pas copier sans vérification.
[Startup] UpdateCoarseLocationsEveryNFrames = 50
UpdateTerrainEveryNFrames
Valeur de référence 50 : cadence de mise à jour du terrain vers les visualiseurs. Modifier sans mesure peut retarder des changements visibles ou modifier le trafic.
Exemple de commande ou paramètre : ne pas copier sans vérification.
[Startup] UpdateTerrainEveryNFrames = 50
UpdateStorageEveryNFrames
Valeur de référence 200 : traitement périodique de stockage des objets selon les conditions de persistance. Les effets dépendent aussi des durées MinimumTimeBeforePersistenceConsidered et MaximumTimeBeforePersistenceConsidered.
Exemple de commande ou paramètre : ne pas copier sans vérification.
[Startup] UpdateStorageEveryNFrames = 200
Persistance des objets
Les références 60 et 600 secondes évitent d’écrire chaque changement d’objet immédiatement. Baisser ces délais peut augmenter la pression sur le stockage ; les augmenter modifie le moment où les modifications sont enregistrées. Attention à la durabilité des données.
Exemple de commande ou paramètre : ne pas copier sans vérification.
[Startup] MinimumTimeBeforePersistenceConsidered = 60 MaximumTimeBeforePersistenceConsidered = 600
Physique, collision meshes et objets
Choix du moteur physique
Le fork consulté définit physics = ubODE et meshing = ubODEMeshmerizer dans OpenSimDefaults.ini. Ne considérez pas les exemples historiques BulletSim comme des réglages universels : comparez stabilité, véhicules, comportement des collisions, temps de démarrage et mémoire sur une région de test.
Exemple de commande ou paramètre : ne pas copier sans vérification.
[Startup] physics = ubODE meshing = ubODEMeshmerizer
Meshes complexes
Les formes de collision détaillées peuvent augmenter le temps CPU et les chargements. Pour un décor immobile, simplifiez le maillage de collision ou choisissez un réglage de physique sans collision si l’objet ne doit pas bloquer les avatars.
Phantom, physique et solide
Les objets fantômes n’interagissent pas comme des obstacles classiques ; les objets physiques doivent répondre aux forces, donc demandent davantage de calcul. Un objet solide non physique n’a pas nécessairement le même coût qu’un véhicule ou un objet mobile.
Trouver les objets responsables
Utilisez les statistiques du visualiseur et, lorsqu’ils sont disponibles, les outils Top Colliders et Top Scripts du panneau Région/Domaine. Le support peut varier selon le moteur, la version ou les droits d’administration. Ne désactivez pas tous les scripts sans analyser leurs fonctions.
Pourquoi changer de moteur peut dégrader
Un moteur qui démarre plus vite peut occuper plus de mémoire ou traiter différemment les collisions. Le seul critère « vitesse au démarrage » n’est donc pas suffisant. Vérifiez les erreurs de décodage de meshes et le fonctionnement des véhicules.
Scripts, YEngine et optimisation
YEngine dans les versions modernes
Le modèle de configuration analysé mentionne YEngine comme moteur de scripts. Un comportement observé sur une version ancienne avec XEngine ne doit pas être extrapolé sans vérification à la version .NET 8.
Temporisateurs et capteurs
Des centaines d’objets utilisant un timer très fréquent ou des capteurs récurrents peuvent coûter cher. Choisissez l’intervalle le plus long compatible avec la fonction, et déclenchez les opérations sur événement quand c’est possible.
Éviter les mises à jour permanentes
Un script qui modifie sans cesse la position, la texture ou le texte d’un objet peut solliciter à la fois les scripts, la simulation et le réseau. Si la valeur ne change pas, ne réémettez pas la même opération.
Mesurer les scripts les plus coûteux
Consultez Top Scripts lorsque l’outil est disponible, puis comparez avant/après correction. Une forte charge peut provenir d’un très grand nombre de scripts modestes plutôt que d’un seul script lent.
Contrôler les permissions OSSL
Ne désactivez jamais les restrictions OSSL simplement pour gagner du temps de dépannage. Les restrictions protègent les régions contre des fonctions sensibles ; une exception doit être limitée et justifiée.
Assets, caches, MySQL, ROBUST et réseau
Identifier le service lent
Une texture qui apparaît tard peut venir du visualiseur, de la connexion Internet, du cache, du service assets ou du stockage. Une téléportation lente peut aussi dépendre du service d’inventaire ou de présence. Distinguez téléchargement lent et simulation lente.
MySQL : connexion et temps de réponse
Vérifiez les journaux MySQL et OpenSimulator, les connexions interrompues, les requêtes lentes et l’attente disque. Une augmentation aveugle des limites de connexions peut masquer une fuite ou aggraver la pression mémoire.
Caches : compromis
Un cache accélère les accès répétés au prix de mémoire ou de stockage. Effacer systématiquement tous les caches peut augmenter la charge et dégrader temporairement l’expérience. Mesurez avant et après.
Réseau et DNS
Contrôlez la résolution des noms internes et externes, les ports ouverts, les timeouts, le pare-feu et les logs des services. Une erreur de réseau peut ressembler à un problème de performance des simulateurs.
ROBUST séparé des régions
Dans une grille distribuée, examinez les ressources de ROBUST et celles des simulateurs indépendamment. Un ROBUST lent peut toucher plusieurs régions sans que celles-ci soient saturées.
Performances côté visualiseur et contenu 3D
Viewer FPS contre Sim FPS
Un visualiseur lent n’implique pas nécessairement un serveur saturé. Vérifiez la carte graphique, la résolution, le champ de vision, la distance d’affichage et le nombre d’objets affichés avant de toucher aux paramètres du simulateur.
Textures et mémoire vidéo
Utilisez la plus petite résolution qui reste correcte à la distance normale de vision. Réutiliser des textures appropriées peut limiter les transferts et la mémoire graphique. N’imposez pas systématiquement 1024×1024 ou plus aux petits objets.
LOD et triangles
Les meshes ont différents niveaux de détail. De bons LOD évitent d’afficher une géométrie coûteuse lorsque l’objet est éloigné. Il faut distinguer la géométrie affichée de la géométrie utilisée pour les collisions.
Transparence et surcharge
De nombreuses surfaces transparentes superposées peuvent coûter cher au visualiseur et provoquer des artefacts. Simplifiez les couches transparentes quand l’effet visuel n’en dépend pas.
Cas pratiques de diagnostic
CPU élevé, RAM encore disponible
Commencez par top -H sur le processus concerné, puis regardez temps de frame, scripts et physique. Un redémarrage peut masquer temporairement le problème sans supprimer la cause. Reproduisez sur une région test.
Exemple de commande ou paramètre : ne pas copier sans vérification.
top -H -p PID stats show
RAM élevée, CPU faible
Regardez available et swap avant de conclure. Comparez RSS du processus à plusieurs heures d’intervalle. Si la mémoire augmente continuellement à charge constante, recherchez des modules, caches ou objets spécifiques.
Exemple de commande ou paramètre : ne pas copier sans vérification.
free -h vmstat 1 10
Forte attente disque
Si wa augmente pendant des sauvegardes ou requêtes MySQL, contrôlez les opérations simultanées et la latence du support. Échelonner les sauvegardes peut aider davantage que modifier le moteur physique.
Exemple de commande ou paramètre : ne pas copier sans vérification.
vmstat 1 10
Avatar saccadé, viewer FPS élevé
Vérifiez pertes réseau, ping, statistiques de la région et physique. Une animation fluide du visualiseur ne garantit pas que les mises à jour de position arrivent à temps.
Visualiseur à 10 FPS, serveur normal
Commencez par la distance de rendu, les LOD, la complexité des meshes et textures, la mémoire GPU et les pilotes. Ne modifiez pas FrameTime pour corriger une saturation graphique locale.
Téléportations lentes, régions peu chargées
Corrélez les journaux de la région source, de la destination et de ROBUST ; vérifiez DNS, inventaire, assets, présence et services externes. Une panne de service peut toucher toute la grille.
Sources, versions et références
Les paramètres FrameTime, physique et statistiques sont vérifiés dans le code du fork. Les conseils sur la qualité des meshes et des scripts sont également confrontés aux ressources communautaires. Le wiki officiel peut ne pas être accessible en continu.