UXSimStatus

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (added quicklinks)
m (Remove doublon)
 
(20 intermediate revisions by 3 users not shown)
Line 15: Line 15:
 
     Stats_URI = "jsonSimStats"
 
     Stats_URI = "jsonSimStats"
  
...the URI can be anything you want, and is case sensitive. You can query
+
The URI can be anything you want, and is case sensitive. You can query
 
the URI directly to return a json string to use in php, python, java, etc.
 
the URI directly to return a json string to use in php, python, java, etc.
 
or you may use one of the popular javascript toolkits to have OpenSimulator
 
or you may use one of the popular javascript toolkits to have OpenSimulator
generate a callback for jsonp. The json serialization carries the following
+
generate a callback for jsonp.
data...
+
  
  {"AssetsInCache":5.0,"TimeAfterCacheMiss":0.0,"BlockedMissingTextureRequests":0.0,"AssetServiceRequestFailures":0.0,
+
The json serialization did carry the following data.
 +
{"AssetsInCache":5.0,"TimeAfterCacheMiss":0.0,"BlockedMissingTextureRequests":0.0,"AssetServiceRequestFailures":0.0,
 
  "abnormalClientThreadTerminations":0.0,"InventoryServiceRetrievalFailures":0.0,"Dilatn":0.967380821704865,"SimFPS":55.0,
 
  "abnormalClientThreadTerminations":0.0,"InventoryServiceRetrievalFailures":0.0,"Dilatn":0.967380821704865,"SimFPS":55.0,
 
  "PhyFPS":47.1628913879395,"AgntUp":0.0,"RootAg":0.0,"ChldAg":0.0,"Prims":0.0,"AtvPrm":0.0,"AtvScr":0.0,"ScrLPS":0.0,
 
  "PhyFPS":47.1628913879395,"AgntUp":0.0,"RootAg":0.0,"ChldAg":0.0,"Prims":0.0,"AtvPrm":0.0,"AtvScr":0.0,"ScrLPS":0.0,
Line 27: Line 27:
 
  "AgntFt":0.0,"ImgsFt":0.0,"Memory":"8","Uptime":"05:12:19.0365590","Version":"OpenSimulator Server  0.6.4.9533 "}
 
  "AgntFt":0.0,"ImgsFt":0.0,"Memory":"8","Uptime":"05:12:19.0365590","Version":"OpenSimulator Server  0.6.4.9533 "}
  
 +
This data may change, for example 0.9.2 may return
 +
{"Dilatn":"1","SimFPS":"55","PhyFPS":"55","AgntUp":"0","RootAg":"0","ChldAg":"0","NPCAg":"0","Prims":"1579",
 +
"AtvPrm":"1","AtvScr":"131","ScrLPS":"0","ScrEPS":"1","PktsIn":"0","PktOut":"0","PendDl":"0","PendUl":"0",
 +
"UnackB":"0","TotlFt":"18.18","NetFt":"0","PhysFt":"0.02","OthrFt":"0","AgntFt":"0","ImgsFt":"0","FrameDilatn":"1",
 +
"Logging in Users":"0","GeoPrims":"1579","Mesh Objects":"463","Script Engine Thread Count":"0","Util Thread Count":"0",
 +
"System Thread Count":"30","System Thread Active":"0","ProcMem":"202040","Memory":"43","Uptime":"00:00:49.3504200",
 +
"Version":"OpenSim 0.9.2.0 Yeti Dev 5ef462c","RegionName":"ubittest"}
  
  <source lang="html4strict">
+
* "XEngine Thread Count" has become "Script Engine Thread Count".
<html>
+
* If the Opensimulator instance was running more than one region, until 0.9.2 the region used for the stats was in fact not clear and not the same on each request. With 0.9.2 the region used will be the first that did create stats.<br>Now the URI can now include the query ?region=regionName or ?region=regionUUID to select a region, example:
<head>
+
  http://mysimhost:itsPort/jsonSimStats?region=MyPrettyHomeRegion
    <title>JSON Test</title>
+
http://mysimhost:itsPort/jsonSimStats?region=MyOtherPrettyRegion
<script src="http://ascent.bluewallgroup.com/jquery-1.3.2.js"></script>
+
(do not forget that a URI needs to be escaped, spaces need to be replaced by %20, etc)
<script src="http://ascent.bluewallgroup.com/timer.js"></script>
+
<br>
<script type="text/javascript" src="http://www.google.com/jsapi"></script>
+
<source lang="html4strict">
<script type="text/javascript" language="JavaScript">
+
<!DOCTYPE HTML>
  SimFPS = 0;
