๐Ÿ“ก DSL Probe โ€” Guide

โ† Back to panel

What is DSL Probe

DSL Probe is a per-region monitoring tool for Second Life. You rez one prim in each sim you want to monitor. The prim periodically reports sim health (FPS, time dilation, prim usage, agent count, status, restart time) and the list of avatars currently in region (with their script count, memory, attachments, position). Everything appears in a web dashboard accessible without an account, via a one-shot magic link generated by touching the prim.

Two-line summary: One prim per sim โ†’ reports every 30 minutes โ†’ web dashboard at /probe_admin.php. No account, no password โ€” touch the prim to get your link. Live view + full history searchable by date.

Quick start

  1. Get the DSL Probe package (LSL script dsl_probe_v7).
  2. Rez a plain prim in the sim you want to monitor. Place it anywhere โ€” for prim-count features, on land you own.
  3. Drop the LSL script into the prim's Contents.
  4. The script registers and shows in chat:
    Registered. Magic-link:
    https://www.dataservicesl.com/probe_admin.php?magic=pr_xxxxxxxx
  5. Open the link in a browser โ†’ you are logged in for that owner.
  6. Wait ~10 seconds for the first cycle. The dashboard fills with data and refreshes every 5 minutes.

Getting the magic link again

Just touch the prim. You receive an IM with a fresh link valid 30 minutes. Only the prim owner can touch-to-link.

Adding more sims

Rez another prim with the same script in a different sim. It registers under the same owner UUID โ€” all your sims show up in the dashboard. Each prim works independently; if one sim restarts the others keep reporting.

The dashboard

Top bar (always visible)

ButtonFunction
๐Ÿ  HomeBack to the Sim Status page.
๐Ÿ“„ PDFPrint the current view / export to PDF (only the table is printed, no panels).
๐Ÿ“ฑ InstallAdd DSL Probe as an app icon to your phone home screen (PWA, iOS Safari / Android Chrome).
๐Ÿ”” AlertsConfigure Telegram / Email notifications and thresholds.
๐Ÿ“˜ GuideOpens this page.
๐Ÿ‘ค nameYour SL name (resolved automatically).
๐Ÿ‡ฎ๐Ÿ‡น/๐Ÿ‡ฌ๐Ÿ‡งSwitch interface language between Italian and English (cookie, persists across visits).
LogoutEnds the session. You'll need a new magic-link to re-enter.

In-world prim menu

Touching the prim as owner opens a dialog with:

Notifications (Telegram + Email)

The ๐Ÿ”” Alerts page lets each owner configure:

The page also shows a log of the last 20 alerts with status (ok / skipped / error) and a "โœ‰๏ธ Send test alert now" button to verify that delivery works before relying on it.

Install on phone (PWA)

The ๐Ÿ“ฑ Install tab lists step-by-step instructions for iPhone (Safari) and Android (Chrome). Once installed, DSL Probe opens as a standalone app icon โ€” no browser bars โ€” and the cookie-based session means it stays logged in across phone restarts (until the session expires or you tap Logout).

Page 1 โ€” Sim Status

Lists every sim you are monitoring. Columns:

ColumnMeaning
Sim NameRegion name.
Prims used/maxPrims on the parcel where the probe is rezzed.
Prims availablemax โˆ’ used.
FPSRegion frame rate (target 45).
Dilation1.0 = normal speed. Below 0.9 = sim under stress.
Statusup or down from Linden Lab.
Last restartDate/time of the last region restart.
Agent limitMaximum simultaneous avatars allowed.
#AvatarsCurrently in region (click to open avatar page).

Page 2 โ€” Avatars in Sim

Click the avatar count or the Avatars in Sim tab. The page lists every avatar ever seen in that sim, with an Active / Past badge.

