Show stats
From OpenSimulator
| Line 6: | Line 6: | ||
See [[Monitoring]] for information on other statistics gathering mechanisms for OpenSimulator. | See [[Monitoring]] for information on other statistics gathering mechanisms for OpenSimulator. | ||
| + | |||
| + | =Statistics= | ||
| + | |||
| + | '''This information is highly subject to change as suitable data gathering is an evolving area. Need to keep adding stats.''' | ||
| + | |||
| + | {| border="1" | ||
| + | ! Stat name !! Units !! Description | ||
| + | |- | ||
| + | | clientstack.<region-name>InboxPacketsCount || messages || The number of messages that have been pre-processed by an inbound network thread but are now waiting to be processed by the main Incoming Packets thread. If this number exceeds 0 for more than one sample then your simulator cannot cope with the number of UDP messages that clients are sending. Region performance will be degraded from the user perspective. | ||
| + | |} | ||
= debug stats record = | = debug stats record = | ||
Revision as of 13:05, 18 November 2013
Introduction
"show stats" is a new statistics gathering mechanism is slowly being added to OpenSimulator to integrate previously separate and ad-hoc mechanisms. For this system, you can see a short statistics summary with the command "show stats" and a much longer list of statistics with the "show stats all" command (which unfortunately doesn't yet include those in the summary!).
Use the "help show stats" command on the console for more information.
See Monitoring for information on other statistics gathering mechanisms for OpenSimulator.
Statistics
This information is highly subject to change as suitable data gathering is an evolving area. Need to keep adding stats.
| Stat name | Units | Description |
|---|---|---|
| clientstack.<region-name>InboxPacketsCount | messages | The number of messages that have been pre-processed by an inbound network thread but are now waiting to be processed by the main Incoming Packets thread. If this number exceeds 0 for more than one sample then your simulator cannot cope with the number of UDP messages that clients are sending. Region performance will be degraded from the user perspective. |
debug stats record
This is an experimental facilty starting in OpenSimulator 0.7.6 which will record the results of "show stats all" to a log file every 5 seconds. The aim is to record statistical information throughout a session for later analysis. The logging is enabled with the console command. It works on both the simulator and a ROBUST instance.
# debug stats record start Now recording all stats to file every 5000ms
To stop logging, either shutdown the server or use the command
# debug stats record stop Stopped recording stats to file.
The log file used has the same name as the main logfile for the executable with the word "Stats" appended. For instance, turning on stats logging for OpenSim.exe will write to the file OpenSimStats.log. For Robust.exe, this will write to RobustStats.log.
Currently and in OpenSimulator 0.7.6, this logging requires entries in OpenSim.exe.config (and Robust.exe.config for Robust). If you are using your own version of these files then you will need to adapt them for the logging entries.
The performance impact of such logging should be low, though the log file size can grow quite large.
