Portability: sysfs-only sensors with thermal-zone fallback, /sys/block disk discovery, fs blacklist, pwrstat/NUT/apcupsd UPS, login shell from passwd, templated unit + install for any user, cross-compile targets

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
Mitchell-Johnson
2026-09-17 13:43:44 -07:00
co-authored by Claude Fable 5.1
parent 3c6f4d4639
commit 7053cce7fe
9 changed files with 432 additions and 102 deletions
+4
View File
@@ -12,6 +12,10 @@ web:
build: web build: web
$(GO) build -trimpath -ldflags "-s -w -X main.version=$(VERSION)" -o bin/hamlab ./cmd/hamlab $(GO) build -trimpath -ldflags "-s -w -X main.version=$(VERSION)" -o bin/hamlab ./cmd/hamlab
# cross-compile for another Linux box (static binary, no cgo): make build-arm64 / build-amd64
build-%: web
CGO_ENABLED=0 GOOS=linux GOARCH=$* $(GO) build -trimpath -ldflags "-s -w -X main.version=$(VERSION)" -o bin/hamlab-linux-$* ./cmd/hamlab
# backend only (assumes web/dist already built) # backend only (assumes web/dist already built)
go: go:
$(GO) build -ldflags "-X main.version=$(VERSION)" -o bin/hamlab ./cmd/hamlab $(GO) build -ldflags "-X main.version=$(VERSION)" -o bin/hamlab ./cmd/hamlab
+21 -3
View File
@@ -3,8 +3,26 @@
Web-based Linux management console for bare-metal Debian, in the style of the Proxmox Web-based Linux management console for bare-metal Debian, in the style of the Proxmox
web UI. Named after Ham the cat (see also HamTV). web UI. Named after Ham the cat (see also HamTV).
Status: **planning**. See [`PLAN.md`](PLAN.md) for the MVP scope and roadmap. No code yet. Status: **v0.1** — persistent web terminals and a live Dashboard tab. Scope and roadmap in
[`PLAN.md`](PLAN.md).
- Runs as a systemd service on the host it manages, as user `core`. ## Runs on any Linux box
- Public at `https://hamlab.bigham.dev` (behind Nginx Proxy Manager on `core`).
One static Go binary with the UI embedded; no cgo, no Node at runtime, no agents. The
Dashboard reads `/proc` and `/sys` directly (CPU, memory, hwmon or thermal-zone temps,
fans, NICs, block devices, mounts) so it works the same on x86 and ARM, bare metal or VM,
and just leaves a section empty when the hardware has nothing to report. UPS status is
optional and picked up from whichever of `pwrstat`, NUT (`upsc`) or `apcupsd` is
installed.
```sh
make build # web + Go, or: make build-arm64 for a cross-compile
./deploy/install.sh # installs the binary + a systemd unit for the invoking user
hamlab passwd # set the login password (config in ~/apps/hamlab/)
sudo systemctl start hamlab # listens on 127.0.0.1:8100 by default; set "listen" in config.json
```
Terminals run as the user the service runs as, with that user's login shell.
- On `core` it is public at `https://hamlab.bigham.dev` behind Nginx Proxy Manager.
- Installable as a PWA. - Installable as a PWA.
+23 -1
View File
@@ -12,6 +12,7 @@ import (
"os/signal" "os/signal"
"os/user" "os/user"
"path/filepath" "path/filepath"
"strings"
"syscall" "syscall"
"time" "time"
@@ -116,7 +117,7 @@ func serve(cfg *config.Config) error {
} }
shell := os.Getenv("SHELL") shell := os.Getenv("SHELL")
if shell == "" { if shell == "" {
shell = "/bin/bash" shell = loginShell(u.Username)
} }
mgr := hterm.NewManager(shell, u.HomeDir) mgr := hterm.NewManager(shell, u.HomeDir)
mgr.OnChange = func(list []hterm.Info) { mgr.OnChange = func(list []hterm.Info) {
@@ -162,3 +163,24 @@ func serve(cfg *config.Config) error {
} }
return nil return nil
} }
// loginShell returns the user's shell from /etc/passwd, falling back to bash if
// present and /bin/sh otherwise. Systemd units don't export $SHELL.
func loginShell(username string) string {
if b, err := os.ReadFile("/etc/passwd"); err == nil {
for _, line := range strings.Split(string(b), "\n") {
f := strings.Split(line, ":")
if len(f) >= 7 && f[0] == username && f[6] != "" {
if _, err := os.Stat(f[6]); err == nil {
return f[6]
}
}
}
}
for _, sh := range []string{"/bin/bash", "/usr/bin/bash", "/bin/zsh", "/bin/sh"} {
if _, err := os.Stat(sh); err == nil {
return sh
}
}
return "/bin/sh"
}
+5 -5
View File
@@ -4,11 +4,11 @@ After=network.target
[Service] [Service]
Type=simple Type=simple
User=core User=@USER@
Group=core Group=@GROUP@
WorkingDirectory=/home/core WorkingDirectory=@HOME@
Environment=HAMLAB_CONFIG=/home/core/apps/hamlab/config.json Environment=HAMLAB_CONFIG=@HOME@/apps/hamlab/config.json
ExecStart=/usr/local/bin/hamlab serve ExecStart=@PREFIX@/hamlab serve
Restart=always Restart=always
RestartSec=3 RestartSec=3
KillMode=control-group KillMode=control-group
+26 -5
View File
@@ -1,11 +1,32 @@
#!/bin/sh #!/bin/sh
# Install the built binary and unit on this host, then (re)start the service. # Install the built binary and a systemd unit on this host, then (re)start the service.
# Runs as the user who should own the terminals (their login shell, their sudo rights);
# needs sudo only for the copy into /usr/local/bin and the unit install.
#
# HAMLAB_USER user the daemon runs as (default: the invoking user)
# PREFIX binary directory (default: /usr/local/bin)
set -eu set -eu
cd "$(dirname "$0")/.." cd "$(dirname "$0")/.."
sudo install -m 0755 bin/hamlab /usr/local/bin/hamlab
sudo install -m 0644 deploy/hamlab.service /etc/systemd/system/hamlab.service USER_NAME="${HAMLAB_USER:-${SUDO_USER:-$(id -un)}}"
GROUP_NAME="$(id -gn "$USER_NAME")"
HOME_DIR="$(getent passwd "$USER_NAME" | cut -d: -f6)"
PREFIX="${PREFIX:-/usr/local/bin}"
[ -n "$HOME_DIR" ] || { echo "no home dir for $USER_NAME" >&2; exit 1; }
unit=$(mktemp)
sed -e "s|@USER@|$USER_NAME|g" -e "s|@GROUP@|$GROUP_NAME|g" -e "s|@HOME@|$HOME_DIR|g" -e "s|@PREFIX@|$PREFIX|g" \
deploy/hamlab.service > "$unit"
sudo install -m 0755 bin/hamlab "$PREFIX/hamlab"
sudo install -m 0644 "$unit" /etc/systemd/system/hamlab.service
rm -f "$unit"
sudo systemctl daemon-reload sudo systemctl daemon-reload
sudo systemctl enable --now hamlab.service >/dev/null sudo systemctl enable hamlab.service >/dev/null
if [ ! -f "$HOME_DIR/apps/hamlab/config.json" ]; then
echo "No config yet. Set a password, then start: $PREFIX/hamlab passwd && sudo systemctl start hamlab" >&2
exit 0
fi
sudo systemctl restart hamlab.service sudo systemctl restart hamlab.service
sleep 1 sleep 1
systemctl is-active hamlab.service && /usr/local/bin/hamlab version systemctl is-active hamlab.service && "$PREFIX/hamlab" version
+5 -1
View File
@@ -10,6 +10,7 @@ import (
"log" "log"
"net/http" "net/http"
"os" "os"
"os/user"
"strings" "strings"
"time" "time"
@@ -41,8 +42,11 @@ func New(cfg *config.Config, sessions *auth.Sessions, mgr *term.Manager, col *me
host, _ := os.Hostname() host, _ := os.Hostname()
s := &Server{cfg: cfg, sessions: sessions, mgr: mgr, metrics: col, ui: ui, version: version, s := &Server{cfg: cfg, sessions: sessions, mgr: mgr, metrics: col, ui: ui, version: version,
started: time.Now(), host: host, user: os.Getenv("USER")} started: time.Now(), host: host, user: os.Getenv("USER")}
if u, err := user.Current(); err == nil && u.Username != "" {
s.user = u.Username
}
if s.user == "" { if s.user == "" {
s.user = "core" s.user = "?"
} }
m := http.NewServeMux() m := http.NewServeMux()
m.HandleFunc("GET /healthz", func(w http.ResponseWriter, _ *http.Request) { w.WriteHeader(204) }) m.HandleFunc("GET /healthz", func(w http.ResponseWriter, _ *http.Request) { w.WriteHeader(204) })
+303 -55
View File
@@ -1,7 +1,12 @@
// Package metrics samples host telemetry (CPU, memory, temps, fans, network, disks, // Package metrics samples host telemetry (CPU, memory, temps, fans, network, disks,
// filesystems, UPS) on a timer into an in-memory ring, for the Dashboard tab. // filesystems, UPS) on a timer into an in-memory ring, for the Dashboard tab.
// Everything is read from /proc and /sys directly; the only external command is //
// pwrstat (CyberPower PowerPanel), which is optional. // Portability rules: everything comes from /proc and /sys, which every Linux kernel
// exposes the same way regardless of distro or architecture; nothing here needs
// lm-sensors, smartmontools or root. Sections whose source is absent (no fans, no
// UPS daemon, no hwmon at all on a VM) simply come back empty rather than failing.
// The only external commands are optional UPS daemons: pwrstat (CyberPower), upsc
// (NUT) and apcaccess (apcupsd), tried in that order.
package metrics package metrics
import ( import (
@@ -24,7 +29,7 @@ const (
History = 300 // samples kept (10 min at 2 s) History = 300 // samples kept (10 min at 2 s)
fsEvery = 15 // sample fs usage every N ticks fsEvery = 15 // sample fs usage every N ticks
upsEvery = 5 // sample UPS every N ticks upsEvery = 5 // sample UPS every N ticks
sectorSize = 512 sectorSize = 512 // /proc/diskstats always counts 512-byte sectors
) )
type Mem struct { type Mem struct {
@@ -59,6 +64,7 @@ type Net struct {
type Disk struct { type Disk struct {
Name string `json:"name"` Name string `json:"name"`
Model string `json:"model,omitempty"` Model string `json:"model,omitempty"`
Size uint64 `json:"size"`
ReadBps float64 `json:"read_bps"` ReadBps float64 `json:"read_bps"`
WriteBps float64 `json:"write_bps"` WriteBps float64 `json:"write_bps"`
UtilPct float64 `json:"util_pct"` UtilPct float64 `json:"util_pct"`
@@ -73,9 +79,11 @@ type FS struct {
} }
type UPS struct { type UPS struct {
Driver string `json:"driver"` // pwrstat | nut | apcupsd
Model string `json:"model"` Model string `json:"model"`
State string `json:"state"` State string `json:"state"`
Source string `json:"source"` Source string `json:"source"`
OnBattery bool `json:"on_battery"`
InV float64 `json:"in_v"` InV float64 `json:"in_v"`
OutV float64 `json:"out_v"` OutV float64 `json:"out_v"`
BatteryPct float64 `json:"battery_pct"` BatteryPct float64 `json:"battery_pct"`
@@ -122,12 +130,19 @@ type Collector struct {
prevT time.Time prevT time.Time
lastFS []FS lastFS []FS
lastUPS *UPS lastUPS *UPS
upsOK bool upsProbe func() *UPS // nil when no UPS daemon is installed
} }
func NewCollector() *Collector { func NewCollector() *Collector {
c := &Collector{prevNet: map[string][2]uint64{}, prevDisk: map[string][3]uint64{}} c := &Collector{prevNet: map[string][2]uint64{}, prevDisk: map[string][3]uint64{}}
c.upsOK = lookPath("pwrstat") && lookPath("sudo") switch {
case lookPath("pwrstat"):
c.upsProbe = upsPwrstat
case lookPath("upsc"):
c.upsProbe = upsNUT
case lookPath("apcaccess"):
c.upsProbe = upsAPC
}
return c return c
} }
@@ -207,15 +222,18 @@ func (c *Collector) sample() {
s.Mem, s.Swap = meminfo() s.Mem, s.Swap = meminfo()
s.Uptime = uptime() s.Uptime = uptime()
s.Temps, s.Fans = hwmon() s.Temps, s.Fans = hwmon()
if len(s.Temps) == 0 {
s.Temps = thermalZones() // ARM SoCs and older kernels often expose only these
}
s.Net = c.net(dt) s.Net = c.net(dt)
s.Disks = c.disks(dt, s.Temps) s.Disks = c.disks(dt)
if c.tick%fsEvery == 0 || c.lastFS == nil { if c.tick%fsEvery == 0 || c.lastFS == nil {
c.lastFS = filesystems() c.lastFS = filesystems()
} }
s.FS = c.lastFS s.FS = c.lastFS
if c.upsOK && (c.tick%upsEvery == 0 || c.lastUPS == nil) { if c.upsProbe != nil && (c.tick%upsEvery == 0 || c.lastUPS == nil) {
c.lastUPS = ups() c.lastUPS = c.upsProbe()
} }
s.UPS = c.lastUPS s.UPS = c.lastUPS
c.tick++ c.tick++
@@ -307,6 +325,9 @@ func meminfo() (Mem, Mem) {
m[k] = n * 1024 m[k] = n * 1024
} }
mem := Mem{Total: m["MemTotal"], Avail: m["MemAvailable"]} mem := Mem{Total: m["MemTotal"], Avail: m["MemAvailable"]}
if mem.Avail == 0 { // pre-3.14 kernels: approximate
mem.Avail = m["MemFree"] + m["Buffers"] + m["Cached"]
}
mem.Used = mem.Total - mem.Avail mem.Used = mem.Total - mem.Avail
swap := Mem{Total: m["SwapTotal"], Avail: m["SwapFree"]} swap := Mem{Total: m["SwapTotal"], Avail: m["SwapFree"]}
swap.Used = swap.Total - swap.Avail swap.Used = swap.Total - swap.Avail
@@ -325,16 +346,25 @@ func uptime() float64 {
return 0 return 0
} }
// ---- temperatures and fans ----
var sensorRe = regexp.MustCompile(`^(temp|fan)(\d+)_input$`) var sensorRe = regexp.MustCompile(`^(temp|fan)(\d+)_input$`)
func hwmon() ([]Temp, []Fan) { // tempLimit reads a *_max / *_crit file; values outside 0-200 °C are unset sentinels
temps, fans := []Temp{}, []Fan{} // (NVMe reports ~65000 for absent thresholds).
dirs, _ := filepath.Glob("/sys/class/hwmon/hwmon*") func tempLimit(p string) float64 {
for _, d := range dirs { if v, ok := readInt(p); ok && v > 0 && v < 200000 {
chip := strings.TrimSpace(readStr(filepath.Join(d, "name"))) return float64(v) / 1000
}
return 0
}
// hwmonDir reads every temp*/fan* sensor under one hwmon directory.
func hwmonDir(d string) (chip string, temps []Temp, fans []Fan) {
chip = strings.TrimSpace(readStr(filepath.Join(d, "name")))
ents, err := os.ReadDir(d) ents, err := os.ReadDir(d)
if err != nil { if err != nil {
continue return
} }
for _, e := range ents { for _, e := range ents {
m := sensorRe.FindStringSubmatch(e.Name()) m := sensorRe.FindStringSubmatch(e.Name())
@@ -351,19 +381,22 @@ func hwmon() ([]Temp, []Fan) {
label = base label = base
} }
if m[1] == "temp" { if m[1] == "temp" {
t := Temp{Chip: chip, Label: label, C: float64(raw) / 1000} temps = append(temps, Temp{Chip: chip, Label: label, C: float64(raw) / 1000,
// Limits outside 0-200 °C are unset sentinels (NVMe reports ~65000 for absent ones). Max: tempLimit(filepath.Join(d, base+"_max")), Crit: tempLimit(filepath.Join(d, base+"_crit"))})
if v, ok := readInt(filepath.Join(d, base+"_max")); ok && v > 0 && v < 200000 { } else if raw > 0 || fileExists(filepath.Join(d, base+"_enable")) {
t.Max = float64(v) / 1000
}
if v, ok := readInt(filepath.Join(d, base+"_crit")); ok && v > 0 && v < 200000 {
t.Crit = float64(v) / 1000
}
temps = append(temps, t)
} else {
fans = append(fans, Fan{Chip: chip, Label: label, RPM: int(raw)}) fans = append(fans, Fan{Chip: chip, Label: label, RPM: int(raw)})
} }
} }
return
}
func hwmon() ([]Temp, []Fan) {
temps, fans := []Temp{}, []Fan{}
dirs, _ := filepath.Glob("/sys/class/hwmon/hwmon*")
for _, d := range dirs {
_, t, f := hwmonDir(d)
temps = append(temps, t...)
fans = append(fans, f...)
} }
sort.SliceStable(temps, func(i, j int) bool { sort.SliceStable(temps, func(i, j int) bool {
if temps[i].Chip != temps[j].Chip { if temps[i].Chip != temps[j].Chip {
@@ -374,9 +407,67 @@ func hwmon() ([]Temp, []Fan) {
return temps, fans return temps, fans
} }
func thermalZones() []Temp {
out := []Temp{}
dirs, _ := filepath.Glob("/sys/class/thermal/thermal_zone*")
for _, d := range dirs {
raw, ok := readInt(filepath.Join(d, "temp"))
if !ok || raw <= 0 {
continue
}
typ := strings.TrimSpace(readStr(filepath.Join(d, "type")))
if typ == "" {
typ = filepath.Base(d)
}
t := Temp{Chip: "thermal", Label: typ, C: float64(raw) / 1000}
// trip points: trip_point_N_type in {critical, hot, passive, active}
trips, _ := filepath.Glob(filepath.Join(d, "trip_point_*_type"))
for _, tp := range trips {
kind := strings.TrimSpace(readStr(tp))
v := tempLimit(strings.TrimSuffix(tp, "_type") + "_temp")
switch kind {
case "critical":
t.Crit = v
case "hot", "passive":
if t.Max == 0 || v < t.Max {
t.Max = v
}
}
}
out = append(out, t)
}
return out
}
// blockTemp finds the drive's own temperature via the hwmon node the kernel attaches
// to the device: the nvme driver and drivetemp (SATA/SAS) both do this.
func blockTemp(name string) float64 {
for _, pat := range []string{"/sys/block/" + name + "/device/hwmon*", "/sys/block/" + name + "/device/hwmon/hwmon*"} {
dirs, _ := filepath.Glob(pat)
for _, d := range dirs {
if v, ok := readInt(filepath.Join(d, "temp1_input")); ok {
return float64(v) / 1000
}
}
}
return 0
}
// ---- network ----
// Virtual interfaces that only ever carry traffic already counted on a real one.
var skipIfacePrefix = []string{"veth", "br-", "docker", "virbr", "vnet", "tap", "lxc", "lxd", "cni", "flannel", "cali", "kube", "podman", "dummy"}
func skipIface(n string) bool { func skipIface(n string) bool {
return n == "lo" || strings.HasPrefix(n, "veth") || strings.HasPrefix(n, "br-") || if n == "lo" {
strings.HasPrefix(n, "docker") || strings.HasPrefix(n, "virbr") return true
}
for _, p := range skipIfacePrefix {
if strings.HasPrefix(n, p) {
return true
}
}
return false
} }
func (c *Collector) net(dt float64) []Net { func (c *Collector) net(dt float64) []Net {
@@ -416,10 +507,44 @@ func (c *Collector) net(dt float64) []Net {
return out return out
} }
var wholeDisk = regexp.MustCompile(`^(sd[a-z]+|vd[a-z]+|nvme\d+n\d+|mmcblk\d+)$`) // ---- disks ----
func (c *Collector) disks(dt float64, temps []Temp) []Disk { // Pseudo block devices with nothing physical behind them.
var skipDiskPrefix = []string{"loop", "ram", "zram", "nbd", "sr", "fd", "dm-", "md", "drbd", "zd", "pmem"}
func skipDisk(n string) bool {
for _, p := range skipDiskPrefix {
if strings.HasPrefix(n, p) {
return true
}
}
return false
}
func diskModel(name string) string {
dev := "/sys/block/" + name + "/device/"
for _, f := range []string{"model", "name", "vendor"} { // SCSI/NVMe: model; MMC/SD: name
if s := strings.TrimSpace(readStr(dev + f)); s != "" {
return s
}
}
return ""
}
func (c *Collector) disks(dt float64) []Disk {
out := []Disk{} out := []Disk{}
// /sys/block lists whole devices only (partitions live underneath), so this is
// the authoritative "is a disk" test across sd/nvme/mmcblk/vd/xvd/hd/…
ents, err := os.ReadDir("/sys/block")
if err != nil {
return out
}
whole := map[string]bool{}
for _, e := range ents {
if !skipDisk(e.Name()) {
whole[e.Name()] = true
}
}
f, err := os.Open("/proc/diskstats") f, err := os.Open("/proc/diskstats")
if err != nil { if err != nil {
return out return out
@@ -428,14 +553,20 @@ func (c *Collector) disks(dt float64, temps []Temp) []Disk {
sc := bufio.NewScanner(f) sc := bufio.NewScanner(f)
for sc.Scan() { for sc.Scan() {
fs := strings.Fields(sc.Text()) fs := strings.Fields(sc.Text())
if len(fs) < 14 || !wholeDisk.MatchString(fs[2]) { if len(fs) < 14 || !whole[fs[2]] {
continue continue
} }
name := fs[2] name := fs[2]
rd, _ := strconv.ParseUint(fs[5], 10, 64) rd, _ := strconv.ParseUint(fs[5], 10, 64)
wr, _ := strconv.ParseUint(fs[9], 10, 64) wr, _ := strconv.ParseUint(fs[9], 10, 64)
ticks, _ := strconv.ParseUint(fs[12], 10, 64) ticks, _ := strconv.ParseUint(fs[12], 10, 64)
d := Disk{Name: name, Model: strings.TrimSpace(readStr("/sys/block/" + name + "/device/model"))} d := Disk{Name: name, Model: diskModel(name), Temp: blockTemp(name)}
if sz, ok := readInt("/sys/block/" + name + "/size"); ok {
d.Size = uint64(sz) * sectorSize
}
if d.Size == 0 {
continue // empty card reader / detached media
}
if p, ok := c.prevDisk[name]; ok && dt > 0 { if p, ok := c.prevDisk[name]; ok && dt > 0 {
d.ReadBps = round1(float64(rd-p[0]) * sectorSize / dt) d.ReadBps = round1(float64(rd-p[0]) * sectorSize / dt)
d.WriteBps = round1(float64(wr-p[1]) * sectorSize / dt) d.WriteBps = round1(float64(wr-p[1]) * sectorSize / dt)
@@ -445,22 +576,35 @@ func (c *Collector) disks(dt float64, temps []Temp) []Disk {
} }
} }
c.prevDisk[name] = [3]uint64{rd, wr, ticks} c.prevDisk[name] = [3]uint64{rd, wr, ticks}
// NVMe exposes a "Composite" temp on an hwmon chip named "nvme"; attach it when there is exactly one such disk.
if strings.HasPrefix(name, "nvme") {
for _, t := range temps {
if t.Chip == "nvme" && t.Label == "Composite" {
d.Temp = t.C
}
}
}
out = append(out, d) out = append(out, d)
} }
sort.Slice(out, func(i, j int) bool { return out[i].Name < out[j].Name }) sort.Slice(out, func(i, j int) bool { return out[i].Name < out[j].Name })
return out return out
} }
var realFS = map[string]bool{"ext4": true, "ext3": true, "ext2": true, "xfs": true, "btrfs": true, "zfs": true, // ---- filesystems ----
"f2fs": true, "vfat": true, "exfat": true, "ntfs": true, "ntfs3": true, "cifs": true, "nfs": true, "nfs4": true, "fuse.sshfs": true}
// Kernel/virtual filesystems that aren't storage. Anything else that's mounted is
// shown, so new real filesystems (bcachefs, exotic FUSE) work without a code change.
var pseudoFS = map[string]bool{
"proc": true, "sysfs": true, "devtmpfs": true, "devpts": true, "tmpfs": true, "ramfs": true,
"cgroup": true, "cgroup2": true, "pstore": true, "bpf": true, "securityfs": true, "debugfs": true,
"tracefs": true, "configfs": true, "fusectl": true, "hugetlbfs": true, "mqueue": true, "efivarfs": true,
"binfmt_misc": true, "autofs": true, "rpc_pipefs": true, "nsfs": true, "overlay": true, "squashfs": true,
"fuse.portal": true, "fuse.gvfsd-fuse": true, "fuse.lxcfs": true, "selinuxfs": true, "none": true, "zfs_snap": true,
}
// Mount prefixes that are container/snap/runtime internals, not the host's storage.
var skipMountPrefix = []string{"/var/lib/docker/", "/var/lib/containers/", "/var/lib/kubelet/", "/run/", "/snap/", "/proc/", "/sys/", "/dev/"}
func skipMount(m string) bool {
for _, p := range skipMountPrefix {
if strings.HasPrefix(m, p) {
return true
}
}
return false
}
func filesystems() []FS { func filesystems() []FS {
out := []FS{} out := []FS{}
@@ -471,11 +615,14 @@ func filesystems() []FS {
seen := map[string]bool{} seen := map[string]bool{}
for _, line := range strings.Split(string(b), "\n") { for _, line := range strings.Split(string(b), "\n") {
fs := strings.Fields(line) fs := strings.Fields(line)
if len(fs) < 3 || !realFS[fs[2]] || seen[fs[1]] { if len(fs) < 3 || pseudoFS[fs[2]] {
continue continue
} }
seen[fs[1]] = true
mount := strings.ReplaceAll(fs[1], `\040`, " ") mount := strings.ReplaceAll(fs[1], `\040`, " ")
if seen[mount] || skipMount(mount) {
continue
}
seen[mount] = true
// statfs on a dead network mount can block; bound it. // statfs on a dead network mount can block; bound it.
done := make(chan FS, 1) done := make(chan FS, 1)
go func() { go func() {
@@ -499,16 +646,20 @@ func filesystems() []FS {
return out return out
} }
func ups() *UPS { // ---- UPS ----
func runOut(args ...string) (string, bool) {
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel() defer cancel()
b, err := exec.CommandContext(ctx, "sudo", "-n", "pwrstat", "-status").Output() b, err := exec.CommandContext(ctx, args[0], args[1:]...).Output()
if err != nil { if err != nil {
return nil return "", false
} }
u := &UPS{} return string(b), true
got := false }
num := func(s string) float64 {
// leadingNum parses the number at the start of "119 V", "47 min.", "170 Watt(17 %)".
func leadingNum(s string) float64 {
s = strings.TrimSpace(s) s = strings.TrimSpace(s)
end := 0 end := 0
for end < len(s) && (s[end] >= '0' && s[end] <= '9' || s[end] == '.') { for end < len(s) && (s[end] >= '0' && s[end] <= '9' || s[end] == '.') {
@@ -516,8 +667,20 @@ func ups() *UPS {
} }
v, _ := strconv.ParseFloat(s[:end], 64) v, _ := strconv.ParseFloat(s[:end], 64)
return v return v
}
// upsPwrstat: CyberPower PowerPanel. pwrstat only talks to its daemon as root, so fall
// back to passwordless sudo when plain execution is refused.
func upsPwrstat() *UPS {
out, ok := runOut("pwrstat", "-status")
if !ok {
if out, ok = runOut("sudo", "-n", "pwrstat", "-status"); !ok {
return nil
} }
for _, line := range strings.Split(string(b), "\n") { }
u := &UPS{Driver: "pwrstat"}
got := false
for _, line := range strings.Split(out, "\n") {
k, v, ok := strings.Cut(line, "....") k, v, ok := strings.Cut(line, "....")
if !ok { if !ok {
continue continue
@@ -532,18 +695,19 @@ func ups() *UPS {
u.State = v u.State = v
case "Power Supply by": case "Power Supply by":
u.Source = v u.Source = v
u.OnBattery = !strings.Contains(v, "Utility")
case "Utility Voltage": case "Utility Voltage":
u.InV = num(v) u.InV = leadingNum(v)
case "Output Voltage": case "Output Voltage":
u.OutV = num(v) u.OutV = leadingNum(v)
case "Battery Capacity": case "Battery Capacity":
u.BatteryPct = num(v) u.BatteryPct = leadingNum(v)
case "Remaining Runtime": case "Remaining Runtime":
u.RuntimeMin = num(v) u.RuntimeMin = leadingNum(v)
case "Load": case "Load":
u.LoadW = num(v) u.LoadW = leadingNum(v)
if i := strings.Index(v, "("); i >= 0 { if i := strings.Index(v, "("); i >= 0 {
u.LoadPct = num(v[i+1:]) u.LoadPct = leadingNum(v[i+1:])
} }
case "Last Power Event": case "Last Power Event":
u.LastEvent = v u.LastEvent = v
@@ -555,6 +719,88 @@ func ups() *UPS {
return u return u
} }
// upsNUT: Network UPS Tools. `upsc -l` names the UPSes; `upsc <name>` dumps key: value.
func upsNUT() *UPS {
list, ok := runOut("upsc", "-l")
if !ok {
return nil
}
name := ""
for _, l := range strings.Split(list, "\n") {
if l = strings.TrimSpace(l); l != "" {
name = l
break
}
}
if name == "" {
return nil
}
out, ok := runOut("upsc", name)
if !ok {
return nil
}
kv := map[string]string{}
for _, l := range strings.Split(out, "\n") {
if k, v, ok := strings.Cut(l, ":"); ok {
kv[strings.TrimSpace(k)] = strings.TrimSpace(v)
}
}
if len(kv) == 0 {
return nil
}
u := &UPS{Driver: "nut", Model: strings.TrimSpace(kv["ups.mfr"] + " " + kv["ups.model"])}
status := kv["ups.status"]
u.OnBattery = strings.Contains(status, "OB")
u.State = status
u.Source = "Utility Power"
if u.OnBattery {
u.Source = "Battery"
}
u.InV = leadingNum(kv["input.voltage"])
u.OutV = leadingNum(kv["output.voltage"])
u.BatteryPct = leadingNum(kv["battery.charge"])
u.RuntimeMin = leadingNum(kv["battery.runtime"]) / 60
u.LoadPct = leadingNum(kv["ups.load"])
u.LoadW = leadingNum(kv["ups.realpower"])
if u.LoadW == 0 {
u.LoadW = round1(leadingNum(kv["ups.realpower.nominal"]) * u.LoadPct / 100)
}
return u
}
// upsAPC: apcupsd. `apcaccess` prints "KEY : value" lines.
func upsAPC() *UPS {
out, ok := runOut("apcaccess", "status")
if !ok {
return nil
}
kv := map[string]string{}
for _, l := range strings.Split(out, "\n") {
if k, v, ok := strings.Cut(l, ":"); ok {
kv[strings.TrimSpace(k)] = strings.TrimSpace(v)
}
}
if kv["STATUS"] == "" {
return nil
}
u := &UPS{Driver: "apcupsd", Model: kv["MODEL"], State: kv["STATUS"]}
u.OnBattery = strings.Contains(kv["STATUS"], "ONBATT")
u.Source = "Utility Power"
if u.OnBattery {
u.Source = "Battery"
}
u.InV = leadingNum(kv["LINEV"])
u.OutV = leadingNum(kv["OUTPUTV"])
u.BatteryPct = leadingNum(kv["BCHARGE"])
u.RuntimeMin = leadingNum(kv["TIMELEFT"])
u.LoadPct = leadingNum(kv["LOADPCT"])
u.LoadW = round1(leadingNum(kv["NOMPOWER"]) * u.LoadPct / 100)
if kv["LASTXFER"] != "" {
u.LastEvent = kv["LASTXFER"]
}
return u
}
// ---- small helpers ---- // ---- small helpers ----
func readStr(p string) string { func readStr(p string) string {
@@ -574,6 +820,8 @@ func readInt(p string) (int64, bool) {
return v, err == nil return v, err == nil
} }
func fileExists(p string) bool { _, err := os.Stat(p); return err == nil }
func round1(v float64) float64 { return float64(int64(v*10+0.5)) / 10 } func round1(v float64) float64 { return float64(int64(v*10+0.5)) / 10 }
func lookPath(bin string) bool { _, err := exec.LookPath(bin); return err == nil } func lookPath(bin string) bool { _, err := exec.LookPath(bin); return err == nil }
+20 -7
View File
@@ -1,5 +1,5 @@
import { ReactNode, useEffect, useRef, useState } from 'react' import { ReactNode, useEffect, useRef, useState } from 'react'
import { api, Sample, Series } from './api' import { api, Sample, Series, Temp } from './api'
import Sparkline from './Sparkline' import Sparkline from './Sparkline'
const MAX = 300 const MAX = 300
@@ -53,6 +53,19 @@ function Legend({ items }: { items: { name: string; color: string }[] }) {
return <div className="legend">{items.map((i) => <span key={i.name}><span className="sw" style={{ background: i.color }} />{i.name}</span>)}</div> return <div className="legend">{items.map((i) => <span key={i.name}><span className="sw" style={{ background: i.color }} />{i.name}</span>)}</div>
} }
// Chips with many sensors (per-core temps on a big CPU) collapse to one row showing the hottest.
function collapseTemps(temps: Temp[]): Temp[] {
const byChip = new Map<string, Temp[]>()
for (const t of temps) (byChip.get(t.chip) ?? byChip.set(t.chip, []).get(t.chip)!).push(t)
const out: Temp[] = []
for (const [chip, list] of byChip) {
if (list.length <= 8) { out.push(...list); continue }
const hot = list.reduce((a, b) => (b.c > a.c ? b : a))
out.push({ ...hot, label: `${list.length} sensors · hottest ${hot.label}`, chip })
}
return out
}
export default function Dashboard() { export default function Dashboard() {
const [latest, setLatest] = useState<Sample | null>(null) const [latest, setLatest] = useState<Sample | null>(null)
const [err, setErr] = useState('') const [err, setErr] = useState('')
@@ -107,7 +120,7 @@ export default function Dashboard() {
<div className="dash"> <div className="dash">
{err && <div className="error">{err}</div>} {err && <div className="error">{err}</div>}
<div className="kpis"> <div className="kpis">
<Tile label="CPU" value={pct(s.cpu)} sub={s.cores.length ? `cores ${s.cores.map((c) => Math.round(c)).join(' · ')}` : undefined}> <Tile label="CPU" value={pct(s.cpu)} sub={s.cores.length === 0 ? undefined : s.cores.length <= 16 ? `cores ${s.cores.map((c) => Math.round(c)).join(' · ')}` : `${s.cores.length} cores · busiest ${pct(Math.max(...s.cores))}`}>
{h && <Sparkline series={[{ name: 'cpu', values: h.cpu, color: S1 }]} max={100} format={pct} height={36} />} {h && <Sparkline series={[{ name: 'cpu', values: h.cpu, color: S1 }]} max={100} format={pct} height={36} />}
</Tile> </Tile>
<Tile label="Memory" value={fmtBytes(s.mem.used)} sub={`of ${fmtBytes(s.mem.total)} · ${pct(memFrac * 100)}${s.swap.total ? ` · swap ${fmtBytes(s.swap.used)}` : ''}`}> <Tile label="Memory" value={fmtBytes(s.mem.used)} sub={`of ${fmtBytes(s.mem.total)} · ${pct(memFrac * 100)}${s.swap.total ? ` · swap ${fmtBytes(s.swap.used)}` : ''}`}>
@@ -120,7 +133,7 @@ export default function Dashboard() {
<div className="cards"> <div className="cards">
<Card title="Temperatures"> <Card title="Temperatures">
{s.temps.length === 0 && <div className="empty">No temperature sensors reported by this host.</div>} {s.temps.length === 0 && <div className="empty">No temperature sensors reported by this host.</div>}
{s.temps.map((t) => { {collapseTemps(s.temps).map((t) => {
const limit = t.crit || t.max || 100 const limit = t.crit || t.max || 100
const cls = t.c >= limit - 5 ? 'bad' : t.max && t.c >= t.max - 15 ? 'warn' : '' const cls = t.c >= limit - 5 ? 'bad' : t.max && t.c >= t.max - 15 ? 'warn' : ''
return ( return (
@@ -171,7 +184,7 @@ export default function Dashboard() {
<span>{d.name}</span> <span>{d.name}</span>
<span className="model">{d.model}</span> <span className="model">{d.model}</span>
<span className="spacer" /> <span className="spacer" />
<span className="num">{d.temp ? `${d.temp.toFixed(0)}°C · ` : ''}{pct(d.util_pct)} busy</span> <span className="num">{fmtBytes(d.size)} · {d.temp ? `${d.temp.toFixed(0)}°C · ` : ''}{pct(d.util_pct)} busy</span>
</div> </div>
<div className="sub-head num">read {fmtRate(d.read_bps)}<span className="spacer" />write {fmtRate(d.write_bps)}</div> <div className="sub-head num">read {fmtRate(d.read_bps)}<span className="spacer" />write {fmtRate(d.write_bps)}</div>
{h?.disk[d.name] && ( {h?.disk[d.name] && (
@@ -193,14 +206,14 @@ export default function Dashboard() {
</Card> </Card>
<Card title="UPS"> <Card title="UPS">
{!s.ups && <div className="empty">No UPS data (pwrstat not available on this host).</div>} {!s.ups && <div className="empty">No UPS daemon found (looks for pwrstat, NUT upsc, or apcaccess).</div>}
{s.ups && ( {s.ups && (
<> <>
<div className="sub-head"> <div className="sub-head">
<span className={'dot ' + (s.ups.source === 'Utility Power' ? 'ok' : 'bad')} /> <span className={'dot ' + (s.ups.on_battery ? 'bad' : 'ok')} />
<span>{s.ups.state} · {s.ups.source}</span> <span>{s.ups.state} · {s.ups.source}</span>
<span className="spacer" /> <span className="spacer" />
<span className="model">{s.ups.model}</span> <span className="model">{s.ups.model} · {s.ups.driver}</span>
</div> </div>
<div className="row"><span className="k">Battery</span><Meter frac={s.ups.battery_pct / 100} cls={s.ups.battery_pct < 20 ? 'bad' : s.ups.battery_pct < 50 ? 'warn' : ''} /><span className="num">{pct(s.ups.battery_pct)} · {s.ups.runtime_min} min</span></div> <div className="row"><span className="k">Battery</span><Meter frac={s.ups.battery_pct / 100} cls={s.ups.battery_pct < 20 ? 'bad' : s.ups.battery_pct < 50 ? 'warn' : ''} /><span className="num">{pct(s.ups.battery_pct)} · {s.ups.runtime_min} min</span></div>
<div className="row"><span className="k">Load</span><Meter frac={s.ups.load_pct / 100} /><span className="num">{s.ups.load_w} W · {pct(s.ups.load_pct)}</span></div> <div className="row"><span className="k">Load</span><Meter frac={s.ups.load_pct / 100} /><span className="num">{s.ups.load_w} W · {pct(s.ups.load_pct)}</span></div>
+2 -2
View File
@@ -23,9 +23,9 @@ export interface Term { id: string; name: string; running: boolean; exit_code: n
export interface Temp { chip: string; label: string; c: number; max?: number; crit?: number } export interface Temp { chip: string; label: string; c: number; max?: number; crit?: number }
export interface Fan { chip: string; label: string; rpm: number } export interface Fan { chip: string; label: string; rpm: number }
export interface NetIf { iface: string; up: boolean; rx_bps: number; tx_bps: number; rx_total: number; tx_total: number } export interface NetIf { iface: string; up: boolean; rx_bps: number; tx_bps: number; rx_total: number; tx_total: number }
export interface Disk { name: string; model?: string; read_bps: number; write_bps: number; util_pct: number; temp?: number } export interface Disk { name: string; model?: string; size: number; read_bps: number; write_bps: number; util_pct: number; temp?: number }
export interface FS { mount: string; type: string; size: number; used: number } export interface FS { mount: string; type: string; size: number; used: number }
export interface UPS { model: string; state: string; source: string; in_v: number; out_v: number; battery_pct: number; runtime_min: number; load_w: number; load_pct: number; last_event?: string } export interface UPS { driver: string; model: string; state: string; source: string; on_battery: boolean; in_v: number; out_v: number; battery_pct: number; runtime_min: number; load_w: number; load_pct: number; last_event?: string }
export interface Sample { export interface Sample {
t: number; cpu: number; cores: number[]; load: [number, number, number] t: number; cpu: number; cores: number[]; load: [number, number, number]
mem: { total: number; used: number; avail: number }; swap: { total: number; used: number; avail: number } mem: { total: number; used: number; avail: number }; swap: { total: number; used: number; avail: number }