What it reads
Every few seconds the control plane reads/proc/pressure/cpu and /proc/pressure/memory (PSI, the 10 second averages), MemAvailable and SwapTotal from /proc/meminfo, the CPU count and the load average. These are a few small files, not a process scan.
Where PSI is not available (old kernels, containers, other operating systems) the guard falls back to available memory and load per CPU. Where there is no memory source at all it stays quiet and Doctor shows the row as unknown.
States
The state rises at once and falls only when every signal is below the exit threshold (a percent of the enter threshold) for the hold time, so a brief lull does not release the queue into a storm.
What is held, and what never is
While critical, new builds on this host wait with the statuswaiting: host under memory pressure. When the state returns to ok they resume after a random delay, so they do not all start together. Never held: running builds and apps, the API, the reconcile loop for existing apps, rollbacks, stops, and builds on other nodes (the reading is for this host only). Pulls of prebuilt images are not held yet.
What you see
- Doctor: a
Host pressurerow and aSwaprow. The swap row warns when no swap is configured and RAM is below the threshold. - The attention feed: one item while the host is warm or critical, with the top memory users by container and concrete actions.
- An event,
host.pressure, on every state change, for event webhooks. - Metrics samples
host_pressure_state(0 ok, 1 warn, 2 critical),host_psi_cpu_some_avg10,host_psi_memory_some_avg10,host_psi_memory_full_avg10andhost_load1, readable through the metrics remote read endpoint. levelrail-cli doctorlists both rows.
What to do about it
- Add swap. A 1 to 2 GB swap file turns a sudden memory spike into a slowdown instead of a kill.
- Lower build concurrency in the build limits. With no saved value, the slot count is derived at boot from CPUs and RAM (one per two CPUs and per 4 GiB, at least one).
- Set memory limits on the apps listed as top consumers.
Settings
All thresholds are runtime settings (Settings, then thehost. keys, or the API and CLI). The environment variables only seed the defaults.
This feature is beta: the defaults are conservative and have been exercised with injected readings, not yet on a real overloaded host.