ColumnMeaning
Status๐ŸŸข Active = in region during the latest cycle. โšช Past = seen before, not in the latest cycle.
AvatarDisplay name + UUID.
Last seenWhen this avatar was last reported.
Prims rezzed in simHow many prims this avatar owns on the probe's parcel. Requires the probe to be on land you own/manage, otherwise 0.
#AttachmentsNumber of objects worn.
Scripts runningActive scripts (root + all attachments).
Scripts totalAll scripts present including paused ones.
Memory (KB)Total script memory across the avatar.

Sim Status (main page)

When a sim is selected from the dropdown, the table shows the latest 100 history snapshots of that sim, in chronological order. This lets you see at a glance how FPS, dilation, prims and agent count have evolved over the last ~50 hours. For older data use the History tab.

Avatar page โ€” Present vs Registered

Two separate stat boxes on top:

The other stats (Scripts running / Scripts total / Total memory) are computed only on currently Present avatars.

Page 3 โ€” History

The ๐Ÿ“œ History tab opens the historical view: every sim snapshot saved (one row every 30 minutes, since the prim was rezzed). The default view shows the latest 50 records.

Filter form, top of page:

FieldUse
SimAll sims or a specific one.
From / ToDate range (YYYY-MM-DD). Leave empty for any.
LimitMax rows returned (10 โ€“ 1000, default 50).
๐Ÿ” FilterRun the query.
โ™ป๏ธ ResetClear filters.

The table shows: Timestamp ยท Sim ยท Agents ยท FPS ยท Dilation ยท Prims used ยท Prims max ยท Status. All columns are sortable.

Use History to spot:

Sim map

Both pages show a mini-map of the current sim. Red dots are the avatars currently in region.

Sorting

All column headers are clickable. First click sorts ascending โ–ฒ, second click descending โ–ผ.

Sim selector

Below the stat boxes there's a dropdown listing all your sims with a status dot (๐ŸŸข active, โšช inactive, ๐Ÿ“ฆ stale). Picking a sim jumps to its avatar page.

Update cycle

Every prim runs the same loop:

  1. Send sim stats (1 HTTP request) โ†’ also written to history.
  2. Get the avatar list from the sim.
  3. Send 1 record per avatar, 1 second apart.
  4. Wait 30 minutes, repeat.

So a sim with 30 avatars produces 31 HTTP requests every 30 minutes, spread across ~30 seconds. The live Sim Status tab reflects only avatars from the latest cycle (within 60 seconds of the last sim report); avatars seen in previous cycles still appear on the Avatars in Sim tab with a Past badge.

Storage estimate: ~500 bytes per sim snapshot. With 100 sims and a 30-minute interval, the SIM history grows by roughly 70 MB / month โ€” fine for a year of monitoring.

Limitations

Per-avatar prim count uses llGetParcelPrimOwners, which only returns data on land where the script owner is owner or manager. On land you don't own you'll see 0 prims for every avatar. This is a Second Life restriction, not a bug.
Display names may not appear immediately for avatars that haven't been resolved yet by Linden Lab's name service. The legacy "first.last" name is used as fallback.
Region status ("up"/"down") comes from llRequestSimulatorData(DATA_SIM_STATUS). It is updated once per cycle and might lag a few minutes behind reality.

Privacy

The probe stores only:

No payment info, no IP, no inventory. Records older than the latest cycle (~5 min) are kept for history but not surfaced as "active".

Troubleshooting

The prim says "HTTP 500" in chat

Server error. Check that you uploaded all PHP files (probe_config.php, api_probe.php, probe_admin.php) and the SQL setup (probe_setup.sql) on the configured database.

"Magic link expired or invalid"

Touch the prim again to get a fresh one. Links expire after 30 minutes.

Dashboard is empty after first cycle

Open https://www.dataservicesl.com/probe_debug.log to see the API request log. Common cause: SQL error visible there.

I see ghost avatars / wrong count

The dashboard only counts avatars updated within the last 60 s of the most recent sim report. If you see ghosts, the sim report itself may be stale โ€” touch the prim or reset the script.

Prims used / Prims rezzed always 0

Re-rez the probe prim on land you own or have group rights on. SL doesn't expose parcel inventory to unauthorized scripts.