feat: account for VM memory ballooning in host memory reporting (#1750)

mirror of https://github.com/Studio-Saelix/sencho.git synced 2026-08-10 10:49:35 +00:00

* feat: account for VM memory ballooning in host memory reporting

Extend hostMemory.ts with a readBalloonedMemory() function that parses the
Balloon: field from /proc/meminfo, following the same fail-open pattern as
the ZFS ARC integration. When a nonzero balloon is detected, effective
memory fields (effectiveUsed, effectiveFree, effectiveUsagePercent) are
computed and exposed through /api/system/stats and /api/fleet/overview.

All consumers that derive meaning from host memory now prefer effective
values when present: the dashboard gauge, Fleet card RAM bar, mobile
views, health verdict, health status bar stat tile, and host RAM alerts.

Backward compatible: missing /proc/meminfo or absent Balloon: line
preserves exact current behavior. Old remote nodes without the new fields
continue rendering normally.

* refactor: extract shared helpers for balloon memory wiring

Extract readCandidateFile() and logSelectedPath() in hostMemory.ts to
deduplicate ARC and balloon file-read logic. Add memoryToWire() to
centralize the optional-field spread used by /api/system/stats and
/api/fleet/overview. Add getNodeMemUsed()/getNodeMemTotal() helpers
in nodeUtils.ts for frontend byte-text consumers.

* fix: make desktop fleet masthead aggregate balloon-aware

The desktop fleet overview's memory aggregate in useFleetOverview.ts still
summed raw memory.used, while the mobile fleet aggregate and per-node cards
already used effective values. Update to use getNodeMemUsed/getNodeMemTotal
helpers.

* fix: revert balloon adjustment from alerting and health decisions

Ballooned memory is host-reclaimed (unlike ZFS ARC, which the guest can
reclaim on demand). The guest cannot get ballooned pages back until the
hypervisor deflates them, so treating ballooned memory as available for
alerting or health can mask real memory pressure.

Keep balloon parsing, wire fields, and the dashboard context line as
informational-only. The memory gauge, health verdict, and host RAM alerts
now use the standard ARC-adjusted working-set percentage regardless of
balloon. Updated configuration.mdx and dashboard.mdx to document that
balloon data is informational and does not influence alerting.

This commit is contained in:

Anso

2026-08-02 20:48:38 -04:00

committed by

GitHub

parent a74905ff1e

commit c613010199

20 changed files with 540 additions and 99 deletions

									
										.env.example
									
		+5
		
												View File
												
				@@ -157,3 +157,8 @@ GITSOURCE_MAX_CLONE_BYTES=104857600

				# only if your ARC stats live at a non-standard path inside the container. If no

				# ARC stats are readable, host memory reporting is unchanged.

				# SENCHO_ZFS_ARCSTATS_PATH=

				# Path inside the container to /proc/meminfo, for VM memory ballooning awareness.

				# Sencho checks this path first, then /host/proc/meminfo, then /proc/meminfo.

				# Set it only when your meminfo lives at a non-standard path inside the container.

				# SENCHO_PROC_MEMINFO_PATH=