OpenSimulator · EN

Script, statistics and debugging commands

Inspect performance and operate YEngine or scripts while avoiding heavy interventions.

Reference version: OpenSimulator 0.9.3.1. Commands from older releases must be checked with help on the relevant process. Never run destructive operations without backups.

Identify the active script engine

yeng commands are available when YEngine is loaded. Older documentation includes syntax and commands that are not all present in current source help; start with yeng help. Suspending scripts does not delete script-state files.

Interpreting statistics

show stats and monitor report help diagnose simulator FPS, physics cost, frame timing, scripts and traffic. Availability and output depend on module and version. A single isolated number is not proof of server saturation.

Debugging has overhead

HTTP or packet debug logs can generate high volume, slow analysis and expose service endpoints or session data. Enable only as needed, limit sharing and restore logging afterward.

YEngine: verified code

OptionMeaningCaution
yeng helpShow script-engine helpRecommended first
yeng lsInspect scripts using available filtersUse yeng ls -help in current version
yeng resetReset scripts according to scopePotentially heavy; check args and regions
yeng resumeResume script executionCan unleash pending work
yeng suspendSuspend script executionTemporarily halts affected scripts
yeng cvvShow compiler versionRead-only
yeng mvvShow migration versionCurrent code displays current value
yeng tracecalls yes|noToggle call tracingPotentially high log volume
yeng verbose yes|noToggle verbose outputUse temporarily

Scripts and metrics

OptionMeaningCaution
scripts showShow script informationCheck loaded script engine
scripts stopStop scriptsMay break object functions
scripts startStart scriptsMay increase load
scripts suspendSuspend scriptsConfirm scope
scripts resumeResume scriptsConfirm scope
show statsDisplay simulator/server statsCheck multiple samples
monitor reportDisplay monitoring reportDepends on monitoring module
stats record start|stopRecord periodic statisticsCheck file location and I/O
stats save <fichier>Save statistics snapshotLegacy command; check help

Debug commands

OptionMeaningCaution
debug packet <niveau>Trace simulator packetsLarge logs and sensitive data
debug http ...Trace HTTP callsSyntax varies; redact tokens
debug threadpool level <niveau>Diagnose the threadpoolLegacy command; check help
get log levelRead current console log levelCheck process and version
set log level <niveau>Change logging levelRestore normal verbosity afterward
show pending-objectsInspect pending object updatesVerified simulator source
show pqueues [full]Inspect priority queuesLegacy command; verify availability
show queuesInspect connection queuesLegacy command; verify availability
show throttles [full]Inspect client throttlesRedact session data

Common performance indicators

OptionMeaningCaution
SimFPSSimulator tick rateInterpret with frame times
PhyFPSPhysics simulation rateEngine-dependent
RootAg / ChldAgRoot and child agentsDo not confuse root and neighbor child agents
AtvScrActive scriptsNot CPU time by itself
PhysFt / TotlFtPhysics and total frame timeCompare multiple samples
PktOut / PktsInNetwork packet ratesNot proof of bottleneck by itself

References

References: official console command documentation and OpenSimulator source code. Check older entries against your installed version. OpenSimulator 0.9.3.1 source checked for the listed examples.