[Feature]: Count servers that do not run monitor in LinuxGSM Stats

Open
#5,204 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
68/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
bash, shell

Research direction

Start by reading info_stats.sh and its call sites in command_monitor.sh (lines 319 and 466), then trace the install opt-in and start flows. Done means opted-in installs report after opting in and after starting, without CPU or RAM values, while the once-a-day limit prevents duplicate reports; update the docs to name the commands that send reports.

Written by the indexing model from the issue text.

Description

command: install command: monitor command: start priority: medium scope: all servers type: feature
Priority

priority: medium

User story

As an admin who opted in to stats but only uses start and stop (a one-off server, an occasional game night, or a LAN or online event), I want that server counted, so that the usage page shows every opted-in install, not only the ones running monitor.

Game

No response

Linux distro

No response

Command

command: install, command: start, command: monitor

Problem statement

info_stats.sh is only called from monitor (command_monitor.sh lines 319 and 466). Admins who run a server once or now and then without a monitor cron job never send a report: one-off servers, occasional game nights, LAN parties and other online or offline events. They are missing from https://linuxgsm.com/data/usage/, so the page only counts servers that run monitor.

Scope and impact

scope: all servers

Further information

Also send the daily report from:

  • install, right after the user opts in to stats.
  • start, after the server has started.

Both should leave out CPU and RAM use: there is none after install, and right after start the values say little.

Since #5198 a report goes out at most once a day per instance, so servers that run monitor send nothing extra. On a day when install or start sends first, the report has no usage values, and monitor sends them from the next day.

GameServerManagers/LinuxGSM-Docs#154 says reports are sent "when stats run". The docs should name the commands that send them.

Alternatives considered
  • stop: the server is still running, so the usage values are real, but with start sending first it would only add a report when a server runs past midnight UTC.
  • details: running it does not mean the server is in use, and anyone who runs it has already installed or started the server.
  • Leave it as is and say in the docs that only servers running monitor are counted.

🤖 Generated with Claude Code

Dominant language
Shell
Stars
4.9k
Forks
866
Avg merge
17h 58m
Merged PRs (30d)
100

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from GameServerManagers/LinuxGSM

All issues in GameServerManagers/LinuxGSM

Similar issues

More Shell/Bash issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.