XSimStatus - Revision history

Ssm2017: added quicklinks

2013-11-08T08:32:29Z

added quicklinks

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

2012-03-04T07:05:09Z

Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

MakoBot: Robot: Cosmetic changes

2012-03-04T04:21:30Z

Robot: Cosmetic changes

Justincc at 20:14, 10 October 2011

2011-10-10T20:14:42Z

Justincc: New page: 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...

2011-10-10T20:07:49Z

New page: 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...

New page

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 handler that will return data for the simulator as a whole. These UUIDs will be different on each restart of the simulator (yes this is insane).

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

<pre>http://192.168.1.2:9000/F27ED466A0D311F8A7B1F309F942437F3302D455</pre>

yields

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

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

<pre>
{
"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"
}
</pre>

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.

← Older revision		Revision as of 08:32, 8 November 2013
Line 1:		Line 1:
		+	{{Quicklinks}}
		+
	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.		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.

@@ Line 35: / Line 35: @@
 "UxTime":1318276065,
 "Memory":31.0,
-"Version":"OpenSim 0.7.3 Dev          "
+"Version":"OpenSimulator 0.7.3 Dev          "
+}
 </pre>
@@ Line 72: / Line 72: @@
 "Memory":"21",
 "Uptime":"00:20:49.0991070",
-"Version":"OpenSim 0.7.3 Dev          013bf27"
+"Version":"OpenSimulator 0.7.3 Dev          013bf27"
+}
 </pre>
 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.

@@ Line 1: / Line 1: @@
-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.
+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.
+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.
@@ Line 22: / Line 22: @@
          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
+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
 <pre>http://192.168.1.2:9000/F27ED466A0D311F8A7B1F309F942437F3302D455</pre>
@@ Line 39: / Line 39: @@
 </pre>
-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
+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
 <pre>
@@ Line 76: / Line 76: @@
 </pre>
-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.
+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.