Difference between revisions of "SimStats"

Latest revision as of 14:36, 19 July 2008

Message Layout

{
	SimStats Low 140 Trusted Unencoded
	{
		Region Single
		{	RegionX				U32				}
		{	RegionY				U32				}
		{	RegionFlags			U32				}
		{	ObjectCapacity		U32				}
	}
	{
		Stat	Variable
		{	StatID		U32	}
		{	StatValue	F32	}
	}
	{
		PidStat Single
		{	PID					S32				}
	}
}

Usage and Notes

This message is sent to all connected clients (and simulators + dataserver?) about once a second to reflect the current statistical details maintained by the simulator.

PidStat.PID is most likely the operating system process id of the simulator software on the host.
RegionX and RegionY are the X and Y MAP coordinates, not its global coordinates.
ObjectCapacity is the number of primitives(tasks) the region can hold. (Usually 15,000)

Stat values

StatID	Statistic	Example Value	Comment
0	LL_SIM_STAT_TIME_DILATION	0.977843	Ratio of time passage in region to real time passage.
1	LL_SIM_STAT_FPS	43.5	Number of timesteps taken per second, rolling scale. Perfect is 45.0
2	LL_SIM_STAT_PHYSFPS	44.2	Number of timesteps taken in the physics engine per second, rolling scale. Perfect is 45.0
3	LL_SIM_STAT_AGENTUPS	8	Number of updates sent for agent objects per second. Should be one for every main agent and child agent connected to the region.
4	LL_SIM_STAT_FRAMEMS	21.2	Number of milliseconds spent processing each frame(Sum of all others). Averaged over each second. Should ideally be below 25.0
5	LL_SIM_STAT_NETMS	2.8	Number of milliseconds spent processing network messages or connections. Averaged over each second. Should ideally be below 5.0
6	LL_SIM_STAT_SIMOTHERMS	0.5	Number of milliseconds spent doing "other" things. Averaged over each second. Should ideally be below 5.0
7	LL_SIM_STAT_SIMPHYSICSMS	3.2	Number of milliseconds spent inside the physics engine(Sum of physics times.) Averaged over each second. Should ideally be below 10.0
8	LL_SIM_STAT_AGENTMS	0.3	Number of milliseconds spent calculating agent visibility, interest lists, status, and preparing physical entity. Averaged over each second. Should ideally be below 5.0
9	LL_SIM_STAT_IMAGESMS	0.1	Number of milliseconds spent processing image data, separating discard levels, decoding images. Averaged over each second. Should ideally be below 3.0
10	LL_SIM_STAT_SCRIPTMS	13.7	Number of milliseconds spent running scripts and updating script states. Averaged over each second. Should ideally be below 25.0
11	LL_SIM_STAT_NUMTASKS	8832	Number of prims(tasks) within the region, including temporary tasks.
12	LL_SIM_STAT_NUMTASKSACTIVE	1842	Number of prims(tasks) that are active(physical, have scripts, changing status, being stood on.)
13	LL_SIM_STAT_NUMAGENTMAIN	12	Number of agents that are within the region
14	LL_SIM_STAT_NUMAGENTCHILD	4	Number of agents that are not located within the region but can see into it.(Looking into the region from another region.)
15	LL_SIM_STAT_NUMSCRIPTSACTIVE	2832	Number of scripts that are loaded onto tasks and set to running within the region. Scripts no set to running do not count towards this value.
16	LL_SIM_STAT_LSLIPS	680572	Number of LSL virtual machine instructions executed within the last second.
17	LL_SIM_STAT_INPPS	743	Number of packets simulator received that were related to the region in the last second.
18	LL_SIM_STAT_OUTPPS	1943	Number of packets sent by the region in the last second.
19	LL_SIM_STAT_PENDING_DOWNLOADS	2	Number of asset download requests waiting for a response.
20	LL_SIM_STAT_PENDING_UPLOADS	8	Number of asset upload requests waiting for authorization, response or to complete transfer.
23	LL_SIM_STAT_PENDING_LOCAL_UPLOADS	0	Unknown. Number of locally stored assets trying to transfer to another sim?(Skin bakes.)
24	LL_SIM_STAT_TOTAL_UNACKED_BYTES	84	Number of kilobytes of network messages that have yet to be acknowledged. Ideally below 1000.
25	LL_SIM_STAT_PHYSICS_PINNED_TASKS	1	Number of prims that are marked as pinned within the physics system. Usually 0.
26	LL_SIM_STAT_PHYSICS_LOD_TASKS	3	Number of prims that have had their level of detail reduced to help alleviate physics load. Ideally 0.
27	LL_SIM_STAT_SIMPHYSICSSTEPMS	8.2	Number of milliseconds spent running the physics time step. Averaged over a second. Ideally should be below 15.0
28	LL_SIM_STAT_SIMPHYSICSSHAPEMS	0.2	Number of milliseconds spent updating the physical shape of an object. Averaged over a second. Ideally should be below 3.0
29	LL_SIM_STAT_SIMPHYSICSOTHERMS	0.1	Number of milliseconds spent inside the physics engine not updating shapes or running physics step. Averaged over a second. Ideally should be below 3.0
30	LL_SIM_STAT_SIMPHYSICSMEMORY	18	Number of megabytes of RAM allocated on the simulator for physics.

