ALiVE.OS · ALiVE 3 Development
Performance Reporting
An admin's live readout of server performance, with samples written to the RPT
In development · ALiVE 3
ALiVE 3 is in active development. This briefing describes work in progress, and the behaviour it covers is subject to change as testing continues. Check the changelog at the foot of the page for what has moved recently.
On this page
Overview
What Performance Reporting does
Performance Reporting lets an admin watch how the server is coping. From the ALiVE menu, Perf > Start Perf samples the server every 60 seconds and writes each sample to the server RPT as one line starting ALiVE PERF. Show Perf puts a live readout on screen. While it is open the server takes a fresh sample every 10 seconds just for the readout, even if Start Perf was never used, and those extra samples are not written to the RPT. Stop Perf ends the RPT sampling. It needs no module of its own and no War Room connection.
Each sample records server FPS and minimum FPS, players, AI local to the server and AI elsewhere (headless clients, players' machines), groups, vehicles, dead bodies, active and inactive ALiVE profiles, running scripts and FSMs. The Perf entry only shows to a logged-in or voted admin (in single player, to the player), and the server refuses a start or stop from anyone else. The old recorder that sent the same kind of data to War Room is still off and kept for the War Room rebuild.
Capabilities
What it handles
Samples every 60 seconds
Writes each sample to the server RPT as one line starting ALiVE PERF, so a slowdown can be matched to what was running at the time. Monitoring stops when an admin uses Stop Perf or the mission ends.
Live readout for the admin
Shows the server's performance in a hint that updates every 10 seconds while it is open, whether or not Start Perf is running, and says so if the first sample is still on its way. Those readout samples are not written to the RPT. Use it again (Hide Perf) to close it.
On from the beginning if you want
Performance Monitoring at Start on the ALiVE Required module starts sampling as the mission begins, with no admin needed. It is off by default.
Players never see it
The menu entry is only shown to an admin, and a start or stop request from a machine without admin rights is refused and logged.
Recent work
What's changed lately
- Working for the first timeThe Perf menu never appeared and the recorder behind it only sent to War Room, which is offline. It now runs on the server without War Room, writes to the RPT, and has its own readout.
Status
Where it stands
Server performance from the ALiVE menu
Start Perf, Show Perf and Stop Perf for admins, samples in the RPT, and Performance Monitoring at Start on the Required module. Issue #1031.
Sending to War Room
The old web-service recorder is kept, still off, for when War Room is rebuilt.
Testing
How you can help
As an admin, open the ALiVE menu and go to Perf. Use Start Perf, then Show Perf: within about 10 seconds the readout fills with numbers that update every 10 seconds, and the server RPT gains a line starting ALiVE PERF every 60 seconds (the readout's own samples are not logged). Show Perf also works without Start Perf. Use Stop Perf and check Start Perf is offered again. As a non-admin, check there is no Perf entry. Also try Performance Monitoring at Start set to Yes on the Required module: samples should begin without anyone using the menu.
Spotted a problem? Please report it on the ALiVE issue tracker on GitHub, with the map, rough location and what the units were doing so it can be reproduced.
Changelog
Updates to this page
- 2026-10-13Show Perf updates its numbers every 10 seconds while it's open, instead of showing one snapshot. These samples aren't written to the RPT.
- 2026-10-08Show Perf labels its numbers in plain words (Lowest FPS, AI on server, Profiles spawned and so on), with mission time as hours, minutes and seconds. The RPT lines keep the short names.
- 2026-10-08Admins can watch server performance: Perf > Start Perf samples the server every 60 seconds into the RPT (lines starting ALiVE PERF), Show Perf displays the latest sample, and Performance Monitoring at Start on the Required module turns it on from the beginning (#1031).
- 2026-09-23This page no longer says Performance Reporting records sessions. It does not run at all, and has not in any public build. Nothing to look for in War Room.
- 2026-07-27Page first published.