Script, statistics and debugging commands
Inspect performance and operate YEngine or scripts while avoiding heavy interventions.
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
| Option | Meaning | Caution |
|---|---|---|
yeng help | Show script-engine help | Recommended first |
yeng ls | Inspect scripts using available filters | Use yeng ls -help in current version |
yeng reset | Reset scripts according to scope | Potentially heavy; check args and regions |
yeng resume | Resume script execution | Can unleash pending work |
yeng suspend | Suspend script execution | Temporarily halts affected scripts |
yeng cvv | Show compiler version | Read-only |
yeng mvv | Show migration version | Current code displays current value |
yeng tracecalls yes|no | Toggle call tracing | Potentially high log volume |
yeng verbose yes|no | Toggle verbose output | Use temporarily |
Scripts and metrics
| Option | Meaning | Caution |
|---|---|---|
scripts show | Show script information | Check loaded script engine |
scripts stop | Stop scripts | May break object functions |
scripts start | Start scripts | May increase load |
scripts suspend | Suspend scripts | Confirm scope |
scripts resume | Resume scripts | Confirm scope |
show stats | Display simulator/server stats | Check multiple samples |
monitor report | Display monitoring report | Depends on monitoring module |
stats record start|stop | Record periodic statistics | Check file location and I/O |
stats save <fichier> | Save statistics snapshot | Legacy command; check help |
Debug commands
| Option | Meaning | Caution |
|---|---|---|
debug packet <niveau> | Trace simulator packets | Large logs and sensitive data |
debug http ... | Trace HTTP calls | Syntax varies; redact tokens |
debug threadpool level <niveau> | Diagnose the threadpool | Legacy command; check help |
get log level | Read current console log level | Check process and version |
set log level <niveau> | Change logging level | Restore normal verbosity afterward |
show pending-objects | Inspect pending object updates | Verified simulator source |
show pqueues [full] | Inspect priority queues | Legacy command; verify availability |
show queues | Inspect connection queues | Legacy command; verify availability |
show throttles [full] | Inspect client throttles | Redact session data |
Common performance indicators
| Option | Meaning | Caution |
|---|---|---|
SimFPS | Simulator tick rate | Interpret with frame times |
PhyFPS | Physics simulation rate | Engine-dependent |
RootAg / ChldAg | Root and child agents | Do not confuse root and neighbor child agents |
AtvScr | Active scripts | Not CPU time by itself |
PhysFt / TotlFt | Physics and total frame time | Compare multiple samples |
PktOut / PktsIn | Network packet rates | Not 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.