+
<html>
  PhyFPS = 0;
+
<head>
  Memory = 0;
+
<title>JSON Test</title>
  RootAg = 0;
+
<script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>
  ChldAg = 0;
+
<script src="http://www.google.com/jsapi"></script>
  Uptime = "";
+
<script>
  Version = "";
+
SimFPS = 0;
</script>
+
PhyFPS = 0;
 +
Memory = 0;
 +
RootAg = 0;
 +
ChldAg = 0;
 +
Uptime = "";
 +
Version = "";
 +
var url = "http://<IP_OR_DOMAIN>:<PORT>/jsonSimStats/?callback=?";
  
 +
setInterval(function() {$.getJSON(url, function(data) {
 +
    SimFPS = Math.round(data.SimFPS);
 +
    PhyFPS = Math.round(data.PhyFPS);
 +
    Memory = Math.round(data.Memory);
 +
    ChldAg = data.ChldAg;
 +
    RootAg = data.RootAg;
 +
    Uptime = data.Uptime;
 +
    Version = data.Version;
 +
    drawChart();
 +
    setTags();
 +
})}, 3000);
  
<script type="text/javascript" language="JavaScript">
+
google.load("visualization", "1.0", {packages:["gauge"]});
 +
google.setOnLoadCallback(drawChart);
  
 
+
function drawChart() {
  $.timer(15000, function(timer) {
+
  $.getJSON("http://ascent.bluewallgroup.com:9300/jsonSimStats/?callback=?",
+
 
+
  function(data){
+
 
+
      SimFPS = Math.round(data.SimFPS);
+
      PhyFPS = Math.round(data.PhyFPS);
+
      Memory = Math.round(data.Memory);
+
      ChldAg = data.ChldAg;
+
      RootAg = data.RootAg;
+
      Uptime = data.Uptime;
+
      Version = data.Version;
+
      drawChart();
+
      setTags();
+
      timer.reset(15000);
+
  });
+
  });
+
</script>
+
 
+
<script type="text/javascript" language="JavaScript">
+
 
+
  google.load("visualization", "1", {packages:["gauge"]});
+
  google.setOnLoadCallback(drawChart);
+
  function drawChart() {
+
 
     var cdata = new google.visualization.DataTable();
 
     var cdata = new google.visualization.DataTable();
 
     cdata.addColumn('string', 'Label');
 
     cdata.addColumn('string', 'Label');
Line 83: Line 84:
 
     cdata.setValue(2, 0, 'Memory');
 
     cdata.setValue(2, 0, 'Memory');
 
     cdata.setValue(2, 1, Memory);
 
     cdata.setValue(2, 1, Memory);
 
+
     var chart = new google.visualization.Gauge(document.getElementById('chart_div'));
     var chart = new
+
     var options = {width: 400, height: 120, redFrom: 90, redTo: 100, yellowFrom:75, yellowTo: 90, minorTicks: 5};
google.visualization.Gauge(document.getElementById('chart_div'));
+
     var options = {width: 400, height: 120, redFrom: 90, redTo: 100,
+
        yellowFrom:75, yellowTo: 90, minorTicks: 5};
+
 
     chart.draw(cdata, options);
 
     chart.draw(cdata, options);
  }
+
}
</script>
+
  
<script type="text/javascript" language="JavaScript">
+
function setTags() {
  function setTags() {
+
    $("#par-uptime").text("Uptime: "  + Uptime);
      $("#par-uptime").text("Uptime: "  + Uptime);
+
    $("#par-ragent").text("Root Agent: " + RootAg);
      $("#par-ragent").text("Root Agent: " + RootAg);
+
    $("#par-version").text("Version: " + Version);
      $("#par-version").text("Version: " + Version);
+
    $("#par-cagent").text("Child Agent: " + ChldAg);
      $("#par-cagent").text("Child Agent: " + ChldAg);
+
}
  }
+
</script>
</script>
+
</head>
 
+
<body>
</head>
+
<body>
+
 
= BlueWall Development Region =
 
= BlueWall Development Region =
<table>
+
<table>
<tr><td>
+
    <tr>
<div id="par-version">version</div>
+
        <td><div id="par-version">Version:</div></td>
</td><td>
+
        <td><div id="par-ragent">Root Agent:</div></td>
<div id="par-ragent">root agent</div>
+
    </tr>
</td></tr><tr><td>
+
    <tr>
<div id="par-uptime">uptime</div>
+
        <td><div id="par-uptime">Uptime:</div></td>
</td><td>
+
        <td><div id="par-cagent">Child Agent:</div></td>
<div id="par-cagent">child agent</div>
+
    </tr>
</td></tr>
+
</table>
</table>
+
<div id="chart_div"></div>
<div id="chart_div"></div>
+
</body>
</body>
+
</html>
</html>
+
</source>
</source>
+
'''Note:''' If you are having problems with cross-origin, you can try this script [[UXSimStatus_Aternatif]].
 
+
[[SSL in OpenSim]]
+
  
 
== JSON Grid Simstats ==
 
== JSON Grid Simstats ==
 
 
Python example to gain the region data from a grid service
 
Python example to gain the region data from a grid service
 
  - should work but this version not tested -
 
  - should work but this version not tested -
 
         *reference material*  
 
         *reference material*  
  
<source lang="python">
+
<source lang="python">
 
+
 
  import hashlib
 
  import hashlib
 
  import urllib2
 
  import urllib2
Line 154: Line 145:
  
 
  simdata = simplejson.load(urllib2.urlopen(simuri))
 
  simdata = simplejson.load(urllib2.urlopen(simuri))
 
+
</source>
</source>
+
'''See too''' [[SSL in OpenSim]]

Latest revision as of 07:29, 11 November 2021

As of OpenSimulator svn 9529 the xtended stats reporting will return a jsonp callback to allow popular javascript toolkits to use the returned data to create ajax monitoring applications in the browser. This is an advantage because after the page is loaded, the browser will interact directly with the region, eliminating traffic through the website (polling the region and servicing the browser). It also allows the creation of mashups to create mini-monitor apps in other pages.

To enable your stats reporting, set the following in your OpenSim.ini...

   ; Simulator Stats URI
   ; Enable JSON simulator data by setting a URI name (case sensitive)
   Stats_URI = "jsonSimStats"

The URI can be anything you want, and is case sensitive. You can query the URI directly to return a json string to use in php, python, java, etc. or you may use one of the popular javascript toolkits to have OpenSimulator generate a callback for jsonp.

The json serialization did carry the following data.

{"AssetsInCache":5.0,"TimeAfterCacheMiss":0.0,"BlockedMissingTextureRequests":0.0,"AssetServiceRequestFailures":0.0,
"abnormalClientThreadTerminations":0.0,"InventoryServiceRetrievalFailures":0.0,"Dilatn":0.967380821704865,"SimFPS":55.0,
"PhyFPS":47.1628913879395,"AgntUp":0.0,"RootAg":0.0,"ChldAg":0.0,"Prims":0.0,"AtvPrm":0.0,"AtvScr":0.0,"ScrLPS":0.0,
"PktsIn":0.0,"PktOut":0.0,"PendDl":0.0,"PendUl":0.0,"UnackB":0.0,"TotlFt":0.0,"NetFt":0.0,"PhysFt":0.0,"OthrFt":0.0,
"AgntFt":0.0,"ImgsFt":0.0,"Memory":"8","Uptime":"05:12:19.0365590","Version":"OpenSimulator Server  0.6.4.9533 "}

This data may change, for example 0.9.2 may return

{"Dilatn":"1","SimFPS":"55","PhyFPS":"55","AgntUp":"0","RootAg":"0","ChldAg":"0","NPCAg":"0","Prims":"1579",
"AtvPrm":"1","AtvScr":"131","ScrLPS":"0","ScrEPS":"1","PktsIn":"0","PktOut":"0","PendDl":"0","PendUl":"0",
"UnackB":"0","TotlFt":"18.18","NetFt":"0","PhysFt":"0.02","OthrFt":"0","AgntFt":"0","ImgsFt":"0","FrameDilatn":"1",
"Logging in Users":"0","GeoPrims":"1579","Mesh Objects":"463","Script Engine Thread Count":"0","Util Thread Count":"0",
"System Thread Count":"30","System Thread Active":"0","ProcMem":"202040","Memory":"43","Uptime":"00:00:49.3504200",
"Version":"OpenSim 0.9.2.0 Yeti Dev 5ef462c","RegionName":"ubittest"}
  • "XEngine Thread Count" has become "Script Engine Thread Count".
  • If the Opensimulator instance was running more than one region, until 0.9.2 the region used for the stats was in fact not clear and not the same on each request. With 0.9.2 the region used will be the first that did create stats.
    Now the URI can now include the query ?region=regionName or ?region=regionUUID to select a region, example:
