39 lines
3.0 KiB
Markdown
39 lines
3.0 KiB
Markdown
# Metrics
|
|
|
|
Metrics is a primary navigation tab at `/metrics` (keyboard shortcut: `g m`).
|
|
Choose the past 24 hours, 7 days, or 30 days. The page refreshes every minute.
|
|
|
|
The overview shows **Time with players** (occupied server-hours divided by known
|
|
server-hours) and **Player-hours**. Known and unknown status time remain visible
|
|
alongside the totals. **Last collected** is the newest recorded batch, including
|
|
unknown checks; **Report refreshed** is when this report was calculated. Collection
|
|
stops when no servers are registered. Earliest retained observations do not prove
|
|
continuous history or the original installation date.
|
|
|
|
Background refresh keeps the last successful report visible on failure and offers
|
|
Retry. Returning to a visible tab refreshes immediately. The selected range is
|
|
stored in the URL, and refreshes preserve table controls and chart selection.
|
|
|
|
The timeline has labelled axes and marks partial edge periods. Select a period,
|
|
use Previous/Next, or select a bar to inspect its exact interval and values. The
|
|
time table supplies the same figures for comparison and assistive technology.
|
|
Zero captured time is distinct from an observed empty server. Short durations use
|
|
seconds or minutes so a real observation is not rounded to zero.
|
|
|
|
Map and server tables support numeric sorting and local search. Their searches
|
|
apply only to the named table. Known-capacity duration stays next to all-full time.
|
|
Server identities retain the technical name; rows describe history grouped by
|
|
name, which may include different instances if a name was reused.
|
|
|
|
- Utilized means a successful status response reported at least one player.
|
|
- Idle means a successful response reported zero players.
|
|
- Unknown covers failed checks, provisioning, and unavailable containers; it is excluded from utilization percentages.
|
|
- Player-hours integrate the reported player count over observed time. Bots are included if the server counts them as players.
|
|
- All lobbies full measures map wall time when every tracked lobby in that game/map group has a known capacity and is full. Missing capacity or status makes that interval unknown. This is a capacity-pressure indicator, not a count of rejected joins or unmet demand.
|
|
|
|
Observations are recorded by the existing status worker. Each remains valid until the next collection, up to the 45-second freshness limit. Longer manager outages are excluded. Charts split time at UTC hour/day boundaries; partial periods remain partial. Map variants use the configured variant when it matches the reported map.
|
|
|
|
Capacity comes from `sv_maxclients` / `sv_maxClients` in the status response. When unavailable, the UI displays unknown rather than assuming a four-player limit. Capacity coverage is the map time for which every tracked lobby reported both occupancy and capacity.
|
|
|
|
Collection begins after this feature is installed; previous occupancy cannot be reconstructed. Samples are retained for 31 days and pruned during collection. They survive removal of a server and contain no player identities. The additive database table is created automatically on startup.
|