XSimStatus

Revision as of 12:14, 10 October 2011

This old facility provides a way to retrieve some very basic region data and some more detailed information about the simulator as a whole. It is always active.

Each region will register a URL handler with a random UUID. There will also be a handler that will return data for the simulator as a whole. These UUIDs will be different on each restart of the simulator but are stored in the regionSecret field of the regions table. However, this is not useful for standalone simulators since they do not persist this table.

So a two region simulator will have three handlers, one for each simulator and one for the simulator as a whole.

Sending a GET request to a handler will return data in JSON format.

You can see these handlers using the region console command

show http-handlers

In the last section you should see something like

* StreamHandlers (7):
       POST:/friends
       GET:/map
       GET:/get_grid_info
       GET:/F27ED466A0D311F8A7B1F309F942437F3302D455
       GET:/493F5C64F8AF200E63C9A33EA92BD393D9232A61
       GET:/simstatus
       GET:/1B71AB5959171C2308F429E8F397F0390ADEF94D

Here, F27ED466A0D311F8A7B1F309F942437F3302D455, 493F5C64F8AF200E63C9A33EA92BD393D9232A61 and 1B71AB5959171C2308F429E8F397F0390ADEF94D are XSimStatus handlers. Unfortunately, it's not possible to tell which are which except by pointing your browser at them. Let's suppose you are running a standalone on 192.168.1.2 with an HTTP listener port of 9000. In this case, going to

http://192.168.1.2:9000/F27ED466A0D311F8A7B1F309F942437F3302D455

yields

{
"OSStatsURI":"http://192.168.1.2:9000/1B71AB5959171C2308F429E8F397F0390ADEF94D/",
"TimeZoneName":"GMT",
"TimeZoneOffs":1.0,
"UxTime":1318276065,
"Memory":31.0,
"Version":"OpenSim 0.7.3 Dev          "
}

This is data for a particular region. In the OSStatsURI field it does give the statistics handler for the simulator as a whole. Sending a get request to http://192.168.1.2:9000/1B71AB5959171C2308F429E8F397F0390ADEF94D/ returns

{
"AssetsInCache":"0",
"TimeAfterCacheMiss":"0",
"BlockedMissingTextureRequests":"0",
"AssetServiceRequestFailures":"0",
"abnormalClientThreadTerminations":"0",
"InventoryServiceRetrievalFailures":"0",
"Dilatn":"1",
"SimFPS":"56.67",
"PhyFPS":"46.93",
"AgntUp":"0",
"RootAg":"0",
"ChldAg":"0",
"Prims":"1",
"AtvPrm":"0",
"AtvScr":"1",
"ScrLPS":"0",
"PktsIn":"0",
"PktOut":"0",
"PendDl":"0",
"PendUl":"0",
"UnackB":"0",
"TotlFt":"0.67",
"NetFt":"0",
"PhysFt":"0.33",
"OthrFt":"0",
"AgntFt":"0.33",
"ImgsFt":"0",
"Memory":"21",
"Uptime":"00:20:49.0991070",
"Version":"OpenSim 0.7.3 Dev          013bf27"
}

Unfortunately, the simulator stats here are only for one region. In a multi-region simulator which one this is is not defined and will change depending on exactly when the URL is called. Also, the top 6 statistics (AssetsInCache to InventoryServiceRetrievalFailures) are not currently in use.