OpenSimulator · FR

Commandes scripts, statistiques et débogage

Surveiller la charge et gérer YEngine ou les scripts, en évitant les opérations coûteuses.

Version de référence : OpenSimulator 0.9.3.1. Les commandes héritées d'anciennes versions doivent être confirmées avec help sur le processus concerné. Ne pas lancer de commande destructive sans sauvegarde.

Le moteur de scripts doit être identifié

Les commandes yeng sont disponibles lorsque YEngine est chargé. Certaines anciennes documentations présentent des syntaxes et sous-commandes qui ne correspondent pas toutes à l'aide actuelle ; utilisez d'abord yeng help. Suspendre le moteur ne revient pas à effacer les fichiers d'état des scripts.

Interpréter les statistiques

show stats et monitor report servent au diagnostic : FPS du simulateur, coût physique, temps de frame, scripts et trafic. Leur présence et leur format dépendent du module et de la version. Une valeur isolée, sans contexte d'utilisation, ne prouve pas une saturation du serveur.

Le débogage peut coûter cher

Les journaux HTTP ou paquets peuvent produire beaucoup de lignes, ralentir l'analyse et exposer des adresses de services ou des données de session. Activez-les uniquement le temps nécessaire, limitez leur diffusion et restaurez le niveau de logs ensuite.

YEngine : code vérifié

OptionSignificationAttention
yeng helpAfficher l'aide du moteurPremière étape recommandée
yeng lsExaminer les scripts selon les filtres disponiblesUtiliser yeng ls -help sur la version
yeng resetRéinitialiser des scripts selon la portéeAction lourde, vérifier arguments et régions
yeng resumeReprendre l'exécution des scriptsPeut libérer une charge en attente
yeng suspendSuspendre l'exécution des scriptsArrête temporairement les scripts concernés
yeng cvvAfficher la version du compilateurLecture seule
yeng mvvAfficher la version de migrationCode actuel affiche la valeur
yeng tracecalls yes|noActiver/désactiver les traces d'appelsLogs potentiellement volumineux
yeng verbose yes|noModifier les traces détailléesPréférer un diagnostic temporaire

Scripts et statistiques

OptionSignificationAttention
scripts showAfficher des informations de scriptsVérifier le moteur de scripts chargé
scripts stopArrêter des scripts ciblésPeut interrompre le fonctionnement d'objets
scripts startDémarrer des scripts ciblésPeut augmenter la charge
scripts suspendSuspendre les scripts concernésPortée de commande à confirmer
scripts resumeReprendre des scripts suspendusPortée de commande à confirmer
show statsAfficher statistiques système/simulateurLire plusieurs échantillons
monitor reportAfficher la surveillance disponibleDépend du module de monitoring
stats record start|stopEnregistrer périodiquement des statistiquesVérifier emplacement et I/O du fichier
stats save <fichier>Sauvegarder un instantané de statistiquesCommande ancienne ; vérifier help

Diagnostic

OptionSignificationAttention
debug packet <niveau>Tracer les paquets réseau du simulateurDébit de logs élevé, données sensibles
debug http ...Tracer des requêtes HTTPSyntaxe varie ; ne pas exposer les tokens
debug threadpool level <niveau>Diagnostiquer le pool de threadsCommande ancienne ; vérifier help
get log levelLire le niveau courant de consoleConfirmer console et version
set log level <niveau>Modifier le niveau de journalisationRéduire la verbosité après diagnostic
show pending-objectsVoir les objets en attente d'envoiCode simulateur vérifié
show pqueues [full]Examiner les files prioritairesCommande ancienne ; vérifier sa disponibilité
show queuesVoir les files des connexionsCommande ancienne ; vérifier sa disponibilité
show throttles [full]Examiner les limites réseau des clientsNe pas publier de données de sessions

Indicateurs de performance fréquents

OptionSignificationAttention
SimFPSFréquence effective du simulateurÀ interpréter avec les temps de frame
PhyFPSFréquence de simulation physiqueDépend du moteur
RootAg / ChldAgAgents principaux et enfantsÉviter de confondre visiteurs et agents voisins
AtvScrScripts actifsNe mesure pas à lui seul le temps CPU
PhysFt / TotlFtTemps physique et temps total de frameComparer plusieurs observations
PktOut / PktsInDébit de paquets réseauN'indique pas seul un goulot d'étranglement

Références

Références : documentation officielle des commandes console et code source OpenSimulator. Les indications anciennes sont à recouper avec la version installée. Code OpenSimulator 0.9.3.1 vérifié pour les exemples cités ci-dessous.