RegionFlags values

Value	Flag	Comment
0x01	REGION_FLAGS_ALLOW_DAMAGE	Damage system forced to on for entire region.
0x02	REGION_FLAGS_ALLOW_LANDMARK	If agents can create landmarks anywhere within the region.(Forced on)
0x04	REGION_FLAGS_ALLOW_SET_HOME	If agents can set their home location to anywhere within the region.(Forced on)
0x08	REGION_FLAGS_RESET_HOME_ON_TELEPORT	If agents home location is set to the destination upon teleporting out of the region.
0x10	REGION_FLAGS_SUN_FIXED	If the sun should not move with time.
0x20	REGION_FLAGS_TAX_FREE	If taxes should not apply to this region.(Deprecated)
0x40	REGION_FLAGS_BLOCK_TERRAFORM	Land cannot be changed anywhere within the region. Trees and plants may still be placed.
0x80	REGION_FLAGS_BLOCK_LAND_RESELL	Land cannot be released, sold, or bought within the entire region.
0x100	REGION_FLAGS_SANDBOX	Region is a sandbox and is wiped every 12 hours.(Appears deprecated.)
0x200	REGION_FLAGS_NULL_LAYER	Unknown: Related to the availability of an overview world map tile.(Think mainland images when zoomed out.)
0x400	REGION_FLAGS_SKIP_AGENT_ACTION	Unknown: Related to region debug flags. Possibly to skip processing of agent interaction with world.
0x800	REGION_FLAGS_SKIP_UPDATE_INTEREST_LIST	Region does not update agent prim interest lists. Internal debugging option.
0x1000	REGION_FLAGS_SKIP_COLLISIONS	Makes all objects phantom and or pins them in place, does not affect agents.
0x2000	REGION_FLAGS_SKIP_SCRIPTS	Region does not run scripts, affects whole region.
0x4000	REGION_FLAGS_SKIP_PHYSICS	Region does not run physics timesteps. All objects are frozen, including agents.
0x8000	REGION_FLAGS_EXTERNALLY_VISIBLE	Region can be seen from other regions on world map. (Legacy world map option?)
0x10000	REGION_FLAGS_MAINLAND_VISIBLE(UNDEFINED)	Region can be seen from mainland on world map. (Legacy world map option?)
0x20000	REGION_FLAGS_PUBLIC_ALLOWED	Agents not explicitly on the access list can visit the region.
0x40000	REGION_FLAGS_BLOCK_DWELL	Traffic calculations are not run across entire region, overrides parcel settings.
0x80000	REGION_FLAGS_BLOCK_FLY	Flight is disabled for the entire region, overrides parcel settings.
0x100000	REGION_FLAGS_ALLOW_DIRECT_TELEPORT	If teleports are allowed to exactly locations, if not on, agent is routed to nearest telehub. Overrides parcel settings.
0x200000	REGION_FLAGS_ESTATE_SKIP_SCRIPTS	Region is not running scripts, persisted in database. Set on an estate level.
0x400000	REGION_FLAGS_RESTRICT_PUSHOBJECT	Restricts the usage of the LSL llPushObject function, applies to whole region.
0x800000	REGION_FLAGS_DENY_ANONYMOUS	Denys "hackers on steroids" with no payment info from entering the region.
0x1000000	REGION_FLAGS_DENY_IDENTIFIED(UNDEFINED)	Denys agents with payment info from entering the region.(Legacy removed option.)
0x2000000	REGION_FLAGS_DENY_TRANSACTED(UNDEFINED)	Denys agents with payment info that has been used from entering the region.(Legacy removed option.)
0x4000000	REGION_FLAGS_ALLOW_PARCEL_CHANGES	Parcels within the region may be joined or divided by anyone, not just estate owners/managers.
0x8000000	REGION_FLAGS_ABUSE_EMAIL_TO_ESTATE_OWNER	Abuse reports sent from within this region are sent to the estate owner defined email.
0x10000000	REGION_FLAGS_ALLOW_VOICE	Voice can be enabled within the region.
0x20000000	REGION_FLAGS_BLOCK_PARCEL_SEARCH	Removes the ability from parcel owners to set their parcels to show in search.
0x40000000	REGION_FLAGS_DENY_AGEUNVERIFIED	Denys agents who have not been age verified from entering the region.

Official Viewer Behavior

If RegionFlags blocks fly, your flying status is set to false to comply with region policy.