system-resource-monitor 0.1.0

Anonymous Ubuntu host-level CPU/GPU resource and power monitor.

Anonymous System Resource Monitor

This is a host-level Ubuntu monitor for group servers. It samples aggregate CPU, memory, load, GPU power/utilization/memory/temperature, and best-effort CPU package power. It does not record PID, username, command line, Docker container, image, or compose service information.

Install from PyPI

Recommended with pipx:

sudo apt update
sudo apt install -y pipx
pipx ensurepath
pipx install system-resource-monitor

sudo "$(command -v system-resource-monitor)" install-systemd

Then check the timer:

systemctl list-timers system-resource-monitor.timer
sudo "$(command -v system-resource-monitor)" status

Safety Contract

The collect and report commands are read-only with respect to running workloads:

• They do not call docker, kill, pkill, os.kill, signal APIs, terminate(), or kill().

• They do not enumerate /proc/<pid> and do not inspect per-process metadata.

• The only external command used by collect is:

  nvidia-smi --query-gpu=index,uuid,name,power.draw,utilization.gpu,utilization.memory,memory.used,memory.total,temperature.gpu --format=csv,noheader,nounits
  

• The install-systemd, uninstall-systemd, and status commands may call systemctl, but only to manage system-resource-monitor.service and system-resource-monitor.timer.

• The systemd unit also drops CAP_KILL and denies common signal-sending syscalls, so even accidental future signal-sending code should fail under the timer service.

Install from Source

cd system-resource-monitor

sudo mkdir -p /opt/system-resource-monitor /var/lib/system-resource-monitor
sudo install -m 0755 system_resource_monitor.py /opt/system-resource-monitor/system_resource_monitor.py
sudo install -m 0644 README.md /opt/system-resource-monitor/README.md
sudo install -m 0644 system-resource-monitor.service /etc/systemd/system/system-resource-monitor.service
sudo install -m 0644 system-resource-monitor.timer /etc/systemd/system/system-resource-monitor.timer
sudo chmod 0750 /var/lib/system-resource-monitor

sudo systemctl daemon-reload
sudo systemctl enable --now system-resource-monitor.timer

If installed as a Python package, prefer:

sudo "$(command -v system-resource-monitor)" install-systemd

Check Status

systemctl list-timers system-resource-monitor.timer
sudo systemctl status system-resource-monitor.service
journalctl -u system-resource-monitor.service -n 50

Collect Once

sudo "$(command -v system-resource-monitor)" collect

Export Reports

Recent 24 hours:

sudo "$(command -v system-resource-monitor)" report \
  --since-hours 24 \
  --out /tmp/system_resource_report_24h.csv

Recent 7 days:

sudo "$(command -v system-resource-monitor)" report \
  --since-hours 168 \
  --out /tmp/system_resource_report_7d.csv

Notes

• GPU metrics use nvidia-smi --query-gpu, so NVIDIA drivers must be installed for GPU rows to appear.
• CPU package power is read from /sys/class/powercap/intel-rapl:* when the kernel exposes it. If unavailable, it is stored as empty/NULL.
• Energy estimates use power_w * interval_sec; first samples and samples after long gaps are not counted toward kWh estimates.
• Data older than 90 days is deleted during each collection.