Commandes scripts, statistiques et débogage
Surveiller la charge et gérer YEngine ou les scripts, en évitant les opérations coûteuses.
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é
| Option | Signification | Attention |
|---|---|---|
yeng help | Afficher l'aide du moteur | Première étape recommandée |
yeng ls | Examiner les scripts selon les filtres disponibles | Utiliser yeng ls -help sur la version |
yeng reset | Réinitialiser des scripts selon la portée | Action lourde, vérifier arguments et régions |
yeng resume | Reprendre l'exécution des scripts | Peut libérer une charge en attente |
yeng suspend | Suspendre l'exécution des scripts | Arrête temporairement les scripts concernés |
yeng cvv | Afficher la version du compilateur | Lecture seule |
yeng mvv | Afficher la version de migration | Code actuel affiche la valeur |
yeng tracecalls yes|no | Activer/désactiver les traces d'appels | Logs potentiellement volumineux |
yeng verbose yes|no | Modifier les traces détaillées | Préférer un diagnostic temporaire |
Scripts et statistiques
| Option | Signification | Attention |
|---|---|---|
scripts show | Afficher des informations de scripts | Vérifier le moteur de scripts chargé |
scripts stop | Arrêter des scripts ciblés | Peut interrompre le fonctionnement d'objets |
scripts start | Démarrer des scripts ciblés | Peut augmenter la charge |
scripts suspend | Suspendre les scripts concernés | Portée de commande à confirmer |
scripts resume | Reprendre des scripts suspendus | Portée de commande à confirmer |
show stats | Afficher statistiques système/simulateur | Lire plusieurs échantillons |
monitor report | Afficher la surveillance disponible | Dépend du module de monitoring |
stats record start|stop | Enregistrer périodiquement des statistiques | Vérifier emplacement et I/O du fichier |
stats save <fichier> | Sauvegarder un instantané de statistiques | Commande ancienne ; vérifier help |
Diagnostic
| Option | Signification | Attention |
|---|---|---|
debug packet <niveau> | Tracer les paquets réseau du simulateur | Débit de logs élevé, données sensibles |
debug http ... | Tracer des requêtes HTTP | Syntaxe varie ; ne pas exposer les tokens |
debug threadpool level <niveau> | Diagnostiquer le pool de threads | Commande ancienne ; vérifier help |
get log level | Lire le niveau courant de console | Confirmer console et version |
set log level <niveau> | Modifier le niveau de journalisation | Réduire la verbosité après diagnostic |
show pending-objects | Voir les objets en attente d'envoi | Code simulateur vérifié |
show pqueues [full] | Examiner les files prioritaires | Commande ancienne ; vérifier sa disponibilité |
show queues | Voir les files des connexions | Commande ancienne ; vérifier sa disponibilité |
show throttles [full] | Examiner les limites réseau des clients | Ne pas publier de données de sessions |
Indicateurs de performance fréquents
| Option | Signification | Attention |
|---|---|---|
SimFPS | Fréquence effective du simulateur | À interpréter avec les temps de frame |
PhyFPS | Fréquence de simulation physique | Dépend du moteur |
RootAg / ChldAg | Agents principaux et enfants | Éviter de confondre visiteurs et agents voisins |
AtvScr | Scripts actifs | Ne mesure pas à lui seul le temps CPU |
PhysFt / TotlFt | Temps physique et temps total de frame | Comparer plusieurs observations |
PktOut / PktsIn | Débit de paquets réseau | N'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.