Web Statistics Module
From OpenSimulator
Contents |
Introduction
The Web Statistics Module provides region statistics information. The data is provided as an AJAX html page which automatically updates over time. The page is provided by the internal OpenSimulator web server. The module also stores historical data which is displayed on these web pages.
Enabling Web Statistics
Edit OpenSim.ini:
[WebStats] enabled=true
Accessing Web Statistics
You can access region web statistics pages by pointing your browser at:
http://<region-server-ip>:<http-port>/SStats/
For example, if you are running a standalone OpenSimulator at 192.168.1.2:9000, you would go to the URL
http://192.168.1.2:9000/SStats/
Please note that the trailing / is essential right now.
Viewing recorded statistics
The Web Statistics module also records viewer stats data uploaded by viewers. This is sent on login and thereafter every 5 minutes and just before logout. The client may choose not to send this information.
This data is stored in an sqlite3 database at bin/LocalUserStatistics.db.
Columns are as follows. Some of the meanings are unclear since they are taken directly from the client data packet rather than generated by OpenSimulator itself.
| Column | Description |
|---|---|
| session_id | Client session id |
| agent_id | User ID |
| region_id | ID of the region the user was on |
| last_updated | Probably a unix timestamp of the time this update was sent. |
| remote_ip | Client IP |
| name_f | First name of user |
| name_l | Last name of user |
| avg_agents_in_view | Average number of other users in the view of this user |
| min_agents_in_view | Minimum users that have been in the view of this user |
| max_agents_in_view | Maximum users that have been in this user's view |
| mode_agents_in_view | Numeric mode of users that have been in view |
| avg_fps | Average fps of this user |
| min_fps | Min fps of this user |
| max_fps | Max fps of this user |
| mode_fps | Mode fps of this user |
| a_language | Unknown, probably language client is set to |
| mem_use | Memory user of client |
| meters_traveled | Meters travelled by user |
| avg_ping | Average ping of client to servers |
| min_ping | Minimum ping of client to servers |
| max_ping | Maximum ping of client to servers |
| mode_ping | Mode of ping from client to servers |
| regions_visited | Number of regions that this client has visited |
| run_time | Run time of client |
| avg_sim_fps | Average simulator fps of simulators the client has been on |
| min_sim_fps | Min simulator fps of simulators the client has been on |
| max_sim_fps | Max simulator fps of simulators the client has been on |
| mode_sim_fps | Mode simulator fps of simulators the client has been on |
| start_time | Time at which client was started |
| client_version | Client version |
| s_cpu | CPU of machine running client |
| s_gpu | GPU of machine running client |
| s_os | Operating system of the machine running the client |
| s_ram | RAM of the machine running the client |
| d_object_kb | Memory used by scene objects in the client |
| d_texture_kb | Memory used by textures in the client |
| d_world_kb | Memory used by the world in the client |
| n_in_kb | kb received by client from servers |
| n_in_pk | Packets received by client from servers |
| n_out_kb | kb send by client to servers |
| n_out_pk | Packets sent by client to servers |
| f_dropped | Packets dropped (inbound?) |
| f_failed_resends | Packets requested but not resent by servers (?) |
| f_invalid | Invalid packets received |
| f_off_circuit | Packets received not associated with any known circuit |
| f_resent | Packets resent to simulator due to no ack |
| f_send_packets | Unknown |
| session_key | Same as session_id (?!) |
| agent_key | Same as agent_id (?!) |
| region_key | Same as region_id (?!) |
Feature Requests
Please note that these are feature requests - these have not (yet) been implemented!
- XMLRPC access
- Public JSON API for accessing counters.
- Uptime counter.
- Region build version.
- Number of unique visitors during last hour.
- Number of unique visitors during last 24 hours.
- Grid based policy framework for setting it up.
- Access Authorization
