Discord Stats Version 3.00.02 (2023-04-16)

IMPORTANT - IMPORTANT - IMPORTANT

This is a drop-in script for the "Discord Relay and Server Joiner" at version 2.05.04 or higher, which is available at https://marketplace.secondlife.com/p/p/19908039

This script WILL NOT FUNCTION WITHOUT the Discord Relay! It NEEDS the Discord Relay in order to function!

IMPORTANT - IMPORTANT - IMPORTANT

What does it do?
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀

The script monitors the performance of a region by looking at several dozen data points, including some performance benchmarking it measures on its own. It will monitor the region for changes to the individual parcels with regards to name, owner and size. It will also monitor the status of remote regions (online, offline, restarting). Finally, it will monitor SL statistics regarding number of online users (including trend indicator) and total population.

Unique sensor concept allows for additional data sources:

- Keep up to date of what happens on your region with the parcel monitor, that scan the region for changes to the individual parcels with regards to name, owner and size.

- Be informed about the status of other remote regions (online, offline, restarting).

- Get an insight into Second Life's overall population and online user numbers.

It will process the information in two ways:

- A short-term display as hovertext on top of the prim, giving a visual representation of the sim's performance, as well as listing current counts, hourly and daily rolling averages.
- A permanent record sent to your Discord channel, giving more statistics and changed sim-parameters as well as an hourly, daily and monthly performance report.

The report to the Discord channel will be sent at configurable intervals.

Terminology
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Sim/Simulator - Actual (virtual) server a Region runs on.
Region - A 256x256 meter large, named area. Regions can be full regions, homesteads or Mainland.
Estate - A group of Regions belonging to the same owner.
Parcel - A subsection of a Region, which can have an individual owner.

What data gets tracked?
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Sim data:
- server address (incl. changes)
- server version (incl. changes and link to Linden Lab Releas Notes)
- region-to-cpu ratio

Region data:
- estate name
- region name
- region type
- max prims
- prim bonus
- maximum avatars (agents) allowed

Remote region data:
- online/offline/restarting status

Parcel Tracking:
- list of parcels on the region
- changes to name, ownership or size of parcels

Second Life statistics:
- population number (total of signups to SL)
- online residents (including trend indicator)

Performance:
- agent concurrency
- frames per second (FPS) (higher = better)
- scripts run percentage (higher = better)
This is a unique feature not found in other scripts, as this metric is not accessible via the Linden Scripting Language
- region idle time
- uptime
- restarts

Snapshot statistics (hovertext):
- current FPS (higher = better)
- average FPS (minute)
- max FPS (day)
- min FPS (day)
- scripts run percentage (higher = better)
- average scripts run (minute)
- max scripts run (day)
- min scripts run (day)
- current agents (second)
- average agents (hour)
- max agents (day)
- uptime

Rolling statistics (hour, day, month, year):
- agent concurrency
- max FPS
- min FPS
- average FPS
- max scripts run
- min scripts run
- average scripts run
- region idle percentage

Sample output:
-----
Uptime: 13 days, 19 hours, 31 minutes
Current agents: 0 / 50
Agent ∅: 0.0 / hour, 0.9 / month
Agent ↑: 0 / hour, 1 / month
Current FPS: 8.2
FPS ∅: 19.3 / hour, 32.6 / month
FPS ↑: 26.4 / hour, 32.6 / month
FPS ↓: 8.2 / hour, 32.6 / month
Current Scripts Run: 23.3%
Scripts Run ∅: 49.5% / hour, 75.2% / month
Scripts Run ↑: 62.7% / hour, 75.2% / month
Scripts Run ↓: 17.9% / hour, 75.2% / month
Current Region Idle ∅: 23%
Region Idle: 27% / hour, 10% / month
----

Known Issues & Limitations
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀

No limitations known at this time.

Version history
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀

0.01.00 2021-06-23 Beta version to first testers
0.01.01 2021-07-10 Beta version to testers
0.01.02 2021-07-29 Beta version to testers
1.00.00 2021-08-04 First public release
1.01.01 2022-01-08 Scripts Run functionality, output and hovertext improvements, provisioning for map icon display
1.01.02 2022-01-14 Changed default for hovertext, added "classic" config option
1.02.01 2022-03-01 Fully reworked memory management, improved idle detection
1.03.00 2022-09-24 Parcel- and remote-sim monitors added
1.04.00 2022-11-17 Major rewrite of the sensor system, new sensor for SL stats