http://mysimhost:itsPort/jsonSimStats?region=MyPrettyHomeRegion
http://mysimhost:itsPort/jsonSimStats?region=MyOtherPrettyRegion

(do not forget that a URI needs to be escaped, spaces need to be replaced by %20, etc)

<!DOCTYPE HTML>
<html>
<head>
<title>JSON Test</title>
<script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>
<script src="http://www.google.com/jsapi"></script>
<script>
SimFPS = 0;
PhyFPS = 0;
Memory = 0;
RootAg = 0;
ChldAg = 0;
Uptime = "";
Version = "";
var url = "http://<IP_OR_DOMAIN>:<PORT>/jsonSimStats/?callback=?";
 
setInterval(function() {$.getJSON(url, function(data) {
    SimFPS = Math.round(data.SimFPS);
    PhyFPS = Math.round(data.PhyFPS);
    Memory = Math.round(data.Memory);
    ChldAg = data.ChldAg;
    RootAg = data.RootAg;
    Uptime = data.Uptime;
    Version = data.Version;
    drawChart();
    setTags();
})}, 3000);
 
google.load("visualization", "1.0", {packages:["gauge"]});
google.setOnLoadCallback(drawChart);
 
function drawChart() {
    var cdata = new google.visualization.DataTable();
    cdata.addColumn('string', 'Label');
    cdata.addColumn('number', 'Value');
    cdata.addRows(3);
    cdata.setValue(0, 0, 'SimFPS');
    cdata.setValue(0, 1, SimFPS);
    cdata.setValue(1, 0, 'PhyFPS');
    cdata.setValue(1, 1, PhyFPS);
    cdata.setValue(2, 0, 'Memory');
    cdata.setValue(2, 1, Memory);
    var chart = new google.visualization.Gauge(document.getElementById('chart_div'));
    var options = {width: 400, height: 120, redFrom: 90, redTo: 100, yellowFrom:75, yellowTo: 90, minorTicks: 5};
    chart.draw(cdata, options);
}
 
function setTags() {
    $("#par-uptime").text("Uptime: "  + Uptime);
    $("#par-ragent").text("Root Agent: " + RootAg);
    $("#par-version").text("Version: " + Version);
    $("#par-cagent").text("Child Agent: " + ChldAg);
}
</script>
</head>
<body>
= BlueWall Development Region =
<table>
    <tr>
        <td><div id="par-version">Version:</div></td>
        <td><div id="par-ragent">Root Agent:</div></td>
    </tr>
    <tr>
        <td><div id="par-uptime">Uptime:</div></td>
        <td><div id="par-cagent">Child Agent:</div></td>
    </tr>
</table>
<div id="chart_div"></div>
</body>
</html>

Note: If you are having problems with cross-origin, you can try this script UXSimStatus_Aternatif.

[edit] JSON Grid Simstats

Python example to gain the region data from a grid service

- should work but this version not tested -
        *reference material* 
import hashlib
 import urllib2
 
 ''' value shown is an example, get this from your grid database each time - regions.regionSecret '''
 regionsecret = 'fe21314b-6267-44f7-aa1e-6047e1c3f94a'
 
 ''' My region host '''
 hostName =  myregion.host.net
 
 ''' My region port '''
 hostPort = 9000
 
 ''' create an *UPPERCASE* SHA1 hash from the regionSecret '''
 resourceName = str(hashlib.sha1(regionsecret).hexdigest()).upper()
 
 regionuri = hostName + ":" + hostPort + "/" + resourceName + "/"
 
 ''' data includes TimeZoneName , TimeZoneOffs, UxTime, Memory, Version and OSStatsURI '''
 regiondata = simplejson.load(urllib2.urlopen(regionuri))
 
 ''' OSStatsURI is the uri to query the OpenSimulator instance. return same data as the user set uri '''
 simuri = regiondata['OSStatsURI']
 
 simdata = simplejson.load(urllib2.urlopen(simuri))

See too SSL in OpenSim

Personal tools
General
About This